vitepress

antfu/skills · Agent Skill

VitePress 檔案網站包含設定、主題和 Markdown 加上 Vue 內容的指南。

總覽

發布者	antfu社群
儲存庫	antfu/skills ↗
技能資料夾	`vitepress`
星	6,011
分支	338
附帶檔案	16
授權	MIT
最近更新	2026年10月23日
連結	技能原始碼 ↗ · 儲存庫 ↗

Mozgi 檢查

我們在技能檔案中發現的內容。詳細資訊需訂閱。

安全性

低風險 · 未發現明顯風險 — 完整報告會顯示細節

相容性

需要額外軟體

相似技能

找到 62 個相似技能

訂閱另含

安裝

技能就是一個含 SKILL.md 的資料夾。選擇你的代理，在專案根目錄的終端機（macOS、Linux 或 Windows 的 Git Bash）執行指令。

把提示貼到 Claude、Codex 或其他助理：它會自行檢查並安裝技能。

Install the “vitepress” skill from mozgi.io (https://mozgi.io/skills/antfu-vitepress/) for me.

1. Download the archive: https://mozgi.io/skills/antfu-vitepress/download
   If it fails, take the skill folder from the source: https://github.com/antfu/skills/tree/main/skills/vitepress
2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me.
3. Put the “vitepress” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.).
4. Make sure <skills folder>/vitepress/SKILL.md exists.
5. Briefly tell me what this skill does and offer to try it on my task.

If you cannot do a step yourself, tell me what to click or type.

git clone --depth 1 --branch main https://github.com/antfu/skills.git /tmp/skills
mkdir -p .claude/skills
cp -r /tmp/skills/skills/vitepress .claude/skills/vitepress

重新啟動 Claude Code — 技能就會出現在清單中，手動呼叫：/vitepress。要套用到所有專案，請放在 ~/.claude/skills。

git clone --depth 1 --branch main https://github.com/antfu/skills.git /tmp/skills
mkdir -p .agents/skills
cp -r /tmp/skills/skills/vitepress .agents/skills/vitepress

Codex 會從目前資料夾往上到儲存庫根目錄，在 .agents/skills 中尋找技能；用 /skills 或 $vitepress 呼叫。所有專案：~/.agents/skills。

git clone --depth 1 --branch main https://github.com/antfu/skills.git /tmp/skills
mkdir -p .cursor/skills
cp -r /tmp/skills/skills/vitepress .cursor/skills/vitepress

Cursor 啟動時會載入技能；在 Agent 聊天輸入「/」呼叫。Cursor 也會讀取 .claude/skills 與 .agents/skills。所有專案：~/.cursor/skills。

git clone --depth 1 --branch main https://github.com/antfu/skills.git /tmp/skills
mkdir -p .gemini/skills
cp -r /tmp/skills/skills/vitepress .gemini/skills/vitepress

任務符合時，Gemini CLI 會提議啟用技能，由你確認。所有專案：~/.gemini/skills。

技能檔案

16 個檔案下載 ZIP

安裝前請先檢視 SKILL.md 與相關檔案。點擊檔案即可預覽。

SKILL.md 內容

作者原文 · 唯讀

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 2.0.0-alpha.20, generated at 2026-09-25.

VitePress 2 notes (v1 → v2): install with vitepress@next; requires Node.js 22+. defineConfigWithTheme is deprecated — use defineConfig<ThemeConfig>. Native RTL support (dir option, CSS logical properties) replaces the old PostCSS-plugin approach. Built-in iconify pipeline (icons config, useIcon/VPIcon, collection:name social icons). New assetsBase (CDN) and assetsShards build options; metaChunk removed. Markdown image.lazyLoading renamed to image.lazyLoad.

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 ↗ |

常見問題

vitepress 技能有什麼用途？

VitePress 檔案網站包含設定、主題和 Markdown 加上 Vue 內容的指南。

如何安裝 vitepress？

打開本頁的「安裝」區塊並選擇你的代理 — Claude Code、Codex、Cursor 或 Gemini CLI：那裡有把技能資料夾複製到正確位置的現成指令。也可以複製「透過助理」分頁中的提示，讓助理自行檢查並安裝技能。

vitepress 適用哪些 AI 模型？

技能是純 Markdown 指示（Agent Skills 格式），因此 vitepress 適用任何讀取 SKILL.md 的代理：Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode 等。只有在任務符合技能描述時，模型才會載入指示。

vitepress 是免費的嗎？

此技能由 antfu 公開發布，採用 MIT 授權。技能本身免費 — 你只需向 AI 供應商支付實際使用的 token 費用。

安裝技能安全嗎？

技能是代理會遵循的指示，安裝前請閱讀 SKILL.md 及相關檔案。技能資料夾中的腳本只有在代理執行時才會運行 — 留意它的動作，不要授予多餘權限。

技能和 MCP 伺服器或外掛有何不同？

MCP 伺服器或外掛為模型提供新工具 — 會執行並回傳結果的程式碼。技能提供的是知識與流程：如何處理任務、要遵循哪些步驟、好的成果長什麼樣子。它不需要伺服器或 API 金鑰。

總覽

Mozgi 檢查

安裝

技能檔案

SKILL.md 內容

Core

Features

Code & Content

Theme

Advanced

Recipes

常見問題

相關技能