codebase-auditor

Audit codebases for architectural weaknesses, domain modeling gaps, and quality issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit codebases to identify architectural weaknesses, code smells, and opportunities for improvement across architecture, domain modeling, data design, and quality invariants.

Core Features & Use Cases

  • Holistic codebase reviews focusing on architecture, domain modeling, data design, and system quality.
  • Actionable recommendations to improve design, governance, and maintainability based on the visible code and artifacts.
  • Use Case: when teams need a structured audit of a repository to align with good architectural practices and avoid common design pitfalls.

Quick Start

Provide a holistic codebase audit for the repository, focusing on architecture, domain models, and data design.

Frequently Asked Questions about codebase-auditor

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

FAQPage Schema
How do I audit a codebase for architectural weaknesses and domain modeling gaps?

A codebase audit identifies architectural weaknesses, domain modeling gaps, and quality issues by evaluating modularity, testing, security, and performance. It applies DDD principles to provide actionable recommendations for improving system design and maintainability.

What is a DDD-based code review and when do I need it?

A DDD-based code review evaluates domain models and architecture against Domain-Driven Design principles. You need it when aligning codebases with good architectural practices to avoid common design pitfalls and improve system governance.

Can I run a codebase audit on repositories of any size and programming language?

Yes, you can audit repositories of varying sizes and languages. The audit evaluates visible code and artifacts to provide holistic recommendations for architecture, domain models, and data design regardless of the underlying tech stack.

How to get actionable recommendations for improving codebase quality and modularity?

To get actionable recommendations for improving codebase quality, you perform a structured audit focusing on architecture, domain models, and data design. The audit enforces evaluation criteria aligned with modularity, testing, security, and performance.

Does the codebase audit check for security and performance invariants?

Yes, the codebase audit checks for security and performance invariants. It enforces evaluation criteria across architecture, domain modeling, modularity, testing, security, and performance to identify systemic quality issues.

What are the limitations of a codebase audit for improving maintainability?

The audit's limitations depend on the visible code and artifacts provided in the repository. Recommendations for design, governance, and maintainability are based solely on the visible codebase, so hidden external dependencies may not be fully evaluated.