grounded-citations

Ground answers and documents in numbered, verifiable source citations.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill grounded-citations-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grounded-citations
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/research/grounded-citations
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill grounded-citations-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? AI-generated answers and reports often contain hallucinated URLs or citations that don't support the claims they reference. This Skill eliminates that risk by having a ledger script own the URL-to-number mapping, so the model only ever emits small integer ids it was handed at retrieval time — a wrong id is detectable and a wrong URL is impossible. ## Core Features & Use Cases - Citation Ledger: Register sources at retrieval time with sources.py add or ingest; ids are stable, idempotent, and URL-normalized across many search rounds. - Cite-While-Drafting Workflow: Place bracketed ids inline per sentence, then mechanically render the Sources block in markdown, plain, footnotes, bibtex, or evidence styles. - Fact-Checking Mode: Attach verbatim quotes to each source (rejected unless they literally appear in the fetched page text), flag model-knowledge claims with [unverified], and gate delivery with verify --evidence --min-coverage. - Use Case: Writing a market research brief from a dozen web sources — register each fetched page, cite claims inline as you draft, then run verify to confirm every citation resolves and coverage meets your threshold before delivering. ## Quick Start Ask the agent to research a topic using web search and write a grounded answer where every factual claim carries an inline numbered citation and a rendered Sources list at the end.

Frequently Asked Questions about grounded-citations

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

FAQPage Schema
How do I add verifiable citations to AI-generated answers?▼

Register each fetched URL with the citation ledger script at retrieval time, which returns a stable numeric id. Cite those ids inline per sentence while drafting, then render the Sources block mechanically so URLs are never typed from memory.

How to fact-check an AI research report with source quotes?▼

Attach verbatim quotes to each source using the quote command, which rejects any text not literally present in the fetched page. Then run verify with the evidence flag to fail any draft whose cited sources carry no supporting quote.

Does the citation ledger work with any web retrieval tool?▼

Yes, the ledger is retrieval-agnostic and works with web_search, web_extract, browser_navigate, curl, or any CLI. The ingest subcommand can also parse URLs directly from JSON tool output.

Can multiple parallel agents share one citation ledger?▼

Yes, point all subagents at the same ledger file using the --ledger flag or HERMES_CITATION_LEDGER environment variable. A lockfile prevents concurrent adds from assigning duplicate ids.

When should I skip inline citations in an answer?▼

Skip citations when retrieval is incidental to another task, such as a quick syntax lookup mid-coding, casual conversation, or creative writing. The skill targets deliverables that quote, paraphrase, or report outside facts.

Why does citation verification fail on my draft?▼

Verification fails when a draft cites ids not in the ledger, when the Sources block URLs disagree with the ledger, or when citation coverage falls below the set threshold. Re-run render to regenerate the block instead of hand-editing it.