agentsclimarketplace

Ppsych organizing framework

Skill brycewang-stanford/Awesome-Journal-Skills/Perspectives-on-Psychological-Science-Skills/skills/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 期刊技能包,从选题、识别策略到表格规范与审稿回复全流程,助你快速发论文。

Install
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill ppsych-organizing-framework

Assembled 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 typeOrganizes the field byBest when
Taxonomymutually-exclusive categories of mechanism/phenomenonthe field is fragmented into incommensurable camps
Unifying theory/modela framework whose constructs index the studiesresults disagree because they tap different parts of one structure
Question sequencea logical chain of sub-questionsthe field has a natural "first establish X, then Y" order
Paradigm/historicalhow thinking evolved and whythe evolution of ideas is itself the lesson
Reframe / inversionoverturning a default assumption the field holdsthe contribution is a provocation ("the field has it backwards")
Meta-science mappractices 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)

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.