docusaurus-expert — Claude Code subagent: what it does, how to install
Configures and fixes Docusaurus v2 and v3 documentation sites. Handles config files, sidebar trees, MDX layouts, and build errors.
npx claude-code-templates@latest --agent documentation/docusaurus-expertWhat docusaurus-expert does
This subagent handles maintenance for Docusaurus documentation projects. Using file operations and Bash commands, it inspects your repository paths, validates docusaurus.config.js or docusaurus.config.ts, and checks plugin setups. It groups fixes by problem area.
For documentation content, the agent organizes sidebar trees in sidebars.js and standardizes MDX metadata. It enforces kebab-case naming for files and checks frontmatter values like sidebar_position. Broken internal links are flagged early.
When builds fail, the agent inspects npm run build logs to identify syntax bugs or broken dependencies. Fixes are applied directly to project files. The project requires Node.js 14.0.0 or higher to run Docusaurus commands without runtime crashes.
What it helps with
- fix syntax issues in
docusaurus.config.js - reorganize navigation in
sidebars.js - troubleshoot failing
npm run buildruns - standardize frontmatter across MDX files
Example prompts for the agent
- Inspect my Docusaurus project and fix the broken build
- Reorganize the sidebar categories in
sidebars.js - Check frontmatter tags across all files in the docs folder
How to install docusaurus-expert
1claude-code-templates
npx claude-code-templates@latest --agent documentation/docusaurus-expert2Manually: put the files in place
.claude/agents/docusaurus-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/docusaurus-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/docusaurus-expert.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about docusaurus-expert
How to install docusaurus-expert in Claude Code?
Run npx claude-code-templates@latest --agent documentation/docusaurus-expert. The agent specification will be placed in .claude/agents/docusaurus-expert.md.
What does docusaurus-expert do?
It automates configuration, theming, and content structure for Docusaurus sites. It edits config files, tests builds, and adjusts MDX frontmatter.
What environment requirements does it expect?
It is designed for Docusaurus v2 and v3 setups. The project environment must have Node.js 14.0.0 or higher installed.
