# documentation-expert

This subagent creates, updates, and maintains project documentation, from README files to API references. Use it when docs need structure or a refresh.

- subagent · `type=agent` · Claude Code · 6992 installs
- Author: davila7
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/expert-advisors/documentation-expert.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/agents/documentation-expert

## What it 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`.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --agent expert-advisors/documentation-expert
```

2. **Manually: put the files in place**
- File: `.claude/agents/documentation-expert.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/documentation-expert.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/documentation-expert.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/expert-advisors/documentation-expert.md

## When to use it
- 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
- Use the `documentation-expert` subagent to create a README for this project.
- Ask `documentation-expert` to update the new API reference and align it with the repository structure.
- Have `documentation-expert` write a guide for this feature from the code and current documentation.

## Similar
- [prompt-engineer](https://affpapa.org/en/nevibecode/agents/voltagent-community-prompt-engineer.md) — subagent · 16078 installs
- [context-manager](https://affpapa.org/en/nevibecode/agents/context-manager.md) — subagent · 10638 installs
- [code-explorer](https://affpapa.org/en/nevibecode/agents/code-explorer.md) — subagent · 1172 installs
- [search-specialist](https://affpapa.org/en/nevibecode/agents/search-specialist.md) — subagent · 6886 installs
- [api-documenter](https://affpapa.org/en/nevibecode/agents/api-documenter.md) — subagent · 6451 installs
- [technical-writer](https://affpapa.org/en/nevibecode/agents/technical-writer.md) — subagent · 4345 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 224 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md