What is a Skill?
A skill is a self-contained package an Agent can use to extend its capabilities in a specific domain, or to acquire a new specific capability. All skills contain:- Instructions: Detailed guidance on when and how to apply the skill (in
SKILL.md) - Scripts: Optional executable code templates the agent can run
- References: Optional supporting documentation (guides, cheatsheets, examples)
Why Use Skills?
Domain Expertise on Demand
Instead of filling the system message with instructions to cover every usecase, skills let you organize domain knowledge into focused packages. The agent loads only what it needs, allowing you to save tokens and ultimately reduce costs.Reusable Knowledge Packages
Create skills once, use them across multiple agents. A code review skill can be shared between your debugging agent, PR review agent, and code generation agent.Progressive Discovery
Skills use lazy loading to keep context windows efficient:- Browse: The agent sees skill summaries in its system prompt
- Load: When a task matches a skill, the agent loads full instructions
- Reference: The agent accesses detailed documentation as needed
- Execute: The agent can run scripts from the skill