.cursor/skills/vitepress/SKILL.md
VitePress static site generator powered by Vite and Vue. Use when building documentation sites, configuring themes, or writing Markdown with Vue components.
npx skillsauth add cooker/wx-mp-article vitepressInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
4 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
VitePress is a Static Site Generator (SSG) built on Vite and Vue 3. It takes Markdown content, applies a theme, and generates static HTML that becomes an SPA for fast navigation. Perfect for documentation, blogs, and marketing sites.
Key Characteristics:
.md filesBefore working with VitePress projects:
.vitepress/config.ts for site configuration.vitepress/theme/ for custom theme extensionspublic/ directory contains static assets served as-isThe skill is based on VitePress 1.x, generated at 2026-01-28.
| Topic | Description | Reference | |-------|-------------|-----------| | Configuration | Config file setup, defineConfig, site metadata | core-config | | CLI | Command-line interface: dev, build, preview, init | core-cli | | Routing | File-based routing, source directory, rewrites | core-routing | | Markdown | Frontmatter, containers, tables, anchors, includes | core-markdown |
| Topic | Description | Reference | |-------|-------------|-----------| | Code Blocks | Syntax highlighting, line highlighting, diffs, focus | features-code-blocks | | Vue in Markdown | Components, script setup, directives, templating | features-vue | | Data Loading | Build-time data loaders, createContentLoader | features-data-loading | | Dynamic Routes | Generate pages from data, paths loader files | features-dynamic-routes |
| Topic | Description | Reference | |-------|-------------|-----------| | Theme Config | Nav, sidebar, search, social links, footer | theme-config | | Customization | CSS variables, slots, fonts, global components | theme-customization | | Custom Theme | Building themes from scratch, theme interface | theme-custom |
| Topic | Description | Reference | |-------|-------------|-----------| | Internationalization | Multi-language sites, locale configuration | advanced-i18n | | SSR Compatibility | Server-side rendering, ClientOnly, dynamic imports | advanced-ssr |
| Topic | Description | Reference | |-------|-------------|-----------| | Deployment | GitHub Pages, Netlify, Vercel, Cloudflare, Nginx | recipes-deploy |
development
MUST be used for Vue.js tasks. Strongly recommends Composition API with `<script setup>` and TypeScript as the standard approach. Covers Vue 3, SSR, Volar, vue-tsc. Load for any Vue, .vue files, Vue Router, Pinia, or Vite with Vue work. ALWAYS use Composition API unless the project explicitly requires Options API.
development
Vitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filtering and fixtures.
tools
Vite build tool configuration, plugin API, SSR, and Vite 8 Rolldown migration. Use when working with Vite projects, vite.config.ts, Vite plugins, or building libraries/SSR apps with Vite.
tools
UnoCSS instant atomic CSS engine, superset of Tailwind CSS. Use when configuring UnoCSS, writing utility rules, shortcuts, or working with presets like Wind, Icons, Attributify.