PlugWiki

VitePress Skill (antfu) for Claude: Build Docs Sites

Gives Claude reference notes on building VitePress documentation sites: config, Markdown, themes, i18n and deployment.

Installs
12K
on skills.sh
Stars
6K
on GitHub
Files
15
besides SKILL.md
Updated
Oct 2026
last repo commit

The vitepress skill makes Claude work from 14 short reference notes when you build or change a VitePress site. They cover config, the CLI, file-based routing, Markdown features, code blocks, Vue in Markdown, data loading, dynamic routes, theme config and customization, i18n, SSR compatibility and deployment. It also tells Claude to check .vitepress/config.ts, .vitepress/theme/ and public/ before it works.

It is generated from the VitePress source and is based on VitePress 2.0.0-alpha.20, generated on 2026-09-25. It includes notes on moving from v1 to v2, such as installing vitepress@next and needing Node.js 22 or newer. The folder bundles no scripts.

Good for

  • Developers building a documentation site or blog with VitePress
  • Vue users who want components inside Markdown pages
  • Teams deploying a VitePress site to GitHub Pages, Netlify, Vercel or Cloudflare

Install vitepress

Claude Code

  1. 1

    Copy this prompt.

    Install the vitepress skill in Claude Code. Run this command:

npx skills add antfu/skills --skill vitepress

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The second command installs every skill in the repo (14 skill folders). The README's recommended route is the separate @antfu/skills pack; that pack's own README does not list vitepress, so use one of these commands instead.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

VitePress static site generator powered by Vite and Vue. Use when building documentation sites, configuring themes, or writing Markdown with Vue components.

Sections in SKILL.md

  1. Core
  2. Features
  3. Code & Content
  4. Theme
  5. Advanced
  6. Recipes

Key facts

Author
Anthony Fu (SKILL.md metadata)
License
MIT (repo README)
Installs on skills.sh
11,960 (Nov 2, 2026)
GitHub stars
6,032 (repo, Nov 2, 2026)
Files
16 including SKILL.md: 14 reference notes and GENERATION.md, no scripts
Based on
VitePress 2.0.0-alpha.20, generated 2026-09-25
Last commit
Oct 30, 2026 (repo)

What it includes

  • Config, CLI, routing and Markdown notes.

    Four notes: core-config, core-cli, core-routing and core-markdown. They cover defineConfig, dev, build, preview and init, file-based routing and rewrites, and frontmatter and containers.

    Core

  • Code blocks, Vue in Markdown, data loading and dynamic routes.

    Four notes: features-code-blocks, features-vue, features-data-loading and features-dynamic-routes.

    Features

  • Theme config, customization and building a custom theme.

    Three notes: theme-config (nav, sidebar, search, footer), theme-customization (CSS variables, slots, fonts) and theme-custom.

    Theme

  • Multi-language sites and server-side rendering compatibility.

    Two notes: advanced-i18n and advanced-ssr.

    Advanced

  • Deploy to GitHub Pages, Netlify, Vercel, Cloudflare or Nginx.

    recipes-deploy holds build commands, a GitHub Actions workflow and one-line commands for other hosts.

    Recipes: deployment

  • Covers v1 to v2 changes such as vitepress@next and Node.js 22+.

    Listed in SKILL.md: defineConfigWithTheme is deprecated, RTL is native, image.lazyLoading is renamed image.lazyLoad.

    VitePress 2 notes

From the official docs

Permissions

Low risk

The skill is notes only, but its deployment note includes publish commands and a GitHub Actions workflow that Claude may reproduce if you ask it to deploy. Read any deploy command or workflow before you run or commit it.

What it can do

  • Read your data?
  • Create and change things?
  • Delete things?
  • Read-only mode

Watch out for

  • Deploy notes include publish commands

    recipes-deploy.md lists npx surge and npx harvis commands for the built site. Check the target before Claude runs one. github.com

  • The sample workflow requests write permissions

    The GitHub Pages workflow in recipes-deploy.md sets pages: write and id-token: write. Review the workflow before you commit it. github.com

Questions

What does the vitepress skill do?

It gives Claude reference notes for building VitePress sites. They cover config, routing, Markdown, Vue components, themes, i18n, SSR and deployment.

How do I install the vitepress skill?

Use the install box above. The first command installs just this skill. The README's --skill='*' command installs every skill in the antfu/skills repo.

Does it cover VitePress 1 or 2?

It is based on VitePress 2.0.0-alpha.20 and includes notes on moving from v1 to v2. SKILL.md says VitePress 2 installs with vitepress@next and needs Node.js 22 or newer.

Does it need an API key?

SKILL.md names none, and the folder bundles no scripts. It holds SKILL.md, GENERATION.md and 14 reference notes.

Is it safe to install?

The folder is markdown notes. The deployment note includes publish commands such as npx surge and a GitHub Actions workflow, so read any deploy command Claude suggests before it runs.

Is this the official VitePress skill?

The SKILL.md says it is generated from the vuejs/vitepress source, with scripts in antfu/skills. It is published by Anthony Fu in his own skills repo.

Information

updated Nov 2, 2026

Repository
antfu/skills
Folder
skills/vitepress

antfu/skillsskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 7
  1. antfu/skills README · github.com
  2. skills-pack README · github.com
  3. vitepress SKILL.md · github.com
  4. GENERATION.md · github.com
  5. vitepress on skills.sh · skills.sh
  6. antfu/skills · github.com
  7. recipes-deploy.md · github.com

Updated Nov 2, 2026.