Skill Discovery

Holocron implements the agent-skills 0.2.0 discovery spec (RFC 8615 extension) and a legacy format for backward compatibility. This lets AI agents discover your docs as a "skill" they can load.

Discovery endpoints

Endpoint	Format
`/.well-known/agent-skills/index.json`	v0.2.0 JSON index
`/.well-known/agent-skills/<name>/SKILL.md`	Skill markdown file
`/.well-known/skills/index.json`	Legacy JSON index
`/.well-known/skills/<name>/SKILL.md`	Legacy skill file

The <name> is derived from your site's name field in docs.json (lowercased, kebab-cased).

SKILL.md content

The generated SKILL.md includes:

Frontmatter with name and description (from your config)
Instructions for fetching the sitemap
An example page .md route
Instructions for downloading /docs.zip and grepping it locally

How agents use this

Agent fetches /.well-known/agent-skills/index.json
Discovers available skills with names and descriptions
Fetches the SKILL.md for a relevant skill
Follows instructions inside (usually downloading /docs.zip)

Customizing the description

The skill description comes from the description field in your docs.json:

1234{
  "name": "My SDK",
  "description": "SDK for building widgets with the Acme API"
}

If no description is set, Holocron generates a default from the site name.

Ask AI about this page