How do I install the Vitepress skill?

Run npx skillmds@latest add kirklin/vitepress in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Vitepress safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Vitepress?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Vitepress free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Vitepress?

kirklin (@kirklin) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Vitepress by kirklin — Agent Skill

Name: Vitepress
Rating: 4.2 (5 reviews)
Author: kirklin

File contents

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:

File-based routing with .md files
Vue components work directly in Markdown
Fast HMR with instant updates (<100ms)
Default theme optimized for documentation
Built-in search (local or Algolia)

Before working with VitePress projects:

Check .vitepress/config.ts for site configuration
Look at .vitepress/theme/ for custom theme extensions
The public/ directory contains static assets served as-is

The skill is based on VitePress 1.x, generated at 2026-01-28.

Core

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

Features

Code & Content

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

Theme

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

Advanced

Topic	Description	Reference
Internationalization	Multi-language sites, locale configuration	advanced-i18n
SSR Compatibility	Server-side rendering, ClientOnly, dynamic imports	advanced-ssr

Recipes

Topic	Description	Reference
Deployment	GitHub Pages, Netlify, Vercel, Cloudflare, Nginx	recipes-deploy

---name: vitepressdescription: VitePress static site generator powered by Vite and Vue. Use when building documentation sites, configuring themes, or writing Markdown with Vue components.---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:**- File-based routing with `.md` files- Vue components work directly in Markdown- Fast HMR with instant updates (<100ms)- Default theme optimized for documentation- Built-in search (local or Algolia)**Before working with VitePress projects:**- Check `.vitepress/config.ts` for site configuration- Look at `.vitepress/theme/` for custom theme extensions- The `public/` directory contains static assets served as-is> The skill is based on VitePress 1.x, generated at 2026-01-28.## Core| Topic | Description | Reference ||-------|-------------|-----------|| Configuration | Config file setup, defineConfig, site metadata | [core-config](references/core-config.md) || CLI | Command-line interface: dev, build, preview, init | [core-cli](references/core-cli.md) || Routing | File-based routing, source directory, rewrites | [core-routing](references/core-routing.md) || Markdown | Frontmatter, containers, tables, anchors, includes | [core-markdown](references/core-markdown.md) |## Features### Code & Content| Topic | Description | Reference ||-------|-------------|-----------|| Code Blocks | Syntax highlighting, line highlighting, diffs, focus | [features-code-blocks](references/features-code-blocks.md) || Vue in Markdown | Components, script setup, directives, templating | [features-vue](references/features-vue.md) || Data Loading | Build-time data loaders, createContentLoader | [features-data-loading](references/features-data-loading.md) || Dynamic Routes | Generate pages from data, paths loader files | [features-dynamic-routes](references/features-dynamic-routes.md) |## Theme| Topic | Description | Reference ||-------|-------------|-----------|| Theme Config | Nav, sidebar, search, social links, footer | [theme-config](references/theme-config.md) || Customization | CSS variables, slots, fonts, global components | [theme-customization](references/theme-customization.md) || Custom Theme | Building themes from scratch, theme interface | [theme-custom](references/theme-custom.md) |## Advanced| Topic | Description | Reference ||-------|-------------|-----------|| Internationalization | Multi-language sites, locale configuration | [advanced-i18n](references/advanced-i18n.md) || SSR Compatibility | Server-side rendering, ClientOnly, dynamic imports | [advanced-ssr](references/advanced-ssr.md) |## Recipes| Topic | Description | Reference ||-------|-------------|-----------|| Deployment | GitHub Pages, Netlify, Vercel, Cloudflare, Nginx | [recipes-deploy](references/recipes-deploy.md) |

Frequently asked questions

Vitepress