agentsclimarketplace

Io theory building

Skill brycewang-stanford/Awesome-Journal-Skills/International-Organization-Skills/skills/io-theory-building

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

Install
npx -y skills add brycewang-stanford/Awesome-Journal-Skills --skill io-theory-building

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

6.0 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it

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

  1. Concept — define the key IR construct precisely (e.g., institutional legitimacy, audience cost, credible commitment); distinguish it from neighbors.
  2. International mechanism — the causal story at/across the international level: which actors (states, IGOs, firms, transnational groups), what strategic incentives and constraints, why.
  3. 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.
  4. 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)

GradeArgument looks like…Typical referee line
Strongportable mechanism + scope conditions + clear non-implications"a generalizable theory of world politics"
Borderlinea mechanism named but tied to one institution"promising but narrow — does it travel?"
Weaka 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

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.