review-docs

review-docs is a skill for Claude Code, Codex from HuntsDesk/ve-kit. It costs 35 tokens per session (1,248 once invoked), scanned A, original, MIT.

An audit of a project's documentation folder and its main index.

In plain words
What is it for?
Use it to check documentation after features or infrastructure change, before onboarding teammates, or during a regular maintenance review.
Why use it?
It finds broken links, missing entries, duplicate explanations, outdated information, and documents that have become too large. It records each finding as a task on a project board.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/huntsdesk/ve-kit/review-docs
Any agent
npx skills add HuntsDesk/ve-kit --skill review-docs
Clone the repo
git clone --depth 1 https://github.com/HuntsDesk/ve-kit

Made for: Claude Code, Codex.

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.

agentmods badge for review-docs

README.md
[![agentmods](https://agentmods.dev/badge/skills/huntsdesk/ve-kit/review-docs.svg)](https://agentmods.dev/skills/huntsdesk/ve-kit/review-docs)
Your own site
<a href="https://agentmods.dev/skills/huntsdesk/ve-kit/review-docs"><img src="https://agentmods.dev/badge/skills/huntsdesk/ve-kit/review-docs.svg" alt="Measured on agentmods" height="20"></a>
Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,248 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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.

ModelPer sessionOnce invoked
Fable 5 $0.00035 $0.01248
Opus 5 $0.00017 $0.00624
Sonnet 5 $0.00007 $0.00250
Haiku 4.5 $0.00003 $0.00125

Measured 5d ago against content hash 9d5735805d4d, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

review-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 5d 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.

skills/review-docs/SKILL.md · 144 lines

How it starts

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

Docs Review Protocol

Reviews the project documentation tree at docs/**/*.md plus the master index at docs/README.md.

Part of the review-* skill family. Cites ../_shared/review-checklist.md.

Owner: docs-manager agent.

When to invoke

  • After multiple features ship without doc updates
  • Quarterly audit
  • Before a new team member onboards
  • After significant infrastructure changes (service migrations, architecture shifts)

Output contract

Board tasks only. Lean summary to main agent.


Step 1 — Inventory

  • Glob docs/**/*.md (excluding archive/ and code-backup/)
  • Record: file path, line count, last git commit date (via git log -1 --format=%cs -- <file>)
  • Parse docs/README.md — extract every link and match to actual file

Step 2 — Index currency

For docs/README.md:

  • Every top-level doc mentioned? (Glob docs/*/README.md + docs/*.md)
  • Every link resolves (no broken paths)?
  • Any docs in docs/ not referenced from the README?
  • Order/tier still accurate?

Flag:

  • Orphaned docs (exist but unlisted)
  • Dead links (listed but file missing)
  • README section headers out of date

For each doc file, check every markdown link [text](path):

  • Relative paths resolve
  • External URLs still reachable (spot-check; full check is expensive — skip unless asked)
  • Cross-repo links (pointing to CLAUDE.md, .claude/rules/, services/) resolve
  • Line-anchor links (#L42) valid

Step 4 — Staleness

For each doc, flag:

  • Last commit > 9 months ago + file still referenced as "current" / "primary" (likely stale)
  • References to Supabase Edge Functions (retired 2026-02-24)
  • References to retired services, tables, or domains
  • "Last updated" markers that are older than 6 months if the file implies ongoing currency
  • Model ID references (should be Opus 5 / Fable 5 / Sonnet 5 / Haiku 4.5)
  • Deprecated Claude Code commands
  • Stripe API version mismatch (currently 2026-04-22.dahlia)

Read the full file on GitHub · 144 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.

  1. 5d ago First seen · 144 lines · 35 tokens per session scan A 9d5735805d4d

Subscribe to this mod's changes

review-docs is a skill published in the GitHub repository HuntsDesk/ve-kit (2 stars, last pushed 29d ago), licensed MIT. It adds 35 tokens to every session and 1,248 once invoked, about $0.0002 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-31.

Related

Other skills, from other repositories

tmux

Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.

HKUDS/nanobot · 22 tokens

summarize

Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).

HKUDS/nanobot · 32 tokens

complete-partial-pr

Evaluate and complete an issue or PR where the submitted patch fixes only a narrow symptom of the reported pain point. Use when a contribution may miss adjacent integration surfaces, provider/spec semantics, roundtrip behavior, tests, docs, or historical maintainer decisions.

pydantic/pydantic-ai · 55 tokens

foundry-config-setup

Resolve missing setup caused by a hardcoded Foundry project endpoint or model in a sample. Use when a sample fails because it uses a placeholder/hardcoded projectendpoint (for example "https://your-project.services.ai.azure.com") or a hardcoded model instead of reading them from the environment.

microsoft/agent-framework · 65 tokens

hive.chart-creation-foundations

Required reading whenever any chart tool is available. Teaches the one-tool embedding contract (call chartrender → live chart appears in chat AND a downloadable PNG lands in the queen session dir), the ECharts (data viz) vs Mermaid (structural diagrams) decision, the BI/financial-grade aesthetic baseline (no…

aden-hive/hive · 133 tokens

browser-edge-cases

SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.

aden-hive/hive · 40 tokens