skills.rest
tylerburleigh
tylerburleighCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

sdd-validate

Detect and repair structural issues in SDD JSON specification files.

9|3|Updated Oct 24, 2025
Search Tags:#spec-driven#validation#dependency analysis#reporting#software quality#auto-fix#JSON schema
One-click install
npx skills add https://github.com/tylerburleigh/claude-sdd-toolkit --skill sdd-validate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sdd-validate
Source: https://github.com/tylerburleigh/claude-sdd-toolkit/tree/main/skills/sdd-validate
Command: npx skills add https://github.com/tylerburleigh/claude-sdd-toolkit --skill sdd-validate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures the structural integrity and consistency of your Spec-Driven Development (SDD) JSON specification files, preventing errors and inconsistencies that could derail implementation. It automates the detection and fixing of common issues, saving manual debugging time and ensuring reliable specs.

Core Features & Use Cases

  • Comprehensive Validation: Checks hierarchy, task counts, metadata, and dependency graph validity.
  • Auto-Fix Capabilities: Automatically corrects 13 common issue types with preview and backup options, ensuring spec health.
  • Detailed Reporting: Generates comprehensive Markdown or JSON reports with categorized issues, statistics, and dependency analysis.
  • Use Case: After creating or modifying a complex JSON spec, run this skill to automatically fix incorrect task counts, resolve hierarchy mismatches, and detect circular dependencies, ensuring your spec is robust and ready for implementation.

Quick Start

Validate a spec file and get a summary

sdd validate specs/active/my-spec.json

Preview auto-fixable issues without applying changes

sdd fix specs/active/my-spec.json --preview

Apply auto-fixes to the spec file (creates a backup by default)

sdd fix specs/active/my-spec.json

Generate a detailed validation report in Markdown

sdd report specs/active/my-spec.json --format markdown --output -

Frequently Asked Questions about sdd-validate

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

FAQPage Schema
How do I validate JSON specification files for structural errors?▼

JSON specification validation checks hierarchy, task counts, metadata, and dependency graph validity to catch structural errors. This Skill validates specs against Draft 07 JSON Schema and identifies issues automatically, preventing errors that could derail implementation.

Can I automatically fix common issues in my SDD JSON specs?▼

Yes, auto-fix automatically corrects 13 common issue types in SDD JSON specifications with preview and backup options. Run the fix command to resolve task count mismatches, hierarchy problems, and circular dependencies without manual editing.

What's the best way to detect circular dependencies in specification files?▼

Dependency analysis identifies circular dependencies and invalid dependency graphs within your JSON specs. The validation reports comprehensive dependency insights, ensuring your spec structure is sound before implementation begins.

How do I generate validation reports for my specifications?▼

Generate detailed validation reports in Markdown or JSON format with categorized issues, statistics, and dependency analysis. Reports provide complete visibility into spec health and the exact fixes applied during auto-correction.

When should I validate specs in my CI/CD pipeline?▼

Run validation during CI/CD to catch structural issues early and enforce consistent specification quality across your development workflow. This prevents broken specs from reaching implementation phases and ensures reliability throughout the pipeline.

Do I need to manually fix every specification issue?▼

No, auto-fix handles 13 common issue types automatically with backup files created by default. Use preview mode to review proposed changes before applying fixes, reducing manual debugging time significantly.

Related Skills

Explore More Software Engineering Skills→
GliteTechGliteTech
16

create-task

Create a not-started task folder with validated task.json and task_description.md.

Official
Intermediate
jhlee0409jhlee0409
4

openapi-parser

Parse OpenAPI 3.x and Swagger 2.0 specs into structured endpoint catalogs.

Community
Advanced
SufficientDaikonSufficientDaikon
8

sdd-pipeline-expert

Coordinate Spec-Driven Development lifecycle phases with integrated quality gates.

Community
Advanced
LukasStricklerLukasStrickler
4

code-quality

Automate TypeScript type checking, linting, formatting, and Markdown validation.

Community
Advanced