spec-validator

Validate implementation code against formal specs using YAML checklists and graded scoring.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/JayKim88/claude-ai-engineering --skill spec-validator-jaykim88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-validator
Source: https://github.com/JayKim88/claude-ai-engineering/tree/main/plugins/spec-validator/v3/skills/spec-validator
Command: npx skills add https://github.com/JayKim88/claude-ai-engineering --skill spec-validator-jaykim88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates that implementation code aligns with formal specification documents using YAML-based checklists and a multi-dimensional scoring system, producing traceable validation results and reports.

Core Features & Use Cases

  • Automated FR/NFR alignment verification against specs
  • YAML-driven checklist synchronization and progress tracking
  • Generate comprehensive Markdown validation reports for teams and stakeholders

Quick Start

Run the validator with your spec path and optional checklist path to produce a comprehensive validation report

Frequently Asked Questions about spec-validator

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

FAQPage Schema
How do I validate code against a formal specification?

Validating code against a specification requires parsing the spec and cross-checking a YAML checklist to calculate multi-dimensional alignment scores, generating a traceable Markdown validation report for stakeholders.

What is multi-dimensional scoring for spec alignment?

Multi-dimensional spec scoring grades implementation code against formal requirements across various dimensions like FRs, NFRs, tests, and API endpoints, ensuring synchronized alignment and producing graded validation results.

How do I generate a validation report from a YAML checklist?

Generating a validation report from a YAML checklist involves running the validator with a spec path and optional checklist path to produce a comprehensive Markdown report detailing requirement alignment and progress tracking.

Can I track functional and non-functional requirements using YAML checklists?

Tracking functional and non-functional requirements via YAML checklists verifies implementation code against formal specs, measuring alignment progress and ensuring all specified FRs and NFRs are fully satisfied.

Does spec validation work without external dependencies?

Spec validation operates without external dependencies, directly parsing specification documents and cross-checking YAML checklists to calculate alignment scores and generate comprehensive reports within development workflows.

What is the best way to verify API endpoints against a specification document?

Verifying API endpoints against a specification document is best achieved through automated YAML-driven checklists that cross-check implementation code, calculate multi-dimensional alignment scores, and output traceable validation reports.