sdd-audit

Compare code implementations against spec documents to produce structured audit reports.

192|21|Updated Sep 19, 2025
One-click install
npx skills add https://github.com/madebyaris/spec-kit-command-cursor --skill sdd-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-audit
Source: https://github.com/madebyaris/spec-kit-command-cursor/tree/main/.cursor/skills/sdd-audit
Command: npx skills add https://github.com/madebyaris/spec-kit-command-cursor --skill sdd-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps development teams ensure that implementations align with their specifications by conducting gap analysis and producing clear, actionable review reports.

Core Features & Use Cases

  • Gap analysis: compare actual code with spec requirements and identify missing or inconsistent implementations.
  • Structured audit reports: generate findings with severity levels and evidence links to spec sections.
  • Compliance checks: verify alignment across spec.md, plan.md, and tasks.md with an integrated checklist reference.
  • Use Case: A QA engineer runs the audit after implementing a feature to validate coverage and identify remaining gaps before release.

Quick Start

Run the audit after implementing a feature to generate a gap-analysis report. Review the generated findings against the toolkit references/checklist.md. Iterate on the spec and code until all critical gaps are resolved.

Frequently Asked Questions about sdd-audit

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

FAQPage Schema
How do I audit code against specifications to find implementation gaps?

To audit code against specifications, compare the codebase against spec.md, plan.md, and tasks.md documents to identify missing or inconsistent implementations. The process produces a structured gap-analysis report with severity levels and evidence links for quality assurance.

How do I generate a compliance report for spec.md, plan.md, and tasks.md?

Generate a compliance report by running an audit across spec.md, plan.md, and tasks.md documents alongside the codebase. The report verifies alignment, includes severity-based findings, and links evidence to checklist references for comprehensive quality assurance validation.

When do I need to run a spec compliance audit during code review?

Run a spec compliance audit after implementing a feature to validate coverage and identify remaining gaps before release. It performs gap analysis by comparing actual code with spec requirements, producing actionable review reports with severity-based findings.

Does the audit report include severity levels and evidence links?

Yes, the audit report includes severity levels for findings and provides evidence links directly to spec sections and checklist references. This structured reporting satisfies functional requirements for compliance checks and quality assurance during code review.

Can I use automated validation for spec compliance checks?

Yes, automated validation is supported through integration with sdd-verifier. The audit skill produces structured reports for compliance checks, applying gap analysis across spec documents and the codebase to identify issues and link evidence to checklist references.

What is the best way to resolve critical gaps found in a code audit?

The best way to resolve critical gaps is to review the generated audit findings against the checklist references, then iterate on the spec and code until all critical gaps are resolved. This ensures implementations fully align with specifications before release.