SKILL.md) that let agents execute complex workflows consistently.
Why skills matter
- Convert repeated prompts into stable operating procedures
- Keep behavior portable across sessions and channels
- Enable autonomous agents to self-document successful workflows
Skill storage and precedence
Runtime resolves skills by layered priority:- Workspace skills
- Agent-created self skills
- User-global skills
- Builtin skills
Skill lifecycle
Auto-create skills pattern
A strong pattern for autonomy is:- Agent completes a multi-step task manually
- Agent saves the successful pattern as a new skill
- Future tasks call that skill directly
- Agent revises the skill when edge cases appear
Good skill design
- Keep scope narrow and explicit
- Include inputs, outputs, and constraints
- Add failure handling and fallback paths
- Prefer composable skill chains over giant monolithic skills
Related
Learning loop
See how memory and reflection improve skills over time.
Multi-agent teams
Delegate skills across specialized subagents.

