skills.rest
ronniepinnell
ronniepinnellCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

spec-audit

Compare codebases against specifications and classify divergences with file and line numbers.

Updated Jul 10, 2026
Search Tags:#code review#specification#drift detection#verification#audit
One-click install
npx skills add https://github.com/ronniepinnell/casper --skill spec-audit-ronniepinnell
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-audit
Source: https://github.com/ronniepinnell/casper/tree/main/collection/verification-and-audit/spec-audit
Command: npx skills add https://github.com/ronniepinnell/casper --skill spec-audit-ronniepinnell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The spec-audit skill solves the issue of misaligned code and specifications, which leads to software bugs and inconsistencies.

Core Features & Use Cases

  • Code vs Spec Comparator: Directly compares the actual code with written specifications to identify discrepancies.
  • Divergence Classification: Categorizes differences as absent, partial, wrong, or extra, with file and line numbers.
  • Project Rule Precedence: Allows project rules (CLAUDE.md) to take precedence over specifications.
  • Use Cases: Ideal for PR reviews, post-implementation verification, and detecting specification drift.

Quick Start

Run 'spec-audit' with the spec file and the code area you want to compare.

Frequently Asked Questions about spec-audit

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

FAQPage Schema
How do I detect specification drift in a Python codebase?▼

Specification drift is detected by directly comparing the actual codebase with written specifications to identify discrepancies. This process categorizes differences as absent, partial, wrong, or extra, providing exact file and line numbers for review.

What is the best way to compare code against specifications during a PR review?▼

Comparing code against specifications during a PR review involves running an audit that categorizes divergences as absent, partial, wrong, or extra with specific file and line numbers. This ensures implementation aligns with intended design and project rules.

How do I verify code implementation matches my design specifications?▼

Verifying code implementation matches design specifications requires running an audit that directly compares the codebase against the spec file. It categorizes divergences as absent, partial, wrong, or extra, providing file and line numbers to help align implementation with intended design.

Does spec-audit work with Python projects using Bash and Grep for verification?▼

Yes, specification auditing works with Python-based projects using Grep and Bash for checks. It applies these tools during code review processes and continuous integration to compare the codebase against its specifications and detect divergences.

Can project rules override written specifications during a code audit?▼

Yes, project rules defined in CLAUDE.md can take precedence over written specifications during a code audit. This allows project-specific configurations to override baseline specs when categorizing divergences as absent, partial, wrong, or extra.

Related Skills

Explore More Software Engineering Skills→
figuretufiguretu
16

preferred-coding-style

Apply a user's personal coding style across projects and code reviews.

Community
Intermediate
ravenoakravenoak

weed

Detect divergences between Allium specifications and implementation code.

Community
Advanced
reomgitreomgit

land-and-deploy

Merge pull requests, run CI/CD pipelines, and deploy to production.

Community
Advanced
Chang-Shih-YungChang-Shih-Yung

health

Aggregate type checker, linter, and test results into a 0-10 composite score.

Community
Advanced