Theory & Argument Building (apsr-theory-building)
At APSR a result is not a contribution until it is attached to an argument the discipline can use
elsewhere. This skill turns findings into theory: explicit mechanisms, scope conditions, and
observable implications, in the idiom appropriate to your kind of work.
When to trigger
- The empirics are strong but the "so what / why" is thin
- A reviewer said the paper is "atheoretical," "ad hoc," or "just a finding"
- You need to state mechanisms, assumptions, and scope conditions explicitly
- Formal modeling: deciding what to model, what to assume, and what the model buys you
Build the argument (by mode of work)
Empirical paper with a theory
- Concept — define the key constructs precisely; distinguish from neighbors.
- Mechanism — the causal story: who does what, why, under what incentives/constraints.
- Observable implications — what we should see if the mechanism operates (and what we should
not see). These become the tests in
apsr-research-design.
- Scope conditions — where the argument holds and where it does not. Portability ≠ universality.
Formal / game-theoretic paper
- State the substantive puzzle the model addresses before the setup.
- Keep assumptions transparent and motivated; flag which results are robust to which assumptions.
- Translate equilibrium predictions into comparative statics a reader can test or recognize.
- Say what the model buys: a non-obvious prediction, a resolution of a puzzle, a unifying logic.
Interpretive / normative paper
- Make the conceptual or normative stakes explicit and connect them to political life.
- Build the argument through reasons and texts, not hypotheses; engage the strongest counter-view.
- Show what the argument lets the field see or justify that it could not before.
The "portability" test (APSR-specific)
Ask: Could a scholar in another subfield import this mechanism/concept to their own problem? If yes,
you have a discipline-level contribution. If the argument only works for your exact case, tighten it
into a general logic or reframe (back to apsr-topic-selection).
The contribution paragraph, anatomized
APSR papers earn the flagship slot with one of a few recognizable contribution shapes. Decide which
yours is and say so in the paragraph that closes the introduction:
- A new concept — a distinction the field lacked, defined against its nearest neighbors, with
criteria for recognizing instances. The test: can two coders apply it to new cases and agree?
- A new mechanism — a causal pathway that existing accounts skip, with the actors, incentives,
and observable traces spelled out.
- A unification — two literatures that talk past each other shown to be special cases of one
logic. Name both literatures and state what the shared logic predicts that neither did alone.
- A revision — received wisdom shown wrong or bounded. State the received claim fairly, the
condition under which it fails, and what replaces it there.
Before → after: from finding to argument
- Before: "We find that decentralization reduces clientelism in our sample."
After: "Decentralization reduces clientelism only where local media can price broker services —
a scope condition that explains why prior studies split, and that any theory tying institutional
reform to accountability must now carry."
Decoding the "atheoretical" referee report
When an APSR reviewer writes "atheoretical," "ad hoc," or "under-theorized," it usually means one of
three repairable gaps — diagnose before rewriting everything:
- Mechanism gap — the paper shows that, never why. Repair: add the actor-level story and one
test that would fail if the story were wrong.
- Stakes gap — the theory exists but stays inside the case. Repair: run the portability test
above and rewrite the contribution paragraph around who else can use the logic.
- Derivation gap — hypotheses appear from nowhere. Repair: show each hypothesis falling out of
the mechanism, and flag any that are exploratory rather than derived (preregistration makes this
distinction legible — see
apsr-transparency-and-data-policy).
Anti-patterns
- "Hypothesizing after results are known" (HARKing) — state theory before tests; preregister where possible
- A model with opaque assumptions chosen to produce the desired result
- Mechanisms named but never made observable
- Universal claims with no scope conditions
- Burying the argument under the empirics — the contribution paragraph must state it plainly
Output format
【Core claim】one sentence
【Mechanism】the causal/logical story
【Assumptions】(formal) the load-bearing ones
【Observable implications】testable consequences → research-design
【Scope conditions】where it holds / fails
【Portability】who else can use this argument
【Next】apsr-research-design
Supplementary resources
Source: brycewang-stanford/Awesome-Journal-Skills → American-Political-Science-Review-Skills/skills/apsr-theory-building/SKILL.md
1---2name: apsr-theory-building3description: Use when building the theoretical argument of an American Political Science Review (APSR) manuscript into a discipline-level contribution — whether the work is formal/game-theoretic, empirical with explicit mechanisms, interpretive, or normative. APSR rewards a clear, portable argument over a bare finding. Structures the argument; it does not run analyses.4---567# Theory & Argument Building (apsr-theory-building)89At APSR a result is not a contribution until it is attached to an **argument the discipline can use10elsewhere.** This skill turns findings into theory: explicit mechanisms, scope conditions, and11observable implications, in the idiom appropriate to your kind of work.1213## When to trigger1415- The empirics are strong but the "so what / why" is thin16- A reviewer said the paper is "atheoretical," "ad hoc," or "just a finding"17- You need to state mechanisms, assumptions, and scope conditions explicitly18- Formal modeling: deciding what to model, what to assume, and what the model buys you1920## Build the argument (by mode of work)2122### Empirical paper with a theory231. **Concept** — define the key constructs precisely; distinguish from neighbors.242. **Mechanism** — the causal story: who does what, why, under what incentives/constraints.253. **Observable implications** — what we should see if the mechanism operates (and what we should26 *not* see). These become the tests in `apsr-research-design`.274. **Scope conditions** — where the argument holds and where it does not. Portability ≠ universality.2829### Formal / game-theoretic paper30- State the **substantive puzzle** the model addresses before the setup.31- Keep assumptions **transparent and motivated**; flag which results are robust to which assumptions.32- Translate equilibrium predictions into **comparative statics** a reader can test or recognize.33- Say what the model **buys**: a non-obvious prediction, a resolution of a puzzle, a unifying logic.3435### Interpretive / normative paper36- Make the **conceptual or normative stakes** explicit and connect them to political life.37- Build the argument through **reasons and texts**, not hypotheses; engage the strongest counter-view.38- Show what the argument lets the field **see or justify** that it could not before.3940## The "portability" test (APSR-specific)4142Ask: *Could a scholar in another subfield import this mechanism/concept to their own problem?* If yes,43you have a discipline-level contribution. If the argument only works for your exact case, tighten it44into a general logic or reframe (back to `apsr-topic-selection`).4546## The contribution paragraph, anatomized4748APSR papers earn the flagship slot with one of a few recognizable contribution shapes. Decide which49yours is and say so in the paragraph that closes the introduction:50511. **A new concept** — a distinction the field lacked, defined against its nearest neighbors, with52 criteria for recognizing instances. The test: can two coders apply it to new cases and agree?532. **A new mechanism** — a causal pathway that existing accounts skip, with the actors, incentives,54 and observable traces spelled out.553. **A unification** — two literatures that talk past each other shown to be special cases of one56 logic. Name both literatures and state what the shared logic predicts that neither did alone.574. **A revision** — received wisdom shown wrong or bounded. State the received claim fairly, the58 condition under which it fails, and what replaces it there.5960### Before → after: from finding to argument6162- *Before:* "We find that decentralization reduces clientelism in our sample."63 *After:* "Decentralization reduces clientelism only where local media can price broker services —64 a scope condition that explains why prior studies split, and that any theory tying institutional65 reform to accountability must now carry."6667## Decoding the "atheoretical" referee report6869When an APSR reviewer writes "atheoretical," "ad hoc," or "under-theorized," it usually means one of70three repairable gaps — diagnose before rewriting everything:7172- **Mechanism gap** — the paper shows *that*, never *why*. Repair: add the actor-level story and one73 test that would fail if the story were wrong.74- **Stakes gap** — the theory exists but stays inside the case. Repair: run the portability test75 above and rewrite the contribution paragraph around who else can use the logic.76- **Derivation gap** — hypotheses appear from nowhere. Repair: show each hypothesis falling out of77 the mechanism, and flag any that are exploratory rather than derived (preregistration makes this78 distinction legible — see `apsr-transparency-and-data-policy`).7980## Anti-patterns8182- "Hypothesizing after results are known" (HARKing) — state theory before tests; preregister where possible83- A model with opaque assumptions chosen to produce the desired result84- Mechanisms named but never made observable85- Universal claims with no scope conditions86- Burying the argument under the empirics — the contribution paragraph must state it plainly8788## Output format8990```91【Core claim】one sentence92【Mechanism】the causal/logical story93【Assumptions】(formal) the load-bearing ones94【Observable implications】testable consequences → research-design95【Scope conditions】where it holds / fails96【Portability】who else can use this argument97【Next】apsr-research-design98```99100## Supplementary resources101102- [`../../resources/external_tools.md`](../../resources/external_tools.md) — formal-modeling and analysis tooling103- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — APSR scope and contribution expectations104105---106107**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `American-Political-Science-Review-Skills/skills/apsr-theory-building/SKILL.md`