codebase-audit

Audit Cargo workspace crates in dependency order and generate per-crate documentation and facts.toml.

12|1|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/RyderFreeman4Logos/cli-sub-agent --skill codebase-audit-ryderfreeman4logos
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-audit
Source: https://github.com/RyderFreeman4Logos/cli-sub-agent/tree/main/patterns/codebase-audit/skills/codebase-audit
Command: npx skills add https://github.com/RyderFreeman4Logos/cli-sub-agent --skill codebase-audit-ryderfreeman4logos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematically audits an entire codebase (or scoped subset) to generate comprehensive, crate-level documentation and risk assessments, consolidating README.md, per-crate reviews, and a machine-readable facts.toml.

Core Features & Use Cases

  • Per-crate documentation: automatically generate README.md, review_report.md, and blog.md for each crate.
  • Topological processing: process crates in dependency order to ensure context propagation and reproducible results.
  • Facts sidecar: emit a structured facts.toml capturing APIs, dependencies, risks, and architecture.
  • Use Case: audit a multi-crate workspace to produce consistent documentation and governance artifacts across all crates.

Quick Start

Initiate a full workspace codebase audit to generate per-crate documentation and a global facts summary.

Frequently Asked Questions about codebase-audit

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

FAQPage Schema
How do I automate codebase audits for a Cargo workspace with multiple crates?▼

To automate codebase audits for a Cargo workspace, process crates in topological dependency order. This generates per-crate documentation like README.md, review reports, and a machine-readable facts.toml capturing APIs and risks.

What is topological processing when auditing a Rust codebase?▼

Topological processing audits a Rust codebase by evaluating crates in their dependency order. This ensures accurate context propagation across the topology and reproducible results for scalable workspace reporting.

Can I generate per-crate documentation and risk assessments for large Rust projects?▼

Yes, you can generate per-crate documentation and risk assessments for large Rust projects. The audit systematically evaluates scoped subsets or entire workspaces to produce review reports and structured facts.

How do I create a structured facts.toml file for crate dependencies and architecture?▼

Create a structured facts.toml for crate dependencies by running a comprehensive codebase audit. This emits a sidecar file capturing APIs, dependency risks, and architecture alongside the generated documentation.

Does the codebase audit process support scoped subset audits or only full workspace evaluation?▼

The codebase audit process supports both full workspace evaluation and scoped subset audits. It orchestrates a deterministic workflow to process crates in dependency order, ensuring scalable reporting regardless of scope.