skill-writing-guide

Installation
SKILL.md

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.

Installs
1
GitHub Stars
5
First Seen
Jul 30, 2026