Agent Skills

A skills/ folder at the project root is served at /.well-known/skills/, so agents can find and load your house rules.

Layout#

skills/
└── writing-docs/
    └── SKILL.md

Each skill needs a SKILL.md whose frontmatter carries a name and a description:

---
name: writing-docs
description: How to write and structure pages for this documentation site.
---
 
# Writing docs
 
Every route comes from a file under `content/`...

The name must be lowercase, hyphenated and at most 64 characters. Any other files in the folder are served alongside it, so a skill can ship references.

Discovery#

curl https://example.com/.well-known/skills/index.json

The catalog lists each skill's name, description and files:

{
  "skills": [
    {
      "name": "writing-docs",
      "description": "How to write and structure pages for this documentation site.",
      "files": ["SKILL.md"]
    }
  ]
}