skills.rest
wendeus0
wendeus0COMMUNITY
Explore all skills by this author →
GitHub

spec-validator

Validate SPEC.md frontmatter, required sections, and acceptance criteria.

Updated Aug 23, 2026
Search Tags:#specification#validation#testability#yaml#bdd#frontmatter#acceptance-criteria
One-click install
npx skills add https://github.com/wendeus0/AI-dotfiles --skill spec-validator-wendeus0
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-validator
Source: https://github.com/wendeus0/AI-dotfiles/tree/main/core/skills/spec-validator
Command: npx skills add https://github.com/wendeus0/AI-dotfiles --skill spec-validator-wendeus0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Este Skill ajuda equipes a validar SPEC.md existente antes de avançar para TDD, assegurando que o frontmatter, as seções obrigatórias e os critérios de aceitação estejam completos.

Core Features & Use Cases

  • Validação de frontmatter (id, type, summary, status) e consistência com SPEC_FORMAT.md.
  • Verificação de seções obrigatórias (Contexto, Critérios de aceitação, Fora de escopo, Casos de erro) e das seções relacionadas aos critérios de aceitação.
  • Geração de relatório consolidado de erros para correção antes de executar testes.

Quick Start

Valide a SPEC.md atual do feature executando o processo de validação definido.

Frequently Asked Questions about spec-validator

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

FAQPage Schema
How do I validate SPEC.md frontmatter and required sections before testing?▼

To validate SPEC.md, you check frontmatter fields like id, type, summary, and status, then verify mandatory sections such as Context, Acceptance Criteria, and Out of Scope. This process identifies structural issues and returns a consolidated error list for correction.

What makes acceptance criteria testable in a SPEC.md file?▼

Acceptance criteria are testable when they include clear, verifiable conditions aligned with project guidelines. Validation checks these criteria and error cases against SPEC_FORMAT.md to ensure they are complete and structurally sound before advancing to TDD.

Do I need a SPEC_FORMAT.md file to validate specification frontmatter?▼

Yes, validating specification frontmatter requires checking consistency against SPEC_FORMAT.md. This ensures mandatory fields like id, type, summary, and status conform to project guidelines and that the overall spec quality is maintained.

What is the best way to check if my feature specification is ready for TDD?▼

The best way to prepare a feature specification for TDD is to run a validation process on the SPEC.md file. This verifies mandatory sections, checks frontmatter validity, and generates a consolidated error report to resolve issues before testing.

Why does my SPEC.md validation fail with missing out of scope sections?▼

SPEC.md validation fails when mandatory sections like Out of Scope, Context, or Error Cases are missing. The validator checks for these required sections and reports them in a consolidated error list to ensure specification completeness.

Related Skills

Explore More Software Engineering Skills→
invowkinvowk

speckit.specify

Convert natural language prompts into structured feature specification documents with validation checklists.

Official
Advanced
shuu5shuu5

twl:workflow-test-ready

Generate test scaffolds and validate readiness after workflow-setup.

Community
Advanced
AndreaCadonnaAndreaCadonna

spec-document

Transform RESEARCH.md into SPEC.md with requirements, interfaces, and traceability.

Community
Advanced
manatagomanatago

kiro-spec-requirements

Generates EARS-format requirements from project descriptions and steering context.

Community
Advanced