agentsclimarketplace

Ppsych organizing framework

Skill brycewang-stanford/Awesome-Journal-Skills/Perspectives-on-Psychological-Science-Skills/skills/ppsych-organizing-framework

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).From its SKILL.md

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.

SKILL.md

6.1 KB, ~1.3k tokens by cl100k_base, 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)

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 325,949. 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.