documentation-expert — Claude Code subagent: what it does, install
This subagent creates, updates, and maintains project documentation, from README files to API references. Use it when docs need structure or a refresh.
npx claude-code-templates@latest --agent expert-advisors/documentation-expertWhat documentation-expert does
documentation-expert handles technical documentation for software projects. It can draft or revise README, CONTRIBUTING, and USAGE files, document new features and APIs, write tutorials and user guides, and turn code comments into documentation.
Its available tools are Read, Write, Edit, Glob, Grep, WebFetch, and WebSearch. The workflow uses the Diátaxis model to distinguish tutorials, how-to guides, reference material, and explanations. It also treats docs like code by checking links, keeping docs with the code, and reviewing documentation changes alongside source changes.
The subagent has no Bash, so it cannot run Vale, alex, or markdownlint itself. Code behavior is handed off to code-reviewer or architect-reviewer, while Docusaurus configuration work belongs with docusaurus-expert.
What it helps with
- draft a README for a project or feature
- refresh outdated API documentation
- turn code comments into usable docs
- write a tutorial or user guide
- check documentation structure and links
Example prompts for the agent
- Use the
documentation-expertsubagent to create a README for this project. - Ask
documentation-expertto update the new API reference and align it with the repository structure. - Have
documentation-expertwrite a guide for this feature from the code and current documentation.
How to install documentation-expert
1claude-code-templates
npx claude-code-templates@latest --agent expert-advisors/documentation-expert2Manually: put the files in place
.claude/agents/documentation-expert.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/documentation-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/documentation-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 documentation-expert
How do I install documentation-expert in Claude Code?
Run npx claude-code-templates@latest --agent expert-advisors/documentation-expert, then use .claude/agents/documentation-expert.md.
What does documentation-expert do?
It creates, edits, and maintains project documentation, including README files, API references, tutorials, user guides, and code-based documentation. It can also organize content with the Diátaxis framework.
Can documentation-expert run documentation linters itself?
No. It has no Bash tool, so it can recommend Vale, alex, and markdownlint checks but cannot execute them.
