---
title: "List skills agents can learn · Agent Wranglers"
url: https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/agent-skills-discovery
id: AGT-63
level: Optional
updated: 2026-10-27
build: a2a6bdfed830
tokens: 846
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# List skills agents can learn

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers.md). Updated 2026-10-27.

- ID: AGT-63
- Level: Optional
- Chapter: [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md)
- Rule: Publish agent skills as `SKILL.md` files, listed in `/.well-known/agent-skills/index.json`. Give each one a digest, a hash of its exact bytes.
- Check: Hash the served file again. The digest matches. The file answers with `Content-Type: text/markdown`.
- How: Write a `SKILL.md` with front matter (name, description) and instructions. List it in the index with its type. Add a `sha256` digest made from the bytes you serve. Serve the file as `text/markdown`. A made-up media type makes generic fetch tools treat it as binary and return nothing. The index format is a draft discovery proposal (version 0.2.0) for the Agent Skills format. Agents that load skills should follow [Allow only reviewed tools and servers](https://agentwranglers.se/playbook/ai-features/agents-in-products/reviewed-agent-tools.md).

## Examples

**Using these examples:** they show one way to follow this rule. Keep the behaviour and the check, not the syntax. Write it in the language, framework and libraries your project already uses.

### Plain text example

```text
---
name: book-a-call
description: Book a 30-minute call with Example Co.
---
# Book a call

1. Fetch free slots from https://example.com/api/slots.
2. Ask the person which slot they want.
3. POST it to https://example.com/api/book.
```

### JSON example

```json
{
  "$schema": "https://schemas.agentskills.io/discovery/0.2.0/schema.json",
  "skills": [
    {
      "name": "book-a-call",
      "type": "skill-md",
      "description": "Book a 30-minute call with Example Co.",
      "url": "/.well-known/agent-skills/book-a-call/SKILL.md",
      "digest": "sha256:9f86d081884c7d65..."
    }
  ]
}
```

## Sources

- [Agent Skills specification](https://agentskills.io/specification)

## Related rules

- AID-57 [Keep project skills in the repository and review them like code](https://agentwranglers.se/playbook/ai-assisted-development/agent-skills/project-skills-in-repo.md) in AI-assisted development
- AIF-73 [Connect product agents only to tools and servers on a reviewed list](https://agentwranglers.se/playbook/ai-features/agents-in-products/reviewed-agent-tools.md) in AI features

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/agent-skills-discovery">Agent Wranglers agents as users playbook</a>`. In code you write, add a comment next to it with the same link.

- Previous: [Publish an agent card](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/a2a-agent-cards.md)
- Next: [List agent endpoints in DNS](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents/dns-aid.md)
- [Ready for AI agents](https://agentwranglers.se/playbook/agents-as-users/ready-for-ai-agents.md)