validate-kb-extension

Validate domain-taxonomy knowledge base features against the KB extension contract.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents incomplete domain-taxonomy knowledge base entries from progressing by enforcing the required KB extension sections and verifying that cross-tree constraint references are valid and non-dangling.

Core Features & Use Cases

  • Section completeness validation: Ensures every feature contains all five required H3 subsections (Inclusion, Success Criteria, Failure Scenarios, Cross-Tree Refs, Experiential) and that they are populated.
  • Rule contract enforcement: Checks that Inclusion, Success Criteria, Failure Scenarios, Cross-Tree Refs, and Experiential content meets the KB extension conventions defined in the contract rules file.
  • Constraint integrity verification: Validates that _cross-tree-constraints.yaml parses cleanly and that every referenced feature ID exists in the scanned domain-taxonomy files, halting the pipeline on any dangling refs.

Quick Start

Ask the calling agent to run validate-kb-extension with the paths to the domain-taxonomy markdown directory, the _cross-tree-constraints.yaml file, and the kb-extension conventions contract so it returns a structured validation report.

Frequently Asked Questions about validate-kb-extension

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

FAQPage Schema
How do I validate knowledge base markdown files for missing sections and cross-tree constraints?

Validating knowledge base markdown files requires checking that every feature contains required subsections like Inclusion, Success Criteria, and Cross-Tree Refs, while ensuring referenced feature IDs exist to prevent dangling references.

What is a knowledge base extension schema contract and when do I need it?

A knowledge base extension schema contract defines the formatting conventions for domain-taxonomy features. You need it during repository pre-flight checks to enforce section completeness and verify cross-tree constraint references before incomplete entries progress.

How do I check for dangling feature references in cross-tree constraints YAML?

To check for dangling feature references, safely parse the cross-tree constraints YAML file and verify that every referenced feature ID exists within the scanned domain-taxonomy markdown files, halting the pipeline if any are missing.

Does knowledge base validation work with enterprise domain-taxonomy files across multiple domains?

Yes, knowledge base validation applies to enterprise domain-taxonomy files by recursively globbing across all domains and features, extracting ordered feature lists, and generating a deterministic YAML report of completeness and formatting errors.

What is the best way to automate KB extension contract enforcement in a CI pipeline?

Automating KB extension contract enforcement involves running rule-driven section validations against the conventions contract file, checking for quantified success criteria and structured failure scenarios, and outputting a structured YAML validation report.

Why does my knowledge base validation fail on incomplete failure scenarios?

Knowledge base validation fails on incomplete failure scenarios because the rule contract enforcement checks that all five required H3 subsections, including Failure Scenarios, are fully populated and meet the defined KB extension conventions.