validate-intent-epics

Validate intent epic YAML files against the ICE schema and blocking rules.

3|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/kapilvirenahuja/garura --skill validate-intent-epics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: validate-intent-epics
Source: https://github.com/kapilvirenahuja/garura/tree/main/core/components/skills/validate-intent-epics
Command: npx skills add https://github.com/kapilvirenahuja/garura --skill validate-intent-epics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents shallow or schema-breaking intent epic outputs by enforcing the ICE structure, tenet compliance, scenario testability, and provenance traceability before downstream workflow stages proceed.

Core Features & Use Cases

  • Validates ICE epic schema contract: Ensures identity and exactly the four required sections appear in the correct order, rejecting any unknown or legacy top-level keys.
  • Enforces tenet and content quality heuristics: Applies human-readability checks and guards against jargon-heavy, placeholder, or non-user-observable outcomes.
  • Checks scenarios, recovery pairing, and dependency wiring: Verifies success/failure structure and ensures before/after connections, cycles, and mock pairing are consistent across the full epic batch.
  • Produces structured, field-level failure reports: Returns a validation result YAML with per-epic, per-field violations for fast regeneration and iteration.

Quick Start

Run validate-intent-epics during the specify stage after generating intent epics to produce a validation result YAML and block the pipeline on any structural or blocking tenet violations.

Frequently Asked Questions about validate-intent-epics

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

FAQPage Schema
How do I validate intent epic YAML files against an ICE schema?

Intent epic YAML validation checks files against the four-section ICE schema, enforcing structural order, tenet heuristics, and scenario testability to block invalid epics before downstream workflow stages proceed.

Why does schema validation fail on legacy keys in intent epics?

Schema validation fails on legacy keys because the ICE contract requires exactly four specific top-level sections in the correct order, rejecting any unknown or banned legacy top-level keys to prevent shallow epic outputs.

How do I enforce dependency consistency and provenance traceability across a batch of epics?

Dependency consistency and provenance traceability are enforced by verifying before and after connections, checking cycles, validating mock pairing, and ensuring provenance fields are consistent across the full epic batch.

Can I use schema validation as a blocking gate in an agentic SDLC?

Yes, schema validation acts as a blocking gate in an agentic SDLC by preventing invalid intent epics from shipping, ensuring deterministic, human-readable, and testable outcomes before the pipeline advances.

What are the limitations of heuristic checks for tenet compliance in intent epics?

Heuristic checks for tenet compliance guard against jargon-heavy, placeholder, or non-user-observable outcomes, but focus on human-readability and binary testability rather than semantic correctness of the epic content.