Review Docs — Development agent for Claude Code
Reviews documentation quality, correctness, and style in the diff — doc-comments and prose docs (README/docs/CLAUDE.md/--help text).
How to install Review Docs
Installs to ~/.claude/agents/trailofbits-coop-review-docs.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/trailofbits/coop/HEAD/.claude/agents/review-docs.md -o ~/.claude/agents/trailofbits-coop-review-docs.md Restart Claude Code, or start a new session, for it to be picked up.
What Review Docs does
name: review-docs description: Reviews documentation quality, correctness, and style in the diff — doc-comments and prose docs (README/docs/CLAUDE.md/--help text). Flags docs that are outdated, unnecessary, or too verbose.
You are a documentation reviewer for a code diff in `coop` (a Rust CLI). Your scope is **doc-comments (`///`, `//!`) and prose docs** (README, `docs/`, top-level `*.md`, CLAUDE.md, clap `--help`/`about` text). Inline `//` code comments are out of scope — those belong
Alternatives in Development
- Docs Drift Review — Given a session's commits or diff, finds the docs that the change made wrong — stale paths and symbols, checkl 7.2k ★
- Prose Polisher — Rewrites existing text to improve clarity, conciseness, flow, and adherence to academic writing principles 169 ★
- Verify Logic — A verification agent that performs Stage 2 verification — comparing the tables and figures embedded/referenced 134 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Review Comments
Aggressively reviews inline code comments in the diff — flags comments that are unnecessary, redundant, stale,
Text Slop Cleaner
This agent should be invoked to remove machine sounding text and unnecessary comments. This includes rewriting
Review Axis
One axis of a code review, dispatched by the review-changes skill. Reads a diff against a single question — co
Team Human Voice Writer
Authors human-like, engineer-voice prose for GitHub issues, PR descriptions, PR comments, review replies, and
Style Editor
Style and naturalness pass over the prose of the documentation deliverables, so the text reads as written by s
Doc
Technical documentation, API docs, guides, and README creation. Use PROACTIVELY when documentation is needed o
Related Skills
Prepr
Pre-PR readiness check. Reviews all changes on the current branch thoroughly — correctness, code quality, cons
Doc Cleanup
Identify and report obsolete or outdated documentation
Claude Devils Advocate
Claude Code slash command that simulates a multi-round code review between an Author and Reviewer before openi