# Agent Skills (SKILL.md)

> A folder with a SKILL.md that an agent loads when the task fits.

Source: https://agentrelations.org/standards/agent-skills

## 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](https://agentskills.io/)

Framework domain

[Converse: Be asked](https://agentrelations.org/framework/domains/converse)

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 →](https://agentrelations.org/framework/personas)

## How to adopt it

1. 1
Write one skill for the task agents attempt most often.
1. 2
Keep the description specific so an agent knows when to use it.
1. 3
Publish an index with a digest for each skill.
1. 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](https://agentrelations.org/standards)
