What problem does it solve? Setting up an MDX docs site involves choosing an engine, configuring search, sidebars, and plugins, and migrating existing Markdown content — each with non-obvious pitfalls like broken container directives, dead-link build failures, and missing dev-server search. This Skill captures a validated Rspress setup so you avoid rediscovering these gotchas. ## Core Features & Use Cases - Engine Routing: Detects whether a repo uses Rspress (rspress.config.*) or mkdocs (mkdocs.yml) and applies the matching documentation approach. - Rspress Scaffolding: Non-interactive project creation, minimal config with mermaid plugin, auto-generated sidebars, and GitHub Pages deployment of the doc_build/ output. - mkdocs-to-MDX Migration: One-off transform rules for frontmatter titles, admonitions to container directives, content tabs, internal link rewriting, and image paths. - Use Case: You want interactive React components embedded in your project docs. Use this Skill to scaffold a Rspress site, port existing mkdocs Markdown pages, and deploy to GitHub Pages with working dev-server search. ## Quick Start Scaffold a new Rspress MDX docs site in the docs directory and configure it with mermaid support and GitHub Pages deployment.
