maverick-alignment

Audit a codebase against Maverick practices and write findings to docs/maverick-audit.md.

10|2|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/thermiteau/maverick --skill maverick-alignment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maverick-alignment
Source: https://github.com/thermiteau/maverick/tree/main/skills/maverick-alignment
Command: npx skills add https://github.com/thermiteau/maverick --skill maverick-alignment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyzes a project's codebase against Maverick standard practices and writes a findings report to docs/maverick-audit.md.

Core Features & Use Cases

  • Comprehensive audit of linting, unit tests, integration tests, documentation, and CI/CD.
  • Writes a structured findings report suitable for onboarding and ongoing quality checks.
  • Use Case: Onboarding an existing project or performing periodic audits to identify compliance gaps.

Quick Start

Run a full Maverick alignment audit on the current project to generate docs/maverick-audit.md.

Frequently Asked Questions about maverick-alignment

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

FAQPage Schema
How do I audit a codebase against standard practices for linting and CI/CD?

To audit a codebase against standard practices, run a full alignment check that analyzes linting, tests, documentation, and CI/CD pipelines. It evaluates your project and generates a structured findings report with PASS, WARN, or FAIL ratings per category.

What is included in a codebase compliance audit report?

A codebase compliance audit report includes structured findings for linting, unit tests, integration tests, documentation, and CI/CD pipelines. It assigns PASS, WARN, or FAIL statuses to each category and provides supporting evidence to help you identify compliance gaps.

When do I need to run a project quality audit?

You need to run a project quality audit during the onboarding of an existing project or when performing periodic quality checks. This helps identify compliance gaps in your linting, testing, documentation, and CI/CD configurations.

Can I use this audit for existing projects without prior standardization?

Yes, you can use this audit for existing projects without prior standardization. It is specifically designed for onboarding existing codebases to evaluate current linting, tests, documentation, and CI/CD pipelines against established standards.

How do I generate a findings report for unit tests and integration tests?

To generate a findings report for unit tests and integration tests, execute a full alignment audit on your current project. The process evaluates your test suites and writes a structured compliance report directly to your documentation directory.

What are the limitations of automated codebase audits?

The limitations of automated codebase audits include focusing strictly on linting, tests, documentation, and CI/CD pipelines. It generates a static findings report and does not automatically fix the identified compliance gaps in your codebase.