codebase-audit

Audits codebases with parallel read-only agents and produces severity-sorted findings reports.

1|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/rockcookies/skills --skill codebase-audit-rockcookies
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-audit
Source: https://github.com/rockcookies/skills/tree/main/skills/majiayu-spellbook/codebase-audit
Command: npx skills add https://github.com/rockcookies/skills --skill codebase-audit-rockcookies

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Whole-codebase reviews are slow, shallow, and easy to get wrong: hidden bugs like silent error swallowing, registry key mismatches, and frontend-backend type drift slip through manual review, and findings from one audit are never compared against the last. This Skill runs an adaptive, multi-agent deep audit that verifies Critical/High findings adversarially and tracks issues across audits via a persistent ledger. ## Core Features & Use Cases - Adaptive parallel analysis: Detects the stack (TypeScript, Python, Rust, Go, full-stack) and dispatches 2-5 read-only finder agents across dimensions like frontend-backend contract, data integrity, error handling/security, architecture, and config/persistence, with optional test-quality and concurrency dimensions. - Adversarial verification and ledger diffing: Critical/High findings must survive a refutation pass before entering the report, and every finding is classified as new, still-open, or resolved against the previous audit's .audit/findings.json ledger. - Deterministic dependency audits: Runs cargo audit, npm audit, pip-audit, or govulncheck from the target directory and classifies CVEs by reachability. - Use Case: Ask for a full audit of a FastAPI + React project before a release; receive a severity-sorted Chinese-language report with a phased repair roadmap, a delta versus the previous audit, and a quick mode for fast health checks. ## Quick Start Ask the agent to run a full codebase audit on your project directory, or say "quick 快速体检" for a two-agent fast health check.

Frequently Asked Questions about codebase-audit

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

FAQPage Schema
How do I audit an entire codebase for hidden bugs and design issues?▼

Invoke the skill on the target directory; it detects the stack, launches 2-5 read-only finder agents across dimensions like data integrity, error handling, and architecture, then writes a severity-sorted report with a repair roadmap to audit-report-<date>.md.

What is the difference between full mode and quick mode?▼

Full mode runs 3-5 stack-adaptive agents plus an adversarial verify pass on Critical/High findings. Quick mode runs only two agents (silent degradation/security and data integrity/registry), skips verification, and labels all findings unverified.

Does the audit modify my project files?▼

No. Every agent prompt begins with a read-only preamble forbidding file creation, modification, or deletion. The only writes are the audit report and the .audit/findings.json ledger inside the target directory.

Which languages and stacks does codebase-audit support?▼

It detects TypeScript/JavaScript via package.json, Python via pyproject.toml or requirements.txt, Rust via Cargo.toml, and Go via go.mod, and adapts agent count and search patterns for full-stack, backend-only, or frontend-only projects.

How does the skill track findings across multiple audits?▼

It maintains a ledger at .audit/findings.json and matches findings by category, file, and root-cause summary rather than line numbers. Each re-audit classifies findings as new, still-open, or resolved, with spot-checks before marking anything resolved.

Why are some findings labeled unverified in the report?▼

Medium-severity findings skip the adversarial verify pass, and quick mode skips verification entirely, so those findings are labeled unverified. Findings whose verifier failed are also kept but marked unverified rather than dropped.