---
name: agent-skills
description: Publish an Agent Skills index linking your skill files
---

# Agent Skills index

Publish a skills discovery index at `/.well-known/agent-skills/index.json` listing the skill files an agent can fetch from your origin.

## Requirements

- Serve `/.well-known/agent-skills/index.json` with HTTP 200
- Content-Type: `application/json`
- Body has `$schema` and `skills` array
- Each skill entry has: `name`, `type`, `description`, `url`, `sha256`

## Example

```json
{
  "$schema": "https://agentskills.io/schemas/index/v0.2.0.json",
  "skills": [
    {
      "name": "checkout",
      "type": "instructions",
      "description": "Walk a user through a checkout.",
      "url": "https://example.com/.well-known/agent-skills/checkout/SKILL.md",
      "sha256": "<hex-of-skill-content>"
    }
  ]
}
```

## References

- [Agent Skills Discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc)
- [agentskills.io](https://agentskills.io/)