AI & optimization

Skills (SKILL.md)

Publish an automatically generated agent skill that teaches coding agents how to work with your product.

Every published Velu site includes a generated SKILL.md file. It gives coding agents and other AI tools a compact description of what users can accomplish with your product, the workflows they should follow, and the constraints they need to respect.

There is nothing to configure. Velu generates the skill when you publish the site and regenerates it after later publishes so it follows your current docs.

What Velu publishes

Velu publishes a discovery index and one skill:

https://docs.acme.com/.well-known/skills/index.json
https://docs.acme.com/.well-known/skills/<skill-name>/SKILL.md

The index contains the exact skill name, description, and filename. Read it instead of guessing the generated slug:

{
  "skills": [
    {
      "name": "acme",
      "description": "Use Acme to build and operate payment workflows.",
      "files": ["SKILL.md"]
    }
  ]
}

The skill name is derived from the site name, or from the Velu subdomain when a site name is unavailable.

Velu currently serves skills through the well-known discovery paths above. It does not provide a /skill.md shortcut.

Install the skill in an agent

Tools that support well-known skill discovery can install from the documentation site's root URL. With the Skills CLI:

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

An agent can also fetch /.well-known/skills/index.json, choose the listed skill, and load its SKILL.md URL directly.

Skills compared with llms.txt

Output	Purpose
`SKILL.md`	Teaches an agent what it can accomplish and which workflows or constraints to follow.
`llms.txt`	Lists the documentation pages available to fetch.
`llms-full.txt`	Provides all published page content in one Markdown document.

Use the skill for durable operating guidance and the Markdown exports when an agent needs detailed reference material.

Skills are generated by the hosted publishing pipeline. They are not emitted by velu dev; publish the site before testing its discovery URLs.

Was this page helpful?

Markdown export & llms.txt

Model Context Protocol