Agent skill

Io Theory Building

by franklee16 in franklee16/academic-research-skills

A skill your agent uses when building the theoretical argument of an International Organization (IO) manuscript into a generalizable theory of international politics — whether rationalist/formal…

No licenceAuto-check passed

Install Io Theory Building

skills CLI
$ npx skills add franklee16/academic-research-skills --skill io-theory-building -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install franklee16/academic-research-skills io-theory-building --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/franklee16/academic-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Awesome-Journal-Skills-main/International-Organization-Skills/skills/io-theory-building .claude/skills/io-theory-building && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
io-theory-building
GitHub stars
223
Used in
1 other repo
Token cost
~1.1k tokens
SKILL.md length
448 words
Files
1
Skills in repo
1,617
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when building the theoretical argument of an International Organization (IO) manuscript into a generalizable theory of international politics — whether rationalist/formal…

  • Works in 4 steps: Concept — define the key IR construct… → International mechanism — the causal… → Observable implications — what we should… → …
  • Constructivist/ideational
  • SKILL.md covers When to trigger, Build the argument (by mode of…, The "portability" test… and Anti-patterns, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Io Theory Building is an agent skill from franklee16/academic-research-skills. 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.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Comprehensive collection of Claude Code skills for academic research in economics, finance, and social sciences.

When your agent uses it

  • Constructivist/ideational
  • Empirical with explicit international mechanisms

Example prompts

  • “/io-theory-building”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Concept — define the key IR construct precisely (e.g., institutional legitimacy, audience cost,
  2. International mechanism — the causal story at/across the international level: which actors
  3. Observable implications — what we should see if the mechanism operates internationally (and what
  4. Scope conditions — which regimes, issue areas, or structural conditions the argument holds under.

What it can do on your machine

Read from SKILL.md and the folder at commit 9a4b2db. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Io Theory Building loads about 1.1k tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 448 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 448 words (~1,091 tokens).

“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…”

— opening of SKILL.md by franklee16
name
io-theory-building

Read the full SKILL.md on GitHub

Files

Just SKILL.md in Awesome-Journal-Skills-main/International-Organization-Skills/skills/io-theory-building of franklee16/academic-research-skills.

Open the folder on GitHubat commit 9a4b2db

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in franklee16/academic-research-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Io Theory Building next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Io Theory Building compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Io Theory Building this skillfranklee16/academic-research-skills2231 repos~1.1kAutomated safety check: PassNone
Internal Commsalirezarezvani/claude-skills28k—~3.4kAutomated safety check: PassMIT
Internal Communicationsickn33/agentic-awesome-skills47k1 repos~3.4kAutomated safety check: PassMIT
Internal Communications Writeranthropics/skills180k38 repos~378Automated safety check: PassApache-2.0
Internal Comms Anthropicsickn33/agentic-awesome-skills47k1 repos~702Automated safety check: PassApache-2.0
Nofollow Internalthedaviddias/Front-End-Checklist74k—~579Automated safety check: PassMIT

Similar skills

  • Internal Comms

    alirezarezvani/claude-skills

    A skill your agent uses when a Head of People Ops, BizOps lead, or Internal Communications owner needs to draft and sequence an internal-only change-management communication — a re-org announcement…

    28k GitHub stars~3.4k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Internal Communication

    sickn33/agentic-awesome-skills

    Internal communication log: title, type, date, department, host and attendees, agenda, action items, follow-up date, meeting link and delivery status.

    47k GitHub starsUsed in 1 repo~3.4k tokens
    Writing & ContentAuto-check passed
  • Official

    A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill…

    180k GitHub starsUsed in 38 repos~378 tokens
    Writing & ContentAuto-check passed
  • Internal Comms Anthropic

    sickn33/agentic-awesome-skills

    Compatibility alias for internal-comms: draft status updates, newsletters and FAQs from approved sources.

    47k GitHub starsUsed in 1 repo~702 tokens
    Writing & ContentAuto-check passed
  • Nofollow Internal

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing internal link structure or reviewing link attributes.

    74k GitHub stars~579 tokensUpdated 4 days ago
    Auto-check passed
  • Internal Links

    thedaviddias/Front-End-Checklist

    A skill your agent uses when auditing a site's internal link structure, identifying pages that need more incoming links, generating contextual linking opportunities between related content, or…

    74k GitHub stars~770 tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed

More from franklee16/academic-research-skills

All 1,617 skills in this repo
  • Econometric Research Writing

    franklee16/academic-research-skills

    End-to-end econometric analysis and economics/management paper-writing workflow.

    223 GitHub stars~2.4k tokensUpdated 23 days ago
    Auto-check passed
  • Paper Revision

    franklee16/academic-research-skills

    Comprehensive workflow for handling journal Revise and Resubmit (R&R) decisions.

    223 GitHub stars~3.4k tokensUpdated 23 days ago
    Auto-check passed
  • Sci Ssci Polishing

    franklee16/academic-research-skills

    A skill your agent uses when researchers need Chinese academic prose translated into publication-oriented English or English manuscript paragraphs and complete sections polished for SCI, SSCI, or…

    223 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Research Defense Radar

    franklee16/academic-research-skills

    Assess and monitor an ongoing research project's competitor landscape, novelty risk, and method/data opportunities from a proposal, paper, research question, data or method notes, or a suspected…

    223 GitHub stars~4k tokensUpdated 23 days ago
    Auto-check passed
  • Academic Grant

    franklee16/academic-research-skills

    Generate or fill in academic grant application forms (project statement, education plan, pathway to impact, references) using draft research material.

    223 GitHub stars~2.8k tokensUpdated 23 days ago
    Auto-check: notes
  • Chinese Reference Formatter Skill

    franklee16/academic-research-skills

    A skill your agent uses when a user needs通用中文参考文献、GB/T 7714-style bibliography entries, Chinese academic reference formatting, or BibTeX completion from Chinese or English literature titles…

    223 GitHub stars~1.1k tokensUpdated 23 days ago
    Auto-check passed

Questions about Io Theory Building

What does Io Theory Building do?

A skill your agent uses when building the theoretical argument of an International Organization (IO) manuscript into a generalizable theory of international politics — whether rationalist/formal…. Io Theory Building is an agent skill from franklee16/academic-research-skills. 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.

When should I use Io Theory Building?

Io Theory Building fits situations like: constructivist/ideational; empirical with explicit international mechanisms.

How do I install Io Theory Building in Claude Code?

Run `npx skills add franklee16/academic-research-skills --skill io-theory-building -a claude-code`. Or copy the skill folder (Awesome-Journal-Skills-main/International-Organization-Skills/skills/io-theory-building in franklee16/academic-research-skills) into .claude/skills/io-theory-building in your project. Claude Code loads it when a task matches its description.

How do I install Io Theory Building in Codex?

Run `npx skills add franklee16/academic-research-skills --skill io-theory-building -a codex`. Or copy the skill folder (Awesome-Journal-Skills-main/International-Organization-Skills/skills/io-theory-building in franklee16/academic-research-skills) into .agents/skills/io-theory-building in your project. Codex loads it when a task matches its description.

Can I use Io Theory Building in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add franklee16/academic-research-skills --skill io-theory-building -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/io-theory-building, .gemini/skills/io-theory-building, .github/skills/io-theory-building and .opencode/skills/io-theory-building in your project.

What does Io Theory Building need to run?

SKILL.md names no scripts, command-line tools or credentials: Io Theory Building is instructions for the agent only.

Does Io Theory Building access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Io Theory Building safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Io Theory Building use?

No licence was found for Io Theory Building or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Io Theory Building use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Io Theory Building?

Skills that share tags, products or a category with Io Theory Building: Internal Comms (alirezarezvani/claude-skills, 28k stars), Internal Communication (sickn33/agentic-awesome-skills, 47k stars), Internal Communications Writer (anthropics/skills, 180k stars) and Internal Comms Anthropic (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Io Theory Building?

franklee16 (a GitHub user) maintains it in franklee16/academic-research-skills, which has 223 GitHub stars. The repository holds 1,617 skills in this directory. The repository was last updated on September 18, 2026.

Source: franklee16/academic-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.