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.