Ppsych organizing framework
Journal-specific Claude Code/Codex skill packs covering mainstream journals — AER, QJE, Nature, Cell, 管理世界, 经济研究 & 200+ more — your fast track to getting published. | 覆盖主流期刊的 Claude Code/Codex 期刊技能包,从选题、识别策略到表格规范与审稿回复全流程,助你快速发论文。
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill ppsych-organizing-frameworkAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its author says it does
Copied from the file, not written here
Use when imposing an analytical or conceptual structure on a body of psychology research for a Perspectives on Psychological Science (PoPS) integrative review or theoretical statement — the unifying argument or "spine" that turns a reading list into a claim about the field. Designs the framework; it does not gather the literature (ppsych-literature-synthesis) or audit balance (ppsych-comprehensiveness-and-balance).
SKILL.md
6.1 KB, as published. Nobody here has run it
Organizing Framework — the Argument's Spine (ppsych-organizing-framework)
When to trigger
- The evidence matrix is built but the draft would read like a list of papers
- Sections are named after topics ("Behavioral studies", "Neuro work") rather than ideas
- A reader could not predict what comes next or why papers are grouped as they are
- You cannot state in one sentence the argument or unifying claim the piece makes about the field
Why the spine is the whole game at PoPS
The most-cited reason integrative reviews fail is that they are annotated bibliographies — paper-after-paper summaries with no organizing idea. A great PoPS piece imposes a structure the field did not have: a taxonomy, a unifying theory, a sequence of questions, or a reframing that makes scattered cross-area work legible and provocative. The framework is the contribution; the citations are the evidence. PoPS's breadth mandate raises the bar: the spine must be graspable by a psychologist from a different area on one read, and it should reframe, not merely organize. Choose it deliberately:
| Spine type | Organizes the field by | Best when |
|---|---|---|
| Taxonomy | mutually-exclusive categories of mechanism/phenomenon | the field is fragmented into incommensurable camps |
| Unifying theory/model | a framework whose constructs index the studies | results disagree because they tap different parts of one structure |
| Question sequence | a logical chain of sub-questions | the field has a natural "first establish X, then Y" order |
| Paradigm/historical | how thinking evolved and why | the evolution of ideas is itself the lesson |
| Reframe / inversion | overturning a default assumption the field holds | the contribution is a provocation ("the field has it backwards") |
| Meta-science map | practices vs. outcomes (e.g., power × replicability) | the piece is about how the field works, not what it finds |
Pick one primary spine; a second axis can order papers within a section, but a piece with two competing spines reads as two papers.
The test of a good framework
- Exhaustive + exclusive (MECE-ish): every important paper has exactly one natural home, and categories do not bleed.
- Generative: the framework predicts gaps — empty cells are open questions, not omissions (PoPS prizes the forward agenda).
- Reconciling: apparent contradictions become explained (studies disagree because they sit in different cells / tap different constructs).
- Portable + provocative: a psychologist from another area can restate the spine after one read and feels the reframing is worth arguing about.
Stress-test by placing 5 hard cases (papers that resist categorization). If three have no home, the spine is wrong — redesign before drafting.
The spine is also what lets a PoPS piece be selective without being incomplete: once each cell is defined, confirmatory studies can be cited in clusters within their cell while the prose carries only the cell-defining work and the argument. This is how you honor cross-area coverage while staying concise. Design the spine before deciding what to foreground.
For theoretical statements specifically
When the contribution is the theory (not a review of one), the framework section is the paper. Make the constructs and their relations explicit; state the assumptions; derive what the theory predicts that rival accounts do not; and specify what evidence would falsify it. A theoretical statement that cannot be wrong is not a contribution — name the discriminating tests.
Checklist
- One primary spine chosen (taxonomy / theory / question-sequence / paradigm / reframe / meta-science map)
- The piece's one-sentence argument about the field is written
- Every category traces to evidence-matrix rows (no empty rhetorical buckets)
- The framework reconciles at least one apparent contradiction across areas
- Empty cells surfaced as open questions (generativity — the future agenda)
- 5 hard-case papers each have a natural home
- Section headings name ideas/mechanisms, not "theory vs. empirical"
- A psychologist from another area could restate the spine and slot a new paper into it
- (Theoretical statement) assumptions, novel predictions, and falsifying evidence are explicit
Anti-patterns
- The annotated bibliography: paper-by-paper summaries with no organizing idea (the cardinal review sin)
- Sections named "Theory", "Evidence", "Other" — categories with no analytical content
- A taxonomy whose categories overlap so every paper is cited three times in three places
- Two competing spines fighting for control of the same piece
- A framework so bespoke only the author can apply it (fails PoPS's cross-area test)
- Hiding the contribution: never stating, in one sentence, what the piece argues about the field
- A theoretical statement that makes no falsifiable, discriminating prediction
Output format
【Spine type】taxonomy / unifying-theory / question-sequence / paradigm / reframe / meta-science-map
【Argument about the field】"<one sentence the piece makes>"
【Categories】<the cells / sub-questions, each MECE>
【Reconciliation】<which cross-area contradiction the framework explains>
【Open questions】<empty cells surfaced as the future agenda>
【Hard-case test】5 awkward papers each placed? Y/N
【Portability + provocation】another-area psychologist can restate it; worth arguing about? Y/N
【Theory (if applicable)】assumptions + novel predictions + falsifiers explicit? Y/N · N/A
【Next step】→ ppsych-comprehensiveness-and-balance (fill cells fairly; audit coverage + balance)