From docs-guardian
Generates and audits VitePress documentation, covering config parsing, directory structure, frontmatter conventions, sidebar navigation, code-to-doc mapping, and VitePress-specific Markdown features.
How this skill is triggered — by the user, by Claude, or both
Slash command
/docs-guardian:fw-vitepressThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Detected when any of these exist:
Detected when any of these exist:
.vitepress/config.ts.vitepress/config.js.vitepress/config.mtsKey fields to extract from the VitePress config:
export default defineConfig({
title: 'My Project',
themeConfig: {
sidebar: [
{
text: 'API Reference',
items: [
{ text: 'Auth', link: '/api/auth' },
{ text: 'Users', link: '/api/users' }
]
}
],
nav: [
{ text: 'Guide', link: '/guide/' },
{ text: 'API', link: '/api/' }
]
}
})
themeConfig.sidebar: primary navigation structure.md extension<link>.md relative to the VitePress rootThe directory containing .vitepress/. Common patterns:
.vitepress/ at root, docs alongside)docs/ subdirectory (docs/.vitepress/)Parse sidebar items to find existing doc pages. Convert links to file paths: /api/auth → api/auth.md relative to doc root.
| Source | Doc Candidate |
|---|---|
src/auth/login.ts | api/auth.md or reference/auth/login.md |
src/composables/useAuth.ts | api/composables/useAuth.md |
src/components/Button.vue | components/Button.md |
VitePress supports standard Markdown plus Vue components and YAML frontmatter:
---
outline: deep
---
# Auth Module
Brief description.
## API Reference
### `login(username, password)` {#login}
Authenticates a user and returns a session token.
**Parameters:**
| Name | Type | Description |
|------|------|-------------|
| `username` | `string` | The user's login name |
| `password` | `string` | The user's password |
**Returns:** `Session` — An authenticated session object.
::: tip
Use environment variables for credentials in production.
:::
::: code-group
```ts [TypeScript]
const session = await login("admin", "secret");
const session = await login("admin", "secret");
:::
## VitePress-Specific Content
Valid VitePress content — do not flag as quality issues:
- `::: tip/warning/danger/details` containers
- `{{ expression }}` Vue template syntax
- `<script setup>` blocks in markdown
- Custom Vue components (e.g., `<Badge type="warning" />`)
- YAML frontmatter with VitePress-specific fields (`outline`, `layout`, `hero`)
npx claudepluginhub xiaolai/claude-plugin-marketplace --plugin docs-guardianFetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Provides a checklist for code reviews covering functionality, security, performance, maintainability, tests, and quality. Use for pull requests, audits, team standards, and developer training.