Standard · Converse
Agent Skills (SKILL.md)
A folder with a SKILL.md that an agent loads when the task fits.
What it is
A skill is a folder with a SKILL.md: a name, a description and instructions. An agent loads it when the task matches. An organization can publish skills that teach agents how to deal with it: how to apply, how to ask for a quote or which page answers which question.
An analogy
At a glance
- Owner
- Format by Anthropic, an open standard since late 2025; the discovery index is a Cloudflare-led draft (v0.2.0)
- Maturity
- Emerging Read by Claude. Codex, Cursor, Copilot and Gemini CLI are reported to read it too. A site lists its skills at /.well-known/agent-skills/index.json, with a digest for each.
- Where it lives
- agentskills.io
- Framework domain
- Converse: Be asked
- What it serves
- Teach agents the right way to work with you
- Package your processes for agents
Who should care
The roles this standard touches most. See all the roles on the personas page.
- Engineering and product. Build the access, data, endpoints and actions that agents use, on open standards.
- Service and operations. Answer agents’ questions, hand off to people well and keep promises made through agents.
- Agent Relations practitioners. The central team or lead that runs the practice, sets standards inside the organization and enables everyone else.
How to adopt it
- 1
Write one skill for the task agents attempt most often.
- 2
Keep the description specific so an agent knows when to use it.
- 3
Publish an index with a digest for each skill.
- 4
Review the skills whenever the process behind them changes.
The Institute’s view
A natural fit for the field, since it is plain text anyone can write. The discovery index is still a draft, so publish skills but expect the index format to change.
Standards change fast. Last reviewed November 2026.