Building Agent Skills
Help users build clean, discoverable skills that work across Claude Code, Codex, Amp, and OpenCode.
Official Spec
Fetch from https://agentskills.io/specification for YAML frontmatter, file format, and client integration details.
Minimal Structure
code
my-skill/ SKILL.md # Required (<500 lines) references/ # Optional: detailed docs scripts/ # Optional: executable utilities
SKILL.md Essentials
yaml
--- name: my-skill description: > What it does. Include trigger phrases so AI knows when to activate. --- # Title ## When to Use - Trigger condition 1 - Trigger condition 2 ## Quick Reference [Tables, common commands] ## Detailed Docs See [references/](references/) for full documentation.
References
| Topic | File |
|---|---|
| Full SKILL.md template | format.md |
| Adding scripts | scripts.md |
| Safety/auth/trigger patterns | patterns.md |
| Installation paths | installation.md |
| Distribution (git/CLI/plugin) | distribution.md |
| Plugin/marketplace structure | plugin-structure.md |
| Production examples | real-examples.md |