Rspress Docs Generator

Create and maintain Rspress documentation as part of normal project work. Prefer source-backed docs over generic prose: read the code, tests, examples, package metadata, and existing README before writing.

Use Cases

• Create a new Rspress v2 documentation site for a project that has no docs site yet.
• Update an existing Rspress v2 docs site for a user-facing feature, API change, CLI change, or PR.
• Detect Rspress v1 version markers before documentation work and hand migration to the dedicated rspress-v2-upgrade skill.
• Integrate Rspress documentation into an Rslib package or workspace while preserving the repository's package manager and scripts.

Workflow

1. Inspect the project
   • Locate package files, source entry points, examples, tests, changelogs, and README files.
   • Search for Rspress config files: rspress.config.ts, .js, .mjs, or .cjs.
   • Inspect dependencies for Rspress version markers: @rspress/core version, legacy rspress package or rspress/* imports, and @rspress/plugin-*.
   • Detect the package manager and workspace setup from lock files (pnpm-lock.yaml, yarn.lock, package-lock.json, bun.lock, bun.lockb) and pnpm-workspace.yaml.
   • If a config exists, resolve the docs root from its root option. When root is absent, inspect package scripts, CI commands, and documented commands for Rspress CLI positional roots such as rspress dev site, rspress build site, or rspress preview site; use that argument before falling back to Rspress's default docs/ directory relative to the config file's project cwd. If no config exists, check common roots such as docs/, doc/, website/, and site/.