Required location
Store each skill at:.agents/skills/<skill-name>/SKILL.md
Example:
.agents/skills/upgrade-deps/SKILL.md
Invocation
Call a skill by name in your request:$<skill-name>
Example: $upgrade-deps
Minimal skill anatomy
A strongSKILL.md should include:
- Goal: what outcome the skill produces.
- Inputs: what context or parameters it expects.
- Steps: the execution sequence.
- Return shape: what output format to return.
- Guardrails: hard boundaries and safety constraints.
Instructions vs. skills
- Put durable repo policy in AGENTS.md instructions.
- Put repeatable task workflows in skills.
AGENTS.md.
If it should apply only when explicitly requested, it belongs in a skill.