Agent Skills

What are Agent Skills?

Movk Nuxt Docs automatically discovers the skills in the skills/ directory and, following the Cloudflare Agent Skills Discovery RFC, deploys them under the /.well-known/skills/ endpoint. With a single command, users can install your skills into AI assistants such as Claude Code and Cursor.

Agent Skills is a lightweight open format for giving AI assistants dedicated knowledge and workflows. Each Skill is a SKILL.md file that describes what tasks the AI assistant can accomplish with your product and how to do them, and it can include any number of reference files.

Built-in Skills

This site already publishes the following two ready-to-use Skills by default, which AI assistants can use immediately after installation:

create-docs

Generate a complete documentation site for any project, automatically including search, dark mode, MCP Server, and llms.txt integration.

Trigger words: create docs, add documentation, initialize docs, generate documentation, scaffold a documentation site, and more.

review-docs

Review Markdown documentation for quality, clarity, SEO, and technical correctness, producing prioritized, actionable suggestions (Critical / Important / Suggested). Tuned for Movk Nuxt Docs / Nuxt Content but compatible with any Markdown docs.

Trigger words: review docs, check documentation, validate MDC syntax, check SEO issues, and more.

One-command install

npx skills add https://docs.mhaibaraai.cn

The CLI automatically detects installed agents such as Claude Code, Cursor, and Windsurf, and installs both Skills together.

Creating a Skill

my-docs/
└── skills/
    └── my-skill/
        └── SKILL.md

---
name: my-skill
description: |
  Describe what this Skill is for.
  List what users say that should trigger this Skill.
---

# My Skill

## Workflow

1. Step one
2. Step two

npx skills add https://your-docs-site.com

Naming conventions

The Skill name (both the directory name and the name field) must follow the agent skills naming specification:

• 1-64 characters
• Only lowercase letters, numbers, and hyphens (a-z, 0-9, -)
• Cannot start or end with a hyphen
• Cannot contain consecutive hyphens (--)
• The name field in the frontmatter must match the parent directory name exactly

Directory structure

A Skill directory can contain any number of supporting files, which the AI assistant fetches on demand when invoking the Skill:

skills/
└── my-skill/
    ├── SKILL.md
    ├── references/
    │   ├── style-guide.md      # Writing style guide
    │   └── checklist.md        # Checklist
    └── assets/
        └── template.md         # Page template

All files are automatically listed in the index.json index and served at their respective paths under /.well-known/skills/{skill-name}/.

Publishing multiple Skills

A single documentation site can publish multiple independent Skills:

skills/
├── create-docs/    # Create a documentation site
├── review-docs/    # Review documentation quality
└── code-review/    # Code review

All Skills are listed in index.json, and the AI assistant selects automatically based on user intent.

Comparison with llms.txt

Both Agent Skills and llms.txt help AI tools use your documentation, but they serve different purposes: