What do the different exit codes mean?

Exit 0 means a clean spec; Exit 1 indicates warnings; Exit 2 indicates errors were found (expected for new or incomplete specs); and Exit 3 indicates a command failure like a missing file.

Can I analyze project bottlenecks with this tool?

Yes, the 'analyze-deps' action specifically identifies bottlenecks—tasks that are blocking a high number of subsequent tasks—to help you prioritize your development roadmap.

How do I handle a plateau in the error count during fixing?

If the error count stops decreasing after multiple 'fix' passes, run 'validate' with the verbose flag to identify 'manual intervention' issues, such as circular dependencies or logical inconsistencies that require human judgment.

What issues can sdd-validate automatically fix?

The skill can auto-repair 13 common issue types, including incorrect task count rollups, missing metadata blocks, orphaned nodes, parent/child hierarchy mismatches, malformed timestamps, and invalid status values.

Does this skill support JSON Schema validation?

Yes, it supports Draft 07 JSON Schema validation. It can automatically install the required dependencies if you run 'pip install claude-skills[validation]'.

Spec-Driven Development Validator

Name: Spec-Driven Development Validator
Author: tylerburleigh

bytylerburleigh

0•

Productividad y Flujo de Trabajo

Validates and auto-fixes Spec-Driven Development (SDD) JSON files to ensure structural integrity and dependency health.

The sdd-validate skill is a comprehensive toolkit designed for developers using Spec-Driven Development (SDD) workflows. It provides deep inspection of JSON specification files, identifying structural errors, orphaned nodes, and complex dependency issues like circular loops or bottlenecks. Beyond mere detection, the skill can automatically repair over a dozen common spec issues, offering an iterative workflow that moves from initial drafting to a production-ready, valid specification. It is an essential utility for maintaining the quality and consistency of project specs before they are used for code generation or task implementation.

Características Principales

01Advanced dependency analysis to detect circular references, orphaned tasks, and project bottlenecks.

020 GitHub stars

03Automated repair of 13+ common JSON spec structural issues including task rollups and metadata blocks.

04Flexible path resolution that automatically searches for specs in pending, active, or archived directories.

05Comprehensive statistical reporting on spec depth, coverage, complexity, and progress.

06Intelligent exit code system optimized for CI/CD integration and iterative manual refinement.

Casos de Uso

01Validating a newly created project specification to ensure it meets SDD structural requirements.

02Analyzing task dependencies to identify blocking issues before starting the implementation phase.

03Auto-fixing hierarchy mismatches and task count errors in large, complex specification files.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tylerburleigh/claude-foundry sdd-validate

For use in Claude.ai and ChatGPT

Download Skill