Wiki VitePress Packager
Packages generated Wiki Markdown into a browsable dark-themed VitePress site.
The skill describes generating a VitePress site under wiki-site and running npm install/docs:build; the supplied material shows no credential theft, covert exfiltration, malware, or destructive behavior. MIT licensing, the repository security policy, and read-oriented CI permissions provide some governance evidence. Deductions apply because least-privilege guidance, user confirmation, data-flow and network disclosure, rollback, dependency pinning, and dependency-security controls are absent.
The document covers the main configuration, Mermaid fixes, click-to-zoom behavior, preprocessing, build command, and known SSR/asynchronous-rendering pitfalls. Deductions apply because the snippets are not a complete runnable implementation and omit input validation, build-failure diagnosis, dependency versions, idempotence, and abnormal Markdown/Mermaid handling. No skill-specific committed execution evidence is supplied, so static calibration limits the score to 10 or below.
Activation conditions, audience scenario, and output directory are reasonably clear for packaging generated wiki Markdown into a browsable VitePress site. Deductions apply because input layout, VitePress/plugin versions, non-fit cases, platform requirements, and Chinese-language or mainland-China environment support are not specified; network reachability for npm dependencies is also undisclosed.
The SKILL.md has YAML metadata, structured sections, concrete configuration examples, known gotchas, an MIT license, and a version number. Deductions apply because it lacks installation prerequisites, a complete package.json example, parameter contracts, FAQs, changelog, explicit maintainer/update path, and compatibility matrix. The repository's Work in Progress note does not resolve these gaps.
The skill states a concrete output at wiki-site/.vitepress/dist and addresses dark theme, Mermaid readability, zoom interaction, and Markdown preprocessing, so the core objective is plausible. Deductions apply because no representative final output, build log, or complete scaffold is supplied; users must integrate and review the snippets. Static calibration caps effectiveness at 7.
The evidence includes specific SKILL.md snippets, repository README context, MIT license, security policy, CI workflows, and committed harness tests, providing limited auditability. Deductions apply because the CI and tests do not demonstrate the wiki-vitepress key paths, and no execution was performed in this review. There is no skill-specific test suite, build artifact, or independent corroboration; static calibration caps verifiability at 5.
- This is a source-only review; no installation, scripts, or VitePress build were executed. The snippets should not be treated as a verified complete implementation.
- npm install introduces external dependencies, but versions, lockfiles, network requirements, and supply-chain review are unspecified; audit and pin dependencies before restricted-network or production use.
- The zoom example copies outerHTML and attaches events without documenting keyboard accessibility, repeated initialization, cleanup, or handling of large or untrusted Markdown.
- Input-directory constraints, Chinese-content compatibility, failure recovery, and cleanup behavior are unspecified; use an isolated output directory and preserve the source Markdown first.
What it does & when to use it
This skill turns generated Wiki Markdown files into a VitePress static website. It creates the site structure, configuration, theme files, and homepage, while configuring a dark theme and interactive Mermaid diagrams. It also applies Markdown and Vue-template compatibility fixes before building. It fits developers who already have Wiki pages and need a browsable HTML documentation site.
Generates a VitePress site under wiki-site/ with .vitepress/config.mts, theme files, public/, Markdown pages, package.json, and index.md; configures dark Mermaid rendering through vitepress-plugin-mermaid; applies CSS and client-side polling fixes for Mermaid styles; adds click-to-zoom modal behavior to Mermaid diagrams; preprocesses <br/>, bare <T> generics, and YAML frontmatter; runs npm install and npm run docs:build, producing output in wiki-site/.vitepress/dist/.
- A developer needs to publish existing generated Wiki Markdown as a static documentation site.
- A user runs /deep-wiki:build or asks to package generated Wiki pages as VitePress.
- A documentation maintainer needs dark-theme Mermaid diagrams with click-to-zoom behavior.
- A documentation engineer needs page titles, descriptions, and Vue-compatible Markdown cleanup before building.
Pros & cons
- Covers the workflow from VitePress scaffolding through production build output.
- Provides a three-layer approach for dark Mermaid rendering: theme variables, CSS overrides, and inline-style replacement.
- Includes Mermaid click-to-zoom, Markdown preprocessing, and frontmatter checks.
- Published by Microsoft under the MIT license.
- Requires Node.js/npm, VitePress, and vitepress-plugin-mermaid; the source does not specify versions.
- Requires generated Wiki Markdown and does not generate the Wiki content itself.
- The source provides no independent test results or platform validation for this individual skill.
- The README presents it as part of a monorepository containing about 190 separate skills; standalone distribution is undocumented.
How to install
The repository README supports installing the skill collection with npx skills add microsoft/skills and selecting skills in the wizard. This skill is located at .github/plugins/deep-wiki/skills/wiki-vitepress/SKILL.md; the source does not document a standalone installation command.
How to use
In an agent with the skill installed, ask to “package these generated Wiki Markdown files as a VitePress site” or “build a site,” or run /deep-wiki:build. The documented build commands are: cd wiki-site && npm install && npm run docs:build.