citation-graph-ingest

Extracts and classifies typed citation edges between documents in an ingested gbrain corpus.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/AMC-JTC/gbrain-1 --skill citation-graph-ingest-amc-jtc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: citation-graph-ingest
Source: https://github.com/AMC-JTC/gbrain-1/tree/main/plugin/skills/citation-graph-ingest
Command: npx skills add https://github.com/AMC-JTC/gbrain-1 --skill citation-graph-ingest-amc-jtc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Flat similarity search cannot tell you that one document overrules, distinguishes, or relies on another. This Skill builds a typed reference graph over an ingested corpus so you can traverse the actual argument structure — for example, asking which documents overrule a given authority — instead of getting back fuzzy-matched paragraphs. ## Core Features & Use Cases - Typed edge extraction: Detects inter-document references mechanically, then uses model judgment to classify each edge as overrules, distinguishes, relies_on, extends, refutes, supersedes, or cites. - Native graph storage: Writes edges via gbrain link with link_source=citation-graph provenance, making them queryable with gbrain graph-query --type and bulk-removable without touching other writers' edges. - Verified runs: The pipeline is not complete until a graph-query walk from a hub document returns the written edges; idempotent re-runs skip duplicates. - Use Case: Ingest a case-law corpus as a gbrain source, run this Skill, then ask gbrain graph-query doc-a --type overrules --direction in to learn that doc A was overruled by doc C — an answer vector search alone cannot produce. ## Quick Start Build a typed citation graph over my ingested case-law corpus so I can trace which documents overrule or rely on each other.

Frequently Asked Questions about citation-graph-ingest

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

FAQPage Schema
How do I build a citation graph over a corpus of documents?

Ingest the corpus as a gbrain source, then run the pipeline: detect candidate references mechanically, classify each edge type with model judgment, write edges with gbrain link, and verify with a graph-query walk from a hub document.

What edge types does a typed citation graph support?

The skill uses snake_case link types such as overrules, distinguishes, relies_on, extends, refutes, supersedes, and cites. Pick one canonical spelling per relation because graph-query --type filters are exact-match.

Does gbrain query traverse citation edges in natural language search?

No. Natural-language relational recall inside gbrain query walks a fixed edge-type set that does not include citation types like overrules or relies_on. Use explicit gbrain graph-query commands with --type and --direction instead.

Is re-running citation graph ingest over the same corpus safe?

Yes, the pipeline is idempotent. Edge uniqueness is keyed on (from, to, link_type, link_source), so re-running over the same corpus silently skips duplicates without creating redundant edges.

Why did my citation graph run report failure?

A run fails when the verification graph-query walk returns no written edges, usually due to wrong source scope, slug mismatches, or a typo'd --type filter. The report leads with RUN FAILED and the diagnosis rather than partial success.

How is citation graph ingest different from citation-fixer?

citation-fixer repairs citation formatting inside the brain's own pages and never creates graph edges. citation-graph-ingest builds a typed edge graph over an ingested external corpus using the native links table.