Agent skill

Doc Review

by YougLin-dev in YougLin-dev/Aha-Loop

Reviews and cleans up outdated documentation. An agent skill from YougLin-dev/Aha-Loop.

MITAuto-check passedDevelopment

Install Doc Review

skills CLI
$ npx skills add YougLin-dev/Aha-Loop --skill doc-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install YougLin-dev/Aha-Loop doc-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/YougLin-dev/Aha-Loop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/doc-review .claude/skills/doc-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
doc-review
GitHub stars
181
Token cost
~1.5k tokens
SKILL.md length
360 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Reviews and cleans up outdated documentation. An agent skill from YougLin-dev/Aha-Loop.

  • Works in 5 steps: Inventory Documentation → Check Staleness Indicators → Verify Code References → …
  • Clean up documentation
  • SKILL.md covers The Job, When to Use, Review Process and Staleness Criteria, plus 5 more sections
  • Calls curl and git

What it does

Doc Review is an agent skill from YougLin-dev/Aha-Loop. Reviews and cleans up outdated documentation. Use periodically to maintain documentation health. Triggers on: review docs, clean up documentation, check for stale docs.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: [MVP] Aha Loop is a fully autonomous AI development system, extended from the core ideas of Ralph. It's not just an execution engine, but a complete AI development framework with… The licence is MIT.

When your agent uses it

  • Clean up documentation
  • Check for stale docs

Example prompts

  • “Use the doc-review skill to review and cleans up outdated documentation. An agent skill from YougLin-dev/Aha-Loop”
  • “/doc-review”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Inventory Documentation
  2. Check Staleness Indicators
  3. Verify Code References
  4. Check External Links
  5. Generate Report

What it can do on your machine

Read from SKILL.md and the folder at commit 8d799b2. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Doc Review loads about 1.5k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 360 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from YougLin-dev/Aha-Loop at commit 8d799b2, republished under its MIT licence (© YougLin-dev). 360 words, ~1,477 tokens.

Download SKILL.mdSave it as .claude/skills/doc-review/SKILL.md (or your agent's skills folder).
name
doc-review
description
Reviews and cleans up outdated documentation. Use periodically to maintain documentation health. Triggers on: review docs, clean up documentation, check for stale docs.

Doc Review Skill

Systematically review documentation for staleness, accuracy, and relevance.


The Job

  1. Scan all documentation files
  2. Check for staleness indicators
  3. Verify referenced code/files still exist
  4. Identify outdated content
  5. Generate cleanup report
  6. Optionally apply fixes

When to Use

Scheduled
  • After each milestone completion
  • Monthly maintenance cycle
  • Before major releases
On Demand
  • When documentation feels outdated
  • After significant refactoring
  • When onboarding reveals confusion

Review Process

Step 1: Inventory Documentation

Scan for documentation files:

bash
find . -name "*.md" -not -path "./.git/*" -not -path "./.vendor/*" -not -path "./.worktrees/*"

Common locations:

  • README.md (root and subdirs)
  • docs/ directory
  • AGENTS.md, CLAUDE.md
  • .claude/skills/*/SKILL.md
  • knowledge/ directory
  • scripts/aha-loop/templates/
Step 2: Check Staleness Indicators

For each document, check:

IndicatorCheck MethodThreshold
Last modifiedgit log -1> 30 days
Referenced filesgrep + verifyMissing = stale
Code examplesSyntax checkErrors = stale
Version numbersCompare to actualMismatch = stale
LinksHTTP checkBroken = stale
Step 3: Verify Code References

For each code reference in docs:

markdown
## Code Reference Check

File: [doc-path]
Reference: `src/main.rs:45-60`
Status: [Exists | Missing | Changed]

If Changed:
- Original: [what doc says]
- Current: [what code shows]
- Action: [Update doc | Flag for review]
bash
# Extract URLs
grep -oP 'https?://[^\s)]+' file.md

# Check each URL
curl -s -o /dev/null -w "%{http_code}" URL
Step 5: Generate Report

Create docs-review-report.md:

markdown
# Documentation Review Report

**Date:** [YYYY-MM-DD]
**Reviewed:** [N] files
**Issues Found:** [N]

## Summary

| Category | Count |
|----------|-------|
| Stale (>30 days) | [N] |
| Missing References | [N] |
| Broken Links | [N] |
| Outdated Examples | [N] |

## Issues by File

### [file1.md]
- [ ] Line 45: Reference to `src/old.rs` - file no longer exists
- [ ] Line 78: Code example uses deprecated API

### [file2.md]
- [ ] Line 12: Version "1.0.0" should be "2.0.0"
- [ ] Line 56: Broken link to external docs

## Recommended Actions

1. **Delete:** [files that should be removed]
2. **Update:** [files that need content updates]
3. **Review:** [files that need human review]

## Auto-fixable

The following can be auto-fixed:
- [ ] Update version numbers
- [ ] Remove dead links
- [ ] Update file paths

Run `./scripts/aha-loop/doc-cleaner.sh --fix` to apply.

Staleness Criteria

Definitely Stale
  • References files that don't exist
  • Contains code that doesn't compile
  • Links to 404 pages
  • Describes features that were removed
Probably Stale
  • Not modified in 60+ days
  • Uses old API patterns
  • References old version numbers
  • No recent git commits mention the file
Needs Human Review
  • Contains outdated but complex content
  • Describes deprecated but still-supported features
  • Historical documentation (changelogs, decisions)

Show full SKILL.md (140 more words)Show less

Auto-Fix Rules

Safe to Auto-Fix
  • Update file paths (if clear mapping exists)
  • Remove broken external links
  • Update version numbers in dependency lists
  • Fix obvious typos in code references
Requires Human Review
  • Content changes beyond mechanical updates
  • Removing entire sections
  • Changing technical instructions
  • Modifying architecture decisions

Integration

With Doc Cleaner Script
bash
# Generate report only
./scripts/aha-loop/doc-cleaner.sh --report

# Apply safe fixes
./scripts/aha-loop/doc-cleaner.sh --fix

# Interactive mode
./scripts/aha-loop/doc-cleaner.sh --interactive
With Observability

Log review activities:

markdown
## 2026-01-29 16:00:00 | Task: Maintenance | Phase: Doc Review

### Documentation Review
Scanned 45 files, found 7 issues.

### Key Findings
- AGENTS.md references outdated skill paths
- README example code uses deprecated API

### Actions Taken
- Auto-fixed 3 version number issues
- Flagged 4 items for human review

Checklist

Before completing review:

  • All markdown files scanned
  • Code references verified
  • External links checked
  • Report generated
  • Auto-fixes applied (if safe)
  • Human review items flagged

Example Review

Input

File: docs/api.md last modified 90 days ago

markdown
# API Documentation

## Authentication

See `src/auth/mod.rs` for implementation.

Use version 0.5.0 of the auth library:
```toml
auth-lib = "0.5.0"

More info: https://example.com/old-docs


### Review Findings

1. **Stale**: Last modified 90 days ago
2. **Missing Reference**: `src/auth/mod.rs` doesn't exist (moved to `src/api/auth.rs`)
3. **Outdated Version**: Current version is 1.2.0, not 0.5.0
4. **Broken Link**: https://example.com/old-docs returns 404

### Report Entry

```markdown
### docs/api.md

**Staleness:** 90 days since last update
**Issues:**
- [ ] Line 5: `src/auth/mod.rs` → `src/api/auth.rs`
- [ ] Line 8: Version 0.5.0 → 1.2.0
- [ ] Line 12: Broken link (404)

**Recommendation:** Update file paths and versions, remove broken link

Prevention

To reduce future staleness:

  1. Update docs with code - When changing code, update related docs
  2. Add doc checks to CI - Fail on broken references
  3. Schedule regular reviews - Monthly or per-milestone
  4. Use relative links - Easier to maintain than absolute
  5. Date-stamp examples - "As of v1.2.0"

© YougLin-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/doc-review of YougLin-dev/Aha-Loop.

Open the folder on GitHubat commit 8d799b2

Compare with similar skills

Doc Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Doc Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Doc Review this skillYougLin-dev/Aha-Loop181—~1.5kAutomated safety check: PassMIT
Vercel Composition Patternssupabase/supabase111k59 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 59 repos~726 tokens
    DevelopmentAuto-check passed
  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from YougLin-dev/Aha-Loop

All 15 skills in this repo
  • God Member

    YougLin-dev/Aha-Loop

    Defines God Committee member behavior and responsibilities with oversight authority.

    181 GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Architect

    YougLin-dev/Aha-Loop

    Designs system architecture and selects technology stack based on vision analysis.

    181 GitHub stars~2.2k tokensUpdated 8 mo ago
    Auto-check passed
  • God Consensus

    YougLin-dev/Aha-Loop

    Guides God Committee members through consensus-building for collective decisions.

    181 GitHub stars~2k tokensUpdated 8 mo ago
    Auto-check passed
  • God Intervention

    YougLin-dev/Aha-Loop

    Guides God Committee members through executing interventions.

    181 GitHub stars~2.3k tokensUpdated 8 mo ago
    Auto-check passed
  • Parallel Explore

    YougLin-dev/Aha-Loop

    Guides parallel exploration of multiple implementation approaches using git worktrees.

    181 GitHub stars~1.9k tokensUpdated 8 mo ago
    Auto-check passed
  • Plan Review

    YougLin-dev/Aha-Loop

    Reviews and adjusts PRD plans based on research findings. An agent skill from YougLin-dev/Aha-Loop.

    181 GitHub stars~1.8k tokensUpdated 8 mo ago
    Auto-check passed

Categories

Questions about Doc Review

What does Doc Review do?

Reviews and cleans up outdated documentation. An agent skill from YougLin-dev/Aha-Loop. Doc Review is an agent skill from YougLin-dev/Aha-Loop. Reviews and cleans up outdated documentation.

When should I use Doc Review?

Doc Review fits situations like: clean up documentation; check for stale docs.

How do I install Doc Review in Claude Code?

Run `npx skills add YougLin-dev/Aha-Loop --skill doc-review -a claude-code`. Or copy the skill folder (.agents/skills/doc-review in YougLin-dev/Aha-Loop) into .claude/skills/doc-review in your project. Claude Code loads it when a task matches its description.

How do I install Doc Review in Codex?

Run `npx skills add YougLin-dev/Aha-Loop --skill doc-review -a codex`. Or copy the skill folder (.agents/skills/doc-review in YougLin-dev/Aha-Loop) into .agents/skills/doc-review in your project. Codex loads it when a task matches its description.

Can I use Doc Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add YougLin-dev/Aha-Loop --skill doc-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/doc-review, .gemini/skills/doc-review, .github/skills/doc-review and .opencode/skills/doc-review in your project.

What does Doc Review need to run?

Going by SKILL.md and its folder, Doc Review needs the command-line tools its instructions call (curl and git).

Does Doc Review access the network?

SKILL.md contains no URLs. Its commands use curl and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Doc Review safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Doc Review use?

Doc Review is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Doc Review use?

About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Doc Review?

Skills that share tags, products or a category with Doc Review: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Doc Review?

YougLin-dev (a GitHub user) maintains it in YougLin-dev/Aha-Loop, which has 181 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on February 3, 2026.

Source: YougLin-dev/Aha-Loop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.