repo-auditor

Audits repositories and generates a markdown index of stack, conventions, and risks.

22|6|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/felvieira/claude-skills-fv --skill repo-auditor-felvieira
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: repo-auditor
Source: https://github.com/felvieira/claude-skills-fv/tree/main/skills/18-repo-auditor
Command: npx skills add https://github.com/felvieira/claude-skills-fv --skill repo-auditor-felvieira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Repo Auditor eliminates uncertainty about a codebase by producing a concise, persistent operational snapshot that maps the real stack, conventions, assets, tests, docs, risks, and integration points so downstream automation and humans can act with confidence.

Core Features & Use Cases

  • Automatic discovery: Detects frameworks, tooling, test suites, pipelines, and visual assets by scanning repository files and git history.
  • Reusable audit output: Persists a short indexed markdown (docs/repo-audit/current.md) and generates focused splits (routes.md, schema.md, components.md, services.md, infra.md) only when relevant to reduce re-reads and token usage.
  • Governance and incremental updates: Follows defined policies for execution, persistence, token-efficiency, and handoffs; updates audits only when relevant changes are detected.
  • Use Case: Use during onboarding, before major features or migrations, or when actual stack diverges from reference templates to prioritize risks and next steps.

Quick Start

Run the repo-auditor at the repository root and produce docs/repo-audit/current.md with detected stack, key conventions, prioritized risks, and recommended next steps.

Frequently Asked Questions about repo-auditor

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

FAQPage Schema
How do I audit a git repository to map its stack and identify risks?

To audit a git repository, scan files and git metadata to detect frameworks, tests, and pipelines, then generate a persistent markdown index mapping stack, conventions, and risks. This creates a concise operational snapshot for onboarding or pre-feature planning.

What is codebase audit documentation and when do I need it?

Codebase audit documentation is a persistent markdown snapshot mapping repository stack, assets, and integration points. You need it during initial onboarding, before major migrations, or when actual stack diverges from reference templates to prioritize next steps.

Can I use repository risk assessment on monorepo projects?

Yes, repository risk assessment works on web, backend, and monorepo projects. It reads repository files and git metadata to detect conventions and generate focused split files for routes, schema, components, services, and infrastructure only when relevant.

What's the best way to document existing repository conventions and integration points?

The best way to document conventions and integration points is generating a persistent indexed markdown file at docs/repo-audit/current.md. This reduces re-reads and token usage by creating focused split files only when relevant changes are detected.

How do I detect framework and test suite usage in an unknown codebase?

Detect framework and test suite usage by scanning repository files and git history for automatic discovery. This identifies tooling, pipelines, and visual assets, producing a concise operational snapshot for downstream automation and human action.

Are there limitations to generating persistent markdown indexes for repository audits?

Limitations include updating audits only when relevant changes are detected to maintain token-efficiency. The process generates focused split files for schema, components, or infra strictly when relevant, avoiding unnecessary re-reads across web, backend, and monorepo projects.