A read-only review of documentation files that checks for repeated content, outdated information, language problems, and unnecessary length. It produces a report instead of changing the files.

Use it to inventory Markdown documentation, compare sections for overlap, detect repeated technical definitions, and create an actionable cleanup report.

It shows where documentation is duplicated, inconsistent, stale, unclear, or too verbose, so you know what needs attention.

How DGouron/review-flow configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to DGouron/review-flow. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/DGouron/review-flow/master/.claude/skills/audit-docs/SKILL.md

Clone the repo

git clone --depth 1 https://github.com/DGouron/review-flow

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/dgouron/review-flow/audit-docs.svg)](https://agentmods.dev/skills/dgouron/review-flow/audit-docs)

Your own site

<a href="https://agentmods.dev/skills/dgouron/review-flow/audit-docs"><img src="https://agentmods.dev/badge/skills/dgouron/review-flow/audit-docs.svg" alt="Measured on agentmods" height="20"></a>

Per session 27 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,005 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00027	$0.01005
Opus 5	$0.00014	$0.00502
Sonnet 5	$0.00005	$0.00201
Haiku 4.5	$0.00003	$0.00101

Measured 7d ago against content hash b8c225ca2a8a, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

audit-docs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/audit-docs/SKILL.md · 149 lines

How it starts

The opening of the file, as written. The whole thing — 149 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Audit Documentation

Activation

This skill activates for:

Checking documentation quality
Detecting duplicates, stale docs, inconsistencies
/audit-docs

Persona

Read .claude/roles/documentalist.md — adopt this profile and follow all its rules.

Mode

READ-ONLY. This skill analyzes and reports. It does not modify any file.

Workflow — 5 Audit Passes

Pass 1: Inventory

Glob docs/**/*.md
Glob templates/**/*.md

For each file, extract:

Title (H1 or frontmatter title)
Frontmatter present? (yes/no)
Headings H2/H3
Detected language
Approximate word count

Produce an inventory table.

Pass 2: Duplicate Detection

Compare H2/H3 headings across all file pairs:

Title overlap: if two docs share > 40% of their H2/H3, flag them
Similar content: for flagged pairs, compare the first 100 words of each section
Duplicate markers: look for concept definitions (e.g., THREAD_RESOLVE, phase names) that appear in multiple files

Known issues to detect:

DEPLOYMENT.md vs deployment/README.md — nearly identical
PROJECT_CONFIG.md vs CONFIG-REFERENCE.md — project config overlap
Markers documented in 5+ files
Troubleshooting duplicated in 3+ files

Pass 3: Staleness Detection

Check last-updated in the frontmatter (if present)
For each related file in the frontmatter:
```
git log -1 --format=%ci <related-file>
```
If the source is more recent than last-updated, flag as potentially stale
Verify referenced paths in the doc — whether they still exist:
```
# For each src/... path mentioned in the doc
ls <path>
```
Look for references to concepts/APIs that no longer exist

Pass 4: Language Consistency

Detect French in each file. Indicators:

Frequent words: "les", "des", "une", "est", "dans", "pour", "avec", "cette", "qui", "sur"
Entire sentences in French
Titles in French

Rule: all documentation must be in English.

Pass 5: Verbosity Analysis

Read the full file on GitHub · 149 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

7d ago First seen · 149 lines · 27 tokens per session scan A b8c225ca2a8a

Subscribe to this mod's changes

audit-docs is a skill published in the GitHub repository DGouron/review-flow (42 stars, last pushed 3d ago), licensed MIT. It adds 27 tokens to every session and 1,005 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Code review Writing and docs ai automation claude clean-architecture dashboard

issue

Use when starting a chain from a GitHub issue — turning an issue URL or number into a triaged, planned, dispatched, and reviewed pull request. Classifies the thread (bug → root-cause discipline, feature → plan chain, question → drafted reply), synthesizes a spec from the issue's own acceptance criteria, then runs the…

jeremylongshore/tons-of-skills-marketplace · 115 tokens

swarm-pr-review

Run a graph-guided, tool-augmented PR review using context packing, parallel exploration, mandatory repository-agnostic risk-family coverage with dispatch scaled to diff size and risk, independent reviewer validation, critic challenge, and metrics writeback. Use for deep pull request review with low false-positive…

ZaxbyHub/opencode-swarm · 91 tokens

brooks-sweep

Full-sweep mode: runs a unified analysis across all quality dimensions — code decay, architecture, tech debt, and test quality — then applies fixes directly to the codebase. Safe changes are auto-applied; risky changes are confirmed before execution. Drawing on twelve classic engineering books. Triggers when: user…

hyhmrright/brooks-lint · 178 tokens

include-test-files-that-assert-on-behavior-being-changed-in-decl

When delegating a task affected by this skill, include.

ZaxbyHub/opencode-swarm · 29 tokens

address-review

Read PR review comments from GitHub, evaluate, address, and reply.

fpindej/netrock · 14 tokens

request-review

Dispatch a fresh reviewer agent with a clean context to critique the code after audit-code passes. The reviewer has no shared state with the coding agent and gives a genuine second opinion. Use after audit-code passes, before committing, or when user wants an independent code review.

danielvm-git/bigpowers · 56 tokens

review-flow: Skill for Claude Code