What files does this skill specifically review?

It focuses primarily on README.md and CLAUDE.md files across your repository root or specific component subdirectories.

Does it support structural validation?

Yes, it uses a deterministic validation script to check for missing tables, index drift, broken @path imports, and leaked local preferences.

How does it detect documentation drift?

It cross-references lists in your docs—like environment variables, agents, or database tables—against the actual source code to find missing or stale items.

Can it automatically create tasks for found issues?

Yes, using the --create-beads flag, it can generate tracked tasks for every new documentation issue it discovers.

Why does it place so much emphasis on CLAUDE.md?

CLAUDE.md files serve as critical navigation maps for AI agents; this skill ensures they provide the right level of detail for efficient context loading.

Documentation Quality Auditor

Name: Documentation Quality Auditor
Author: lumberbarons

bylumberbarons

0•

Learning & Documentation

Audits and improves project documentation by validating README and CLAUDE.md files against high-quality navigation and content patterns.

The review-docs skill is a comprehensive utility for maintaining technical documentation within Claude Code environments. It performs deep structural validation of CLAUDE.md files, ensures README files adhere to progressive disclosure patterns, and cross-references documentation enumerations—such as environment variables or API endpoints—against the codebase to prevent documentation drift. By identifying 'hidden knowledge' and validating the efficacy of quick-start guides, it ensures project onboarding is seamless for both human developers and AI agents.

Key Features

01Enumeration completeness checks to sync documentation with codebase reality

02Progressive disclosure auditing to ensure architectural detail is correctly placed

03Deterministic validation of CLAUDE.md structure and navigation indexes

04Integrated bead creation for tracking documentation issues as actionable tasks

05Automated 'hidden knowledge' detection for prerequisites and platform differences

060 GitHub stars

Use Cases

01Auditing a repository's documentation during initial onboarding or migration

02Standardizing navigation patterns and tabular indexes across large monorepos

03Validating that new features or environment variables are accurately reflected in the docs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lumberbarons/lumber-mart review-docs

For use in Claude.ai and ChatGPT

Download Skill