From journal-of-educational-psychology-skills
Structures the theoretical framing and hypothesis section for a Journal of Educational Psychology manuscript, requiring a clear psychological mechanism, directional confirmatory vs. exploratory hypotheses, and preregistration status.
How this skill is triggered — by the user, by Claude, or both
Slash command
/journal-of-educational-psychology-skills:jedpsych-theory-and-hypothesesThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
The Journal of Educational Psychology rewards a **clear psychological mechanism** for an educational
The Journal of Educational Psychology rewards a clear psychological mechanism for an educational phenomenon and honest hypothesis status. Because JEP is a research journal in educational psychology, the theory must explain learning, motivation, engagement, or achievement — not merely report that an intervention worked. The cardinal rule mirrors the credibility era: state theory and confirmatory hypotheses before the data, and label exploratory results as exploratory.
jedpsych-study-design).A reading-comprehension strategy-instruction field trial, written so hypothesis status is legible.
Theory: Explicit strategy instruction builds metacognitive monitoring,
which lets readers allocate effort to comprehension breakdowns,
improving inference on novel texts.
H1 (confirmatory, preregistered):
Strategy-instruction classrooms outperform business-as-usual on a
transfer comprehension task (directional; classroom-level effect).
H2 (confirmatory, preregistered): The effect is mediated by gains in a
metacognitive-monitoring measure (mechanism test).
H3 (exploratory): Larger gains for initially low-comprehension students
(aptitude-treatment interaction; flagged for future confirmation).
Disconfirming: a near-zero classroom-level effect, or no monitoring gain,
counts against the metacognitive account — stated up front.
Name the boundary of the claim rather than implying universal scope across grades, subjects, and contexts. Confirm current wording against the journal's submission guidelines, but include the substance:
Constraints on generality: We expect H1 to hold for upper-elementary
readers in general-education classrooms with the studied text genre. We do
not claim it generalizes to early decoding, to multilingual learners
without adaptation, or to fully online instruction without further test.
| Reviewer pushback | JEP fix |
|---|---|
| "Atheoretical — reads as program evaluation" | state the learning/motivation mechanism and a mediation test, not just outcome means |
| "This looks HARKed" | show the preregistration / analysis plan timestamp; relabel post hoc analyses exploratory |
| "Mechanism untested" | add the mediator measure and a preregistered mediation hypothesis |
| "Claims outrun the sample" | scope hypotheses to the grades/subjects/settings studied; add a constraints clause |
| "Non-directional hypothesis" | commit to a sign and an educationally meaningful magnitude |
【Mechanism】the learning/motivation process, briefly
【Hypotheses】directional, testable (H1, H2, …), with a mediation/mechanism test
【Status】which are confirmatory (preregistered?) vs exploratory
【Disconfirming evidence】what would count against the mechanism
【Level】individual vs classroom/school — matched to the claim
【Next】jedpsych-literature-positioning
../../resources/external_tools.md — preregistration templates and analysis-plan tools../../resources/official-source-map.md — preregistration and JARS reporting standardsnpx claudepluginhub brycewang-stanford/awesome-journal-skills --plugin journal-of-educational-psychology-skillsGuides writing the theory and hypotheses section for Psychological Science manuscripts, ensuring clear separation of confirmatory (preregistered) vs exploratory analyses and preventing HARKing.
Guides building theoretical models and directional hypotheses for Journal of Applied Psychology manuscripts. Emphasizes mechanism, level specifications, and confirmatory vs. exploratory splits.
Builds theoretical arguments and derives testable hypotheses for JPSP manuscripts. Structures the theory section and maps hypotheses to studies, helping clear the innovation gate.