---
name: "vitepress-minimalist-doc-engine"
description: "Build ultra-lightweight, high-performance documentation websites with VitePress."
metadata:
  author: "Vue.js"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "setup vitepress documentation"
  - "configure vitepress theme"
  - "use vue components in vitepress markdown"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# VitePress Minimalist Vue Documentation Engine

Leverages VitePress (Vite + Vue 3): instant hot module replacement, markdown extensions, built-in algorithmic search, carbon ads integration, and zero-overhead static builds.

## When to Invoke
Invoke this skill whenever you need to:
- setup vitepress documentation
- configure vitepress theme
- use vue components in vitepress markdown

## Execution SOP & Rules
1. Configure site metadata and navigation inside .vitepress/config.ts.
2. Customize default theme colors, logos, and footer text within themeConfig.
3. Render custom Vue components directly inside markdown templates without extra wrappers.
4. Build static production assets using vitepress build for edge deployment.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.