io-theory-building
GitHub协助将实证发现转化为可推广的国际关系理论，明确国际机制、假设与适用范围。适用于经验研究、形式建模及建构主义论文，确保论证具备跨案例的可移植性，回应审稿人关于理论薄弱的质疑。
Trigger Scenarios
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill io-theory-building -g -y
SKILL.md
Frontmatter
{
"name": "io-theory-building",
"description": "Use when building the theoretical argument of an International Organization (IO) manuscript into a generalizable theory of international politics — whether rationalist\/formal (bargaining, signaling, delegation, cooperation), constructivist\/ideational, or empirical with explicit international mechanisms. IO rewards a portable IR theory over a bare finding. Structures the argument; it does not run analyses."
}
Theory & Argument Building (io-theory-building)
IO publishes "articles that propose generalizable theories" of international politics. A result is not an IO contribution until it is attached to an IR theory the field can carry to other cases, dyads, and institutions. This skill turns findings into theory: explicit mechanisms operating at or across the international level, scope conditions, and observable implications.
When to trigger
- The empirics are strong but the "so what for IR theory" is thin
- A reviewer said the paper is "atheoretical," "ad hoc," or "just a finding"
- You need to state the international mechanism, assumptions, and scope conditions explicitly
- Formal modeling: deciding what to model about strategic interaction among states/actors
Build the argument (by mode of work)
Empirical paper with an IR theory
- Concept — define the key IR construct precisely (e.g., institutional legitimacy, audience cost, credible commitment); distinguish it from neighbors.
- International mechanism — the causal story at/across the international level: which actors (states, IGOs, firms, transnational groups), what strategic incentives and constraints, why.
- Observable implications — what we should see if the mechanism operates internationally (and what
we should not see). These become the tests in
io-research-design. - Scope conditions — which regimes, issue areas, or structural conditions the argument holds under. Portability ≠ universality.
Formal / game-theoretic paper (a core IO mode)
- State the substantive IR puzzle (bargaining failure, cooperation under anarchy, delegation, signaling) before the setup.
- Keep assumptions transparent and motivated; flag which equilibria are robust to which assumptions.
- Translate equilibrium predictions into comparative statics a reader can test or recognize in international politics.
- Note: IO verifies proofs of formal models before final acceptance — write proofs to be checked (complete, in an appendix), not gestured at.
Constructivist / ideational / interpretive paper
- Make the conceptual stakes explicit — norms, identities, legitimacy, social meaning in world politics — and connect them to behavior.
- Build the argument through reasons, discourse, and evidence; engage the rationalist baseline it improves on and state what each would and would not expect to observe.
The "portability" test (IO-specific)
Ask: Could an IR scholar import this mechanism to a different issue area, dyad, or institution? If
yes, you have a generalizable IR theory. If it only works for your one case/IGO, generalize the logic
or reframe (back to io-topic-selection).
Worked theory vignette (illustrative): finding to portable theory
Start with a bare finding: states joining an international monitoring institution show higher later compliance. As stated it is not yet an IO contribution — it could be selection and names no general mechanism. To build it into a theory: define the construct (credible commitment via delegated monitoring); state the cross-border mechanism — monitoring makes violations common knowledge across the membership, so states anticipating future cooperation gains internalize the reputational cost, a logic running through the institution, not any domestic process; derive observable implications (gains concentrate where monitoring is informative, absent where conduct is unobservable); bound it with scope conditions (verifiable conduct, repeated interaction); and check portability — the logic travels to arms control, trade dispute settlement, or environmental regimes, clearing IO's broad-significance bar.
Theory-strength rubric (how an IO referee grades the argument)
| Grade | Argument looks like… | Typical referee line |
|---|---|---|
| Strong | portable mechanism + scope conditions + clear non-implications | "a generalizable theory of world politics" |
| Borderline | a mechanism named but tied to one institution | "promising but narrow — does it travel?" |
| Weak | a finding with hypotheses attached post hoc | "atheoretical / ad hoc" |
IO's theory premium means a Borderline argument with flawless empirics still often draws an R&R aimed at the theory, not the data.
Anti-patterns
- A domestic-politics mechanism relabeled as IR — the action must be international or cross-border
- "Hypothesizing after results are known" (HARKing); preregister where possible
- A formal model with opaque assumptions tuned to the desired equilibrium, or proofs left incomplete
- Mechanisms named but never made observable at the international level
- Universal claims with no scope conditions; a finding with no theory the field can reuse
- A mechanism that travels nowhere beyond the studied institution (fails the broad-significance bar)
Output format
【Core IR claim】one sentence
【International mechanism】the causal/strategic story (who, why, under what constraints)
【Assumptions】(formal) the load-bearing ones; proof appendix planned?
【Observable implications】testable consequences → research-design
【Scope conditions】issue areas / regimes where it holds / fails
【Portability】who else in IR can use this theory
【Next】io-research-design
Supplementary resources
../../resources/external_tools.md— formal-modeling and analysis tooling../../resources/official-source-map.md— IO generalizable-theory scope; formal-proof verification
Version History
- 1839142 Current 2026-07-05 13:23
