skills.rest
buddypia
buddypiaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

spec-validator

Validate SPEC documents against JSON Schema, structural, and write operation rules.

Updated Feb 21, 2026
Search Tags:#automated testing#schema validation#documentation quality#specification compliance#api contract#spec validation
One-click install
npx skills add https://github.com/buddypia/kaiju-voice --skill spec-validator-buddypia
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-validator
Source: https://github.com/buddypia/kaiju-voice/tree/main/.claude/skills/spec-validator
Command: npx skills add https://github.com/buddypia/kaiju-voice --skill spec-validator-buddypia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jsonschema, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the validation of SPEC documents, ensuring adherence to defined schemas and formats, thereby improving the quality and consistency of technical specifications.

Core Features & Use Cases

  • JSON Schema Validation: Validates code blocks like TypeScript models, DB schemas, and API contracts against their respective meta-schemas.
  • Structural Validation: Checks for the presence of required sections, correct Acceptance Criteria (AC) formatting, and explicit 'N/A' declarations for empty sections.
  • Hybrid API Validation: Verifies the consistency between API schemas and their examples, and checks for the existence of Single Source of Truth (SSOT) paths.
  • Write Operations Validation: Ensures consistency and completeness of data modification specifications, including operation mapping, table references, transaction integrity, idempotency strategies, and audit policies.
  • Use Case: Before merging a new feature specification, run this Skill to automatically catch formatting errors, schema violations, and inconsistencies in API contracts, preventing potential implementation issues.

Quick Start

Run the spec-validator skill to validate the SPEC document located at 'docs/features/029-battle/SPEC-029.md'.

Frequently Asked Questions about spec-validator

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

FAQPage Schema
How do I automate SPEC document validation for API contracts?▼

Automated SPEC validation extracts and verifies JSON Schema blocks, API contracts, and structural elements against predefined meta-schemas. It ensures adherence to quality gates and consistency across technical documentation before merging feature specifications.

How do I validate JSON Schema blocks in technical specifications?▼

Validating JSON Schema blocks involves checking TypeScript models, DB schemas, and API contracts against their respective meta-schemas. The process ensures code blocks within SPEC documents maintain strict adherence to defined formats and structural requirements.

Does schema validation check consistency between API examples and SSOT paths?▼

Hybrid API validation verifies consistency between API schemas and their examples, and checks for the existence of Single Source of Truth (SSOT) paths. This ensures API contracts remain reliable and accurately documented across the specification.

How do I validate write operations and transaction integrity in a SPEC document?▼

Write operations validation ensures consistency and completeness of data modification specifications by checking operation mapping, table references, transaction integrity, idempotency strategies, and audit policies against defined rules.

What is structural validation for SPEC documents and why is it needed?▼

Structural validation checks SPEC documents for required sections, correct Acceptance Criteria (AC) formatting, and explicit 'N/A' declarations for empty sections. It is needed to catch formatting errors and maintain documentation quality before implementation.

Do I need jsonschema to validate API contracts in SPEC documents?▼

Yes, the jsonschema dependency is required to validate API contracts, TypeScript models, and DB schemas. It provides the underlying meta-schema verification needed to enforce specification compliance and structural consistency.

Related Skills

Explore More Software Engineering Skills→
hafley66hafley66
1

typespec-validation

Validate TypeSpec models with decorators and JSON Schema.

Community
Advanced
bobmatnycbobmatnyc
146

Requesting Code Review

Dispatch a code-reviewer subagent to review changes against plans and requirements.

Community
Basic
sudocarlossudocarlos
4

testing-cicd

Manages Go/Python tests and GitHub Actions CI/CD workflows for tailrelay project.

Community
Intermediate
PlaneInABottlePlaneInABottle

api-contract-testing

Validate REST API contracts against OpenAPI specifications and JSON Schema.

Community
Intermediate