io-theory-building — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited io-theory-building (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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.
credible commitment); distinguish it from neighbors.
(states, IGOs, firms, transnational groups), what strategic incentives and constraints, why.
we should not see). These become the tests in io-research-design.
Portability ≠ universality.
signaling) before the setup.
international politics.
(complete, in an appendix), not gestured at.
politics — and connect them to behavior.
improves on and state what each would and would not expect to observe.
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).
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.
| 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.
【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../../resources/external_tools.md — formal-modeling and analysis tooling../../resources/official-source-map.md — IO generalizable-theory scope; formal-proof verification~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.