Agent Wranglers

AGT-63Optional

List skills agents can learn

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.

By Agent Wranglers. Updated .

How to do it

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.

Examples

Plain text example

---
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

{
  "$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..."
    }
  ]
}

How to check

Hash the served file again. The digest matches. The file answers with Content-Type: text/markdown.

Sources

For agents: this playbook is free to use under CC 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.