Agent Skills

Publish the Agent Skills in your project's skills/ directory under /.well-known/skills/ together with the docs site, so readers install them into Claude Code, Cursor and other assistants with one command. Covers layout, naming, publishing and the two built-in skills.
View source

Agent Skills are instructions for AI assistants: each skill is a SKILL.md with frontmatter describing what an assistant can do with your product and the steps to do it, optionally with any number of reference files.

Movk Nuxt Docs uses nuxt-agent-discovery to scan the skills/ directory at the project root at build time, generate an index and publish the files under /.well-known/skills/, following the Agent Skills Discovery convention.

Publish a skill

Create the directory

Create skills/ at the project root (next to nuxt.config.ts), with one subdirectory per skill:

my-docs/
├── nuxt.config.ts
└── skills/
    └── my-skill/
        └── SKILL.md

Write SKILL.md

description is required. State what the skill does and when to use it; assistants decide when to invoke it from this text:

skills/my-skill/SKILL.md
---
name: my-skill
description: |
  Write component docs for My Library.
  Use when asked to "document a component" or "describe the props".
---

# My Skill

## Workflow

1. Read the component source and list its props, slots and emits
2. Generate the page from references/template.md

Build and deploy

The build log lists the skills it found (Found 1 agent skill: my-skill); skills failing validation are skipped with a warning. After deploying they are served at:

Terminal
curl https://docs.example.com/.well-known/skills/index.json
curl https://docs.example.com/.well-known/skills/my-skill/SKILL.md

Install

Readers install every skill the site publishes with the skills CLI, which detects the assistants installed locally and writes to each:

Terminal
npx skills add https://docs.example.com

Naming rules

The skill name is the frontmatter name, or the directory name when omitted. It must:

  • Be 1–64 characters of lowercase letters, digits and hyphens
  • Not start or end with a hyphen, nor contain consecutive hyphens (--)
  • Match its directory name exactly

Layout

A skill directory may hold any supporting files, which assistants load on demand. Files and directories starting with . and symbolic links are not published.

skills/
└── my-skill/
    ├── SKILL.md
    ├── references/
    │   └── template.md
    └── assets/
        └── checklist.md

Every file is listed in index.json and served at /.well-known/skills/{name}/{path}. Keep SKILL.md under about 500 lines and move details into references/ to save the assistant's context.

A site can publish several skills; the index is sorted by name and assistants pick one from its description.

Change the directory

The scanned directory is agentDiscovery.skills.dir, relative to the project root and skills by default in the layer. Set skills to false to stop publishing skills:

nuxt.config.ts
export default defineNuxtConfig({
  agentDiscovery: {
    skills: {
      dir: 'agent-skills'
    }
  }
})

Built-in skills

This site publishes two skills that work for any project using Movk Nuxt Docs:

SkillPurpose
create-docsAnalyze a project and generate a complete Movk Nuxt Docs site: layout, configuration, pages and AI integration
review-docsReview docs for structure, clarity, SEO and technical accuracy, with Critical / Important / Suggested findings
Terminal
npx skills add https://docs.mhaibaraai.cn
View the skill index published by this site

Compared with llms.txt

llms.txtAgent Skills
ContentA directory of pages and linksActionable workflows, constraints and examples
LoadedWhen the assistant looks something upOn demand, when the skill is triggered
PurposeHelp the assistant find informationTeach the assistant to use your product

They complement each other: llms.txt tells an assistant where the information is, a skill tells it what to do.

Copyright © 2024 - 2026