Outline-Driven Development

Formerly the ODIN Claude Plugin. The repository URL is unchanged.

Outline-Driven Development, nicknamed ODIN, is a highly opinionated code-agent skill library: principles-first engineering, surgical editing, and workflow automation, published as installable plugins. It gives you a drop-in skill set with five discipline layers. Skills are authored once in-tree, and every supported client discovers them from that same layout, so nothing is copied or republished.

Methodology: outline-driven-development · Site: outlinedriven.github.io

• 657 skills in 28 plugins, each authored once at plugins//skills/<slug>/SKILL.md
• Five harness surfaces from one tree: Claude Code, Codex, Cursor, Grok, and Kimi
• No package manager for the tooling; every script is dependency-free Node ESM or standard-library Python
• Six output styles in odin-core, each embedding the canonical doctrine byte-identically
• Pre-commit gates that audit the whole tree on every commit, listed in .pre-commit-config.yaml

Contents

• What is this
• Install
• Choose your plugins
• Using the skills
• Plugins
• Core philosophy
• Output styles
• Development
• License

What is this

657 skills in 28 plugins. A skill is authored once, at plugins//skills/<slug>/SKILL.md, and that path is its only home. The directory states which plugin owns the skill, so no registry has to answer that question. Every plugin and marketplace ships at one releaseVersion, currently 2.1.5, held in catalog/plugins.json.

Each harness resolves components from fixed conventions at the plugin root, so this layout is the one every supported client already discovers. Nothing is copied at publish time, and nothing is published to a package registry.

plugins/odin-core/
  .claude-plugin/plugin.json   Claude Code manifest
  .codex-plugin/plugin.json    Codex manifest
  .cursor-plugin/plugin.json   Cursor manifest
  .grok-plugin/plugin.json     Grok manifest
  .kimi-plugin/plugin.json     Kimi manifest
  skills/necessary-work/SKILL.md        authored skill
  skills/necessary-work/agents/openai.yaml   generated from the frontmatter
  mcp.json                     MCP servers, odin-core only
  output-styles/               Claude output styles, odin-core only

odin-core carries the six output styles and the planning skills; odin-code carries the day-to-day engineering skills. Install the rest by working domain.

Core philosophy

1. Investigate before acting. Never speculate about code you have not read.
2. Draw the structure before building it.
3. Match rigor to risk.
4. One logical change per commit.
5. Show the code, not a description of the code.

Install

Six install surfaces are supported; each installs from this repository.

Claude Code

claude plugin marketplace add OutlineDriven/odin-claude-plugin
claude plugin install odin-core@odin-marketplace

# Your selected plugin modules; Keep it lean, only for you.
claude plugin install odin-code@odin-marketplace
claude plugin install odin-run@odin-marketplace
claude plugin install odin-planning@odin-marketplace
claude plugin install odin-knowledge@odin-marketplace

# More ...

Codex

codex plugin marketplace add OutlineDriven/odin-claude-plugin
codex plugin add odin-core@odin-marketplace

# Your selected plugin modules; Keep it lean, only for you.
codex plugin add odin-code@odin-marketplace
codex plugin add odin-run@odin-marketplace
codex plugin add odin-planning@odin-marketplace
codex plugin add odin-knowledge@odin-marketplace

# More ...

Cursor

Add the marketplace, then /plugin install odin-core. Cursor reads the .cursor-plugin/plugin.json manifest at each plugin root.

/plugin install odin-core

# Your selected plugin modules; Keep it lean, only for you.
/plugin install odin-code
/plugin install odin-run
/plugin install odin-planning
/plugin install odin-knowledge

# More ...

Individual (gh skill)

gh skill installs a single skill for any of its supported agents. Passing the exact path skips a full tree traversal, which matters at this repository's size.

gh skill install OutlineDriven/odin-claude-plugin plugins/odin-planning/skills/askme \
  --agent  --scope user

`` is claude-code, codex, cursor, grok, or kimi-cli.

Grok

grok plugin marketplace add OutlineDriven/odin-claude-plugin
grok plugin install OutlineDriven/odin-claude-plugin#plugins/odin-core

The #plugins/ suffix selects one plugin subdirectory from the repository.

Kimi

From a local clone; Kimi cannot install a subdirectory of a GitHub repository.

/plugins marketplace /path/to/odin-claude-plugin/.kimi-plugin/marketplace.json
/plugins install /path/to/odin-claude-plugin/plugins/odin-core

Both paths are absolute: Kimi rejects a relative plugin root.

Choose your plugins

Nothing here is all-or-nothing. odin-core and odin-code are the base from Install; every row below is what you add on top for that kind of work, and the rest of the 28 stay uninstalled.

Working on	Add
Everyday code changes	odin-run, odin-git
Tests and verification	odin-testing
Large refactors, audits, bounded iteration	odin-code, odin-review
A specific language	odin-python, odin-typescript, odin-native, odin-apple, or odin-formal
Web and interface work	odin-web, odin-design
Security review and hardening	odin-security, odin-fuzzing
Research and technical writing	odin-research, odin-knowledge, odin-writing
Product, planning, and new artifacts	odin-planning, odin-product, odin-visual
Building agents	odin-agent, odin-skills
Infrastru