SKILL.md, that contains everything an AI coding agent needs to perform a specific task reliably.
The problem skills solve
AI coding agents like Claude Code, Cursor, and Copilot are powerful but generic. Without specific instructions, they:- Guess at your project’s conventions
- Miss domain-specific requirements
- Produce inconsistent results across sessions
- Cannot learn from corrections
What a skill contains
A skill typically includes:Skills vs. prompts
Skills across agents
Skills are designed to be agent-agnostic. The same skill can be installed into:- Claude Code via
.claude/skills/files or CLAUDE.md sections - Cursor via
.cursor/skills/files - GitHub Copilot via
.github/copilot-instructions.md - Codex CLI via
AGENTS.md - Gemini CLI via
GEMINI.md - Amp via
.amp/skills/files - Goose via
.goose/skills/files
Skill lifecycle
- Create. Write from scratch, generate with AI, or convert existing docs.
- Edit. Refine instructions, add constraints, include examples.
- Evaluate. Score quality and fix gaps.
- Install. Deploy to one or more agent runtimes.
- Use. Agents follow the skill during coding sessions.
- Patch. Update based on real-world performance.