grounded-citations

Grounds answers and documents in numbered, verifiable source citations via a URL ledger.

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

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 or unverifiable citations because URLs are reconstructed from memory. This Skill eliminates that risk by assigning each retrieved source a stable numeric id in a persistent ledger, so the model only ever emits integers it was handed and the URL mapping is rendered mechanically. ## Core Features & Use Cases - Citation Ledger: Registers URLs at retrieval time with idempotent, URL-normalized ids, then renders Perplexity-style inline [n] citations and a Sources block in markdown, plain, footnotes, bibtex, or evidence styles. - Fact-Checking Mode: Attaches verbatim quotes to each source (rejected unless they literally appear in the fetched page text), flags model-knowledge claims with [unverified], and enforces an evidence gate during verification. - Draft Verification: Checks drafts for unknown citation ids, mismatched Sources blocks, and minimum citation coverage thresholds before delivery. - Use Case: While writing a market research report from web searches, register each fetched page with the ledger, cite claims inline as you draft, then run verify to confirm every citation resolves and the Sources block matches the ledger. ## Quick Start Ask the agent to research a topic using web search and deliver an answer where every factual claim carries an inline numbered citation followed by a rendered Sources list.

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 research answers?▼

Register each retrieved URL with the sources.py ledger at fetch time, which returns a stable numeric id. Cite those ids inline while drafting, then render the Sources block mechanically so URLs are never retyped from memory.

How to fact-check an AI-written report against its sources?▼

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 drafts whose cited sources carry no supporting quote.

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

Yes, the ledger is retrieval-agnostic and accepts URLs from web_search, web_extract, browser_navigate, curl, or any CLI. The ingest subcommand can also parse raw JSON tool output to register every URL automatically.

Can I export citations to BibTeX or footnotes for PDF reports?▼

The render command supports markdown, plain, footnotes, bibtex, and evidence styles. BibTeX output produces @misc entries keyed source<N> for LaTeX pipelines, while footnotes style suits PDF and docx deliverables.

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 --min-coverage threshold. Re-run render --replace-in to regenerate the block from the ledger.

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 where readers need to check the provenance of outside facts.