What kind of reports does the skill generate?

It produces comprehensive reports featuring an overall letter grade (A-F), category-specific scores, a list of identified issues, and prioritized remediation guidance.

Does this skill support JSON output for CI/CD pipelines?

Yes, you can use the --format json argument to receive machine-readable audit data, making it easy to integrate into automated workflows or custom dashboards.

How does this help reduce development bugs?

By identifying ambiguous requirements and non-testable acceptance criteria early, it prevents the implementation of incorrect features and reduces the need for expensive late-stage rework.

What criteria does the audit skill use for scoring?

The skill evaluates specifications based on structure, requirement clarity (EARS), acceptance criteria (Given/When/Then), traceability, and INVEST quality scores.

Can I audit multiple specifications at once?

Yes, by using the --all flag, the skill will automatically discover and audit all specifications found within your .specs/ directory.

Specification Quality Auditor

Name: Specification Quality Auditor
Author: melodic-software

bymelodic-software

•

Productivity & Workflow

Performs automated quality audits on technical specifications to ensure clarity, testability, and compliance with industry standards.

The Specification Quality Auditor is a specialized tool for Spec-Driven Development (SDD) that evaluates project documentation against professional engineering standards. It assesses specifications based on a weighted rubric including EARS-formatted requirements, Given/When/Then acceptance criteria, and INVEST quality principles. By providing objective A-F grading, detailed issue tracking, and specific remediation guidance, this skill helps teams eliminate ambiguity and identify potential implementation risks before a single line of code is written.

Key Features

01Automated evaluation of requirements using EARS and INVEST frameworks.

02Detailed issue reporting categorized by severity with actionable remediation steps.

03Flexible output formats including Markdown for human review and JSON for tool integration.

0438 GitHub stars

05Comprehensive scoring across five key categories: Structure, Requirements, AC, Traceability, and Quality.

06Support for bulk auditing of entire specification directories via the --all flag.

Use Cases

01Performing gap analysis on existing documentation to identify missing test cases or ambiguous requirements.

02Validating technical requirements and acceptance criteria before initiating feature development.

03Establishing a quality gate in documentation workflows to ensure all specs meet a 'Grade B' or higher.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add melodic-software/claude-code-plugins audit

For use in Claude.ai and ChatGPT

Download Skill