skills.rest
mattbutlerengineering
mattbutlerengineeringCOMMUNITY
Explore all skills by this author →
GitHub

acmm-audit

Audit a Git repository against the AI Codebase Maturity Model criteria.

1|Updated Jan 24, 2026
Search Tags:#github issues#codebase audit#ai readiness#maturity model#deterministic scoring#repo governance#acmm
One-click install
npx skills add https://github.com/mattbutlerengineering/mattbutlerengineering --skill acmm-audit
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: acmm-audit
Source: https://github.com/mattbutlerengineering/mattbutlerengineering/tree/main/plugins/acmm/skills/acmm-audit
Command: npx skills add https://github.com/mattbutlerengineering/mattbutlerengineering --skill acmm-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

It helps teams measure how AI-operable their repository is using the AI Codebase Maturity Model (ACMM), turning scattered readiness signals into an actionable maturity report.

Core Features & Use Cases

  • Canonical ACMM scoring: Evaluates project meta-properties across a 6-level rubric (L1 assisted through L6 fully autonomous) using a ported 100+ criterion catalog.
  • Actionable next-level gaps: Optionally creates deduplicated GitHub issues for criteria that block advancement.
  • Progress visibility: Writes generated state and a human-readable report under .claude/acmm/, and can rewrite the README badge for quick scanning.
  • Use case: Run an ACMM audit before scaling AI automation initiatives, then create issues targeting the next maturity step rather than relying on ad hoc review.

Quick Start

Ask the AI to run /acmm-audit with the apply flag to generate the ACMM report and open GitHub issues for the next-level gaps.

Frequently Asked Questions about acmm-audit

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

FAQPage Schema
How do I audit my codebase for AI readiness?▼

You can assess AI readiness by running an audit against the AI Codebase Maturity Model, which applies over 100 deterministic criteria to evaluate repository governance and compute a maturity score from assisted to fully autonomous levels.

What is the AI Codebase Maturity Model and how does it score repositories?▼

The AI Codebase Maturity Model is a 6-level rubric ranging from assisted to fully autonomous that uses deterministic scoring across 100+ criteria to evaluate how AI-operable a repository is rather than relying on subjective code health reviews.

How do I create GitHub issues for codebase maturity gaps automatically?▼

You can automatically create deduplicated GitHub issues for next-level maturity gaps by running the audit with the apply flag, which detects missing project files and opens issues targeting the criteria blocking advancement.

Can I track AI codebase maturity progress in my README?▼

Yes, the audit writes a state file and human-readable report under the .claude directory and can optionally rewrite your README ACMM badge to provide quick scanning visibility for maturity progress.

Does this codebase audit require any external dependencies or API keys?▼

No external dependencies are required to run the audit; the Skill loads the 100+ ported criteria locally to detect required project files and compute level thresholds directly within your repository environment.

Related Skills

Explore More Software Engineering Skills→
Tx1207Tx1207
5

project-creator

Create a new project from a template, initialize uv, and configure a local Git repository.

Community
Advanced
SocketDevSocketDev
125

fleet-updating-coverage

Run coverage tooling and update the root README coverage badge.

Official
Advanced
jacobcyjacobcy
6

vibe-integrate

Assesses GitHub pull requests for merge readiness via CI, reviews, LOC thresholds, and sequencing.

Community
Advanced
Objective-ArtsObjective-Arts

cleanup

Review and fix code against quality gates and security standards.

Official
Advanced