Can it verify the fixes it makes?

Yes, after applying fixes, it runs validation tools like shellcheck, terraform fmt, and XML parsers to ensure all modified files remain valid and functional.

What files does the Factcheck Docs skill audit?

It specifically targets README.md, CLAUDE.md, SVG diagrams, and skill definitions, comparing them against the project's source code.

How does it handle visual diagrams?

It uses the Playwright MCP to render SVGs in a real browser environment, taking screenshots to detect layout issues like overlapping text or clipping that XML validation might miss.

Does it automatically modify my documentation?

No, it follows a multi-phase process where it first presents a report of findings in a table and asks for your confirmation before applying any changes.

Why does it distinguish between README.md and CLAUDE.md?

It treats README.md as a guide for human users and CLAUDE.md as a technical reference for AI assistants, ensuring each contains the appropriate level of detail without duplication.

Factcheck Docs

Name: Factcheck Docs
Author: matthewdeaves

bymatthewdeaves

•

学習とドキュメンテーション

Audits and synchronizes project documentation with the source code to eliminate stale, inaccurate, or bloated information.

Factcheck Docs is a specialized maintenance skill for Claude Code designed to maintain high-fidelity documentation. It performs deep audits of project artifacts including README.md, CLAUDE.md, and SVG architecture diagrams by cross-referencing every claim against the actual codebase. The skill identifies stale references, factual inaccuracies, and redundant 'bloat,' providing a detailed report before applying automated fixes. By utilizing Playwright for visual rendering checks of diagrams and rigorous validation scripts, it ensures your documentation remains a reliable source of truth for both human developers and AI assistants.

主な機能

011 GitHub stars

02Automated fix application with post-change verification (shellcheck, terraform fmt, etc.)

03Cross-references documentation claims against the codebase 'ground truth'

04Differentiated auditing logic for human-centric vs. AI-centric documentation

05Visual auditing of SVG diagrams using Playwright headless browser screenshots

06Categorizes issues into STALE, INACCURATE, MISSING, BLOAT, and DUPLICATE

ユースケース

01Verifying documentation accuracy after significant code refactoring or feature merges

02Auditing architecture diagrams to ensure ports, paths, and models match implementation

03Reducing documentation debt by removing unnecessary prose and redundant instructions

主な機能

011 GitHub stars

02Automated fix application with post-change verification (shellcheck, terraform fmt, etc.)

03Cross-references documentation claims against the codebase 'ground truth'

04Differentiated auditing logic for human-centric vs. AI-centric documentation

05Visual auditing of SVG diagrams using Playwright headless browser screenshots

06Categorizes issues into STALE, INACCURATE, MISSING, BLOAT, and DUPLICATE

ユースケース

01Verifying documentation accuracy after significant code refactoring or feature merges

02Auditing architecture diagrams to ensure ports, paths, and models match implementation

03Reducing documentation debt by removing unnecessary prose and redundant instructions