WEB DEVELOPMENT / JetBrains
VitePress
Documentation-site guidance for VitePress: .vitepress configuration, file-based routing and rewrites, Markdown extensions, Vue components inside Markdown, build-time data loaders, dynamic routes, theming, internationalization, SSR compatibility, and deployment recipes.
“VitePress static site generator powered by Vite and Vue. Use when building documentation sites, configuring themes, or writing Markdown with Vue components.”
01 / THE REASONING
Why this made the selection.
- Covers the documentation-site generator end to end — config, file-based routing, Markdown containers and includes, Vue-in-Markdown, data loaders, dynamic routes — each routed to its own reference file.
- Includes the operational topics docs sites actually need: deployment recipes for GitHub Pages, Netlify, Vercel, Cloudflare and Nginx, locale configuration for multi-language sites, and SSR compatibility via ClientOnly and dynamic imports.
- Generated from the official vuejs/vitepress manual by a Vite core-team author, so the reference tree tracks upstream documentation rather than blog folklore.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- vitepress/SKILL.md (JetBrains mirror)
- vitepress/references directory listing (14 files)
- upstream antfu/skills skills/vitepress/SKILL.md
- upstream LICENSE.md
- JetBrains/skills README mirror policy
Our findings
- All 14 reference links resolve to files present in the mirror's references directory, verified against the listing.
- Front matter credits antfu/skills generated from vuejs/vitepress; the mirror snapshot is VitePress 1.x (2026-01-28) while upstream has regenerated against 2.0.0-alpha.20.
- The theme section separates theme configuration, customization of the default theme, and building a custom theme from scratch — three distinct jobs that generic docs guidance conflates.
Not established by this review
- No documentation site was built or deployed with this skill.
- Deployment recipes were read, not exercised against any host.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
DOCUMENTED COMMAND
npx skills add JetBrains/skills/vitepress --skill vitepressRun in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.
Optional: install the reviewed revision
Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.
npx skills add https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress --skill vitepress- Install the complete skill directory with its references.
- Bring the existing .vitepress directory or the content plan for the new site.
Before you start
- Node.js/npm for the installer
- An agent that supports the Agent Skills format
- A VitePress project or planned documentation site
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress/SKILL.md
Supports: summary, upstreamDescription, whySelected, bestFor, limitations, review, access
https://github.com/JetBrains/skills/tree/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/vitepress/references
Supports: review, whySelected
https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/skills/vitepress/SKILL.md
Supports: review, limitations
- Upstream license (MIT) ↗Checked
https://github.com/antfu/skills/blob/e53a142a2420e8cd812cfe9ed0484ab01bc856aa/LICENSE.md
Supports: license
https://github.com/JetBrains/skills/blob/e0f258b5cfed145015cb3e48da9a97947f7c4ed7/README.md
Supports: review, install, limitations
https://github.com/vercel-labs/skills/blob/7407f3893ad4dceab546ac002c3ef806e4000c73/README.md
Supports: install