Use when asked to design or change a public API, route, CLI flag, or module boundary. Not for remote, credential, publish, deploy, or irreversible changes.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# API and interface design
## Contract
| Field | Bound contract |
|---|---|
| Trigger | Designing or changing a public API, route, CLI flag, or module boundary. |
| Authority | Reversible local: writes only named local interface definitions and contract docs, edits consumer files onto the new contract, and deletes legacy paths (old signatures, aliases, re-exports, deprecated entry points) during cutover; rollback is undo (discard the uncommitted draft) or version control. No remote mutation. No credential, paid, published, or deployed change, and no VCS history rewrite. |
| Side effect | Interface definitions and contract docs written before implementation; consumer files edited onto the new contract and legacy paths (old signatures, aliases, re-exports, deprecated entry points) deleted during cutover; no build, publish, or remote mutation. |
| Done | Contract is documented with semantics and errors, every consumer is migrated, and no legacy path remains. |
## Inputs
…
The line at the top of this page pins the label git:20260904.2014e73, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_2m22zxc7mfdnjteh
GET https://markdownregistry.com/api/v1/resolve?ref=outlinedriven/odin-claude-plugin/api-and-interface-design
GET https://markdownregistry.com/api/v1/blob/ad6adaf639f0b51721bc0191dc3730de39b94fbfb1c8a558dee8577d3e670ec1
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/agent-environment-retrospective/SKILL.md · Use when a completed session needs an agent-environment retrospective. Not for an engineering retrospective from…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/agents-md/SKILL.md · Use when a repo needs agent setup, AGENTS.md added or made lean, CLAUDE.md audited, or agent instructions scored or…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/check-agent-compatibility/SKILL.md · Use when a human explicitly asks for a full repository agent-compatibility pass returning a scored report with…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/claude-settings-audit/SKILL.md · Use when setting up a project, auditing agent command permissions, or asking which read-only bash commands and domains…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/cli-for-agents/SKILL.md · Use when asked to build or review a CLI intended for coding agents and return flag-driven, pipeline-safe, idempotent…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/harness-port-guide/SKILL.md · Use when the user asks to make the skills framework work in a new harness, IDE, or CLI. Not for remote, credential…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/inits/SKILL.md · Use when onboarding to a repository, capturing costly conventions, constraints, or rationale, or improving AGENTS.md…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/mcp-builder/SKILL.md · Use when asked to create an MCP server to integrate an API or service in Python or TypeScript. Not for remote…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/multi-agent-tournament-scorecard/SKILL.md · Use when agent strategies need a reproducible finite tournament under a frozen evaluation protocol. Not for open-ended…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/prohibit-bad-habits/SKILL.md · Use when a user wants to define patterns the agent should not do. Don''t use for remote, credential, publish, deploy…
addyosmani/agent-skills · skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when…
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when…
shashankswe2020-ux/whoop-mcp · .github/skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-codex/.agents/skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/cursor/.cursor/skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-forgecat/platforms/codex/.agents/skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when…
nota-america/forgecat-agent-profiles · profiles/addyosmani/agent-skills/for-claude/.claude/skills/api-and-interface-design/SKILL.md · Guides stable API and interface design. Use when designing APIs,