Does this skill fix the documentation automatically?

No, this is a 'primitive' skill designed for investigation and reporting. You should use the /fix-docs skill to automatically resolve the issues identified by this audit.

Can it detect missing environment variables?

Yes, it scans your source code for process.env calls and compares them against your .env.example file to highlight any undocumented variables.

How does it identify stale documentation?

The skill checks the filesystem modification dates for Markdown files; any core documentation not updated within the last 90 days is flagged as potentially stale.

Does it support framework-specific checks?

Yes, it includes specialized checks for Next.js projects, verifying App Router conventions and RSC vs client component documentation.

Project Documentation Auditor

Name: Project Documentation Auditor
Author: phrazzld

byphrazzld

•

Learning & Documentation

Audits project documentation for completeness, accuracy, and staleness to ensure a high-quality developer experience.

The Project Documentation Auditor is a specialized skill designed to maintain the health of your codebase's internal and external documentation. It performs deep scans for essential files like READMEs, architecture guides, and environment variable examples, while also identifying undocumented variables used in source code. By detecting stale content and verifying consistency across authentication systems, this skill generates prioritized reports (P0-P3) that help maintainers quickly identify critical gaps that block onboarding or production readiness.

Key Features

01Automated audits for required files like README.md, CONTRIBUTING.md, and .env.example

02Environment variable coverage analysis comparing source code to documentation

03Prioritized reporting from P0 (Critical) to P3 (Nice to Have) for actionable insights

045 GitHub stars

05Authentication system consistency checks to prevent legacy provider references

06Staleness detection for documentation files older than 90 days

Use Cases

01Auditing legacy codebases for outdated architectural references and broken links

02Preparing a repository for open-source release by ensuring all setup guides are present

03Verifying that all environment variables used in a Next.js app are documented in .env.example

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add phrazzld/claude-config check-docs

For use in Claude.ai and ChatGPT

Download Skill