codebase-audit

Extract and falsify documentation claims against codebase evidence.

1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/tomwangowa/agent-skills --skill codebase-audit-tomwangowa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-audit
Source: https://github.com/tomwangowa/agent-skills/tree/main/codebase-audit
Command: npx skills add https://github.com/tomwangowa/agent-skills --skill codebase-audit-tomwangowa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill ensures that the claims made in your project's documentation accurately reflect the actual codebase, preventing discrepancies that lead to confusion and errors.

Core Features & Use Cases

  • Claim Extraction: Identifies and extracts all verifiable claims from specified documentation files (e.g., README, CLAUDE.md, JSDoc).
  • Falsification-First Verification: Systematically attempts to disprove each claim by searching the codebase for counter-evidence before looking for supporting evidence.
  • Use Case: After updating your project's README, use this Skill to automatically verify that all stated features, setup instructions, and behavioral descriptions are still accurate according to the current code.

Quick Start

Audit the README.md file against the current codebase.

Frequently Asked Questions about codebase-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I verify that my README documentation matches the actual codebase?

To verify README documentation matches a codebase, perform a claims-first audit that extracts verifiable statements and systematically attempts to falsify them using static analysis and test evidence. This process identifies discrepancies between documented features and actual code behavior.

What is a falsification-first approach for checking code against documentation?

A falsification-first approach for checking code against documentation attempts to disprove each extracted claim by searching the codebase for counter-evidence before looking for supporting evidence. This method prioritizes finding documentation inaccuracies and inconsistencies over simple validation.

Can I automatically extract and verify technical claims from JSDoc comments?

You can automatically extract and verify technical claims from JSDoc comments by running a claims-first audit. The process identifies verifiable claims from specified documentation files and uses dependency tracing and runtime probes to confirm accuracy against the current code.

What's the best way to audit setup instructions in project documentation against source code?

The best way to audit setup instructions against source code is to run an automated claims extraction and falsification process. This systematically verifies stated features and behavioral descriptions by probing the codebase for counter-evidence, generating a detailed remediation report for discrepancies.

Does a codebase audit work for identifying technical debt from outdated documentation?

A codebase audit works for identifying technical debt from outdated documentation by systematically tracing dependencies and probing runtime behavior to falsify documented claims. It categorizes extracted statements and highlights inconsistencies, directly exposing documentation drift and technical debt.

What types of evidence are used to disprove documentation claims during a code audit?

Documentation claims are disproved during a code audit using static analysis, test evidence, runtime probes, and dependency tracing. The falsification-first methodology searches the codebase for counter-evidence against extracted claims before validating supporting evidence to ensure accuracy.