authoring-skills-and-rules
Author Skills (SKILL.md) and rules/instructions across Claude Code, Cursor, OpenCode, Codex, and GitHub Copilot. Covers frontmatter, file layout, activation, mirroring, and craft: progressive disclosure, Apply-when descriptions, leading words, playbook steps copied into todos, skip reasons, the deletion test, and user-facing questions in plain English. Apply when the user asks to write, scaffold, refactor, port, or review a Skill, Cursor rule (.mdc), AGENTS.md, copilot-instructions, or prompt file — or to make one Skill/rule work across multiple agents. Use blinded-eval when a behavior-changing draft needs blinded proof. Use dissect to audit an existing system, not to author a skill.
Pinned to revision 7c3a5e04075f, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/authoring-skills-and-rules/SKILL.md
- skills/authoring-skills-and-rules/references/claude-code.md
- skills/authoring-skills-and-rules/references/codex.md
- skills/authoring-skills-and-rules/references/copilot.md
- skills/authoring-skills-and-rules/references/cross-platform.md
- skills/authoring-skills-and-rules/references/cursor.md
- skills/authoring-skills-and-rules/references/opencode.md
Every link opens the file at its source, pinned to the revision this page describes.