Your docs are now discoverable by agents

You can now install skills from any Mintlify documentation site with one command:

npx skills add https://mintlify.com/docs

You don't need to know the file path where the skill is located or anything about how the site is structured. The CLI discovers and installs the skill automatically.

How discovery works

This is built on Cloudflare's Agent Skills Discovery RFC, which extends RFC 8615. RFC 8615 defines the /.well-known/ path prefix that powers ACME certificate validation, security.txt, and dozens of other web standards. By putting a resource at a predictable URL, tools can find it without configuration.

Sites publish a JSON index at a predictable path that lists available skills along with their descriptions and files:

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

{
  "skills": [
    {
      "name": "mintlify",
      "description": "Build and maintain documentation sites with Mintlify.",
      "files": ["SKILL.md"]
    }
  ]
}

When you run npx skills add <url>, the CLI fetches this index, shows you what's available, and installs it to your agents.

What this means for Mintlify users

Every Mintlify docs site already serves /.well-known/skills/ automatically. Your skill is generated from your documentation and stays up to date on every deploy, so anyone can install your product's skill with just your docs URL.

If you want to customize what agents learn about your product, place a skill.md in the root of your docs repository and it will override the auto-generated version. For guidance on writing effective skills, see our post on skill.md.

Try it

Pick any Mintlify-powered docs site and run:

npx skills add <docs-url>

The CLI detects your installed agents (Claude Code, Cursor, Windsurf, and others) and lets you install to all of them at once or select specific ones.

For background on why skills matter and how they complement MCP, see Why do we need MCP if skills exist now?.