verify-citation-integrity

Verify cited_locations entries in /decode YAML specs against source files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents fabricated or inaccurate citations by verifying that every cited_locations entry in a decode spec points to an existing file, a valid line range, and source text that matches the referenced excerpt.

Core Features & Use Cases

  • Static citation verification: Checks cited file existence, validates line_start/line_end bounds, and compares extracted source content against the cited excerpt using the selected normalization mode.
  • Deterministic, no-LLM enforcement: Runs as a pure read-and-compare pass with no model reasoning, suitable for tight enterprise-grade auditability.
  • Actionable integrity reports: Produces a citation-integrity report with per-citation breadcrumbs and mismatch details, enabling fast correction before specs are marked captured.

Use case: when a /decode workflow proposes behavior/flow/aspect content with citations, this skill ensures the citations are real and exact (modulo configured whitespace normalization), stopping capture if integrity fails.

Quick Start

Run verify-citation-integrity on the target decode spec to generate a citation integrity report at the configured output path.

Frequently Asked Questions about verify-citation-integrity

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

FAQPage Schema
How do I verify YAML spec citations against actual source code lines deterministically?▼

You can verify YAML spec citations by running a static read-and-compare pass that checks file existence, validates 1-indexed line ranges, and matches cited excerpts against current source text after normalization.

What is citation integrity verification in automated development workflows?▼

Citation integrity verification is a deterministic process that confirms cited_locations entries in a decode spec point to existing files and valid line ranges with matching source text, preventing fabricated evidence claims before specs are marked captured.

How do I validate line_start and line_end bounds in a decode YAML spec?▼

To validate line bounds in a decode YAML spec, the verification process parses the YAML, performs deterministic file reads, and strictly checks that 1-indexed line_start and line_end values map accurately to the referenced source files.

Does citation verification require an LLM to check source excerpt matching?▼

No LLM is required for citation verification; the process runs as a pure deterministic read-and-compare pass with no model reasoning, making it suitable for tight enterprise-grade auditability and compliance.

How do I generate a report for mismatched citations before marking behavior specs captured?▼

You generate a report for mismatched citations by running the verification skill, which produces an actionable integrity report with per-citation breadcrumbs and mismatch details to enable fast correction.

What are the limitations of using static verification for citation integrity?▼

Static verification for citation integrity is limited to checking file existence, strict line bounds, and excerpt matching modulo configured whitespace normalization, meaning it cannot evaluate the semantic accuracy or context of the cited evidence.