external/antfu-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 seikaikyo/dash-skills 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
拋棄式 HTML mockup 比稿:產出 2 到 3 個設計立場不同的變體(密度 / 版式 / 強調軸,不是換色),各附取捨說明,最後給有立場的對比結論。適用:「畫個草圖」「比較 A 版 B 版」「先看方向再做」「給我看幾種做法」。要 production 元件或設計已定案時不適用。
tools
需求不明時的意圖萃取訪談:一次一題、每題附上自己的猜測、聽出「真正想要 vs 覺得應該要」,直到能預測使用者反應(約 95% 信心)才動工。適用:需求缺少對象 / 動機 / 成功標準 / 約束,或使用者點名「訪談我」「先確認一下」「我們確定嗎」。明確自足的指示、純資訊查詢、機械性操作不適用。
development
對非平凡決策啟動新鮮 context 對抗審查(找碴不背書),在修正還便宜的時候抓出錯誤方向。適用:高風險改動(production、資安敏感邏輯、不可逆操作)、不熟的程式碼、要宣稱「這樣是安全的 / 可行的」之前。機械性操作與一行修改不適用。
testing
Reference for writing and editing agent skills well — the vocabulary and principles that make a skill predictable. Consult when authoring, reviewing, or pruning a SKILL.md.