skill-writing-guide
Skill writing guide
What is a skill
A skill is a folder containing a SKILL.md file that gives an AI agent specialized knowledge, workflows, or tools for a specific task. Skills are part of an open standard adopted by 30+ agent products including Claude Code, OpenAI Codex, Cursor, Gemini CLI, VS Code Copilot, GitHub Copilot, Junie, Goose, Roo Code, and others.
The standard is maintained at agentskills.io with the source at github.com/agentskills/agentskills.
Skills solve the problem that agents lack procedural knowledge and domain-specific context. A skill packages that knowledge in a portable, version-controlled format that works across multiple agent products.
Repo philosophies for new skills
New skills authored in this repo should align with the four canonical
philosophies anchored at
docs/REPO_STYLE.md:
"Long-term over short-term", "Fix the design, not the symptom",
"Fresh subagent per task", and "Atomic task decomposition". Cite the anchor
when relevant; do not restate the definitions in the new SKILL.md.