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

A one-page how-to left for the temp who covers the front desk.

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.

Framework personas →

How to adopt it

  1. 1

    Write one skill for the task agents attempt most often.

  2. 2

    Keep the description specific so an agent knows when to use it.

  3. 3

    Publish an index with a digest for each skill.

  4. 4

    Review the skills whenever the process behind them changes.

The Institute’s view

Adopt with care

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.

← Back to the Standards Map