CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

citation-graph-ingest

Build a TYPED citation/reference graph over an ingested corpus — not just embeddings. Flat similarity retrieval cannot tell you that document A *overrules* B, *distinguishes* C, or *relies_on* D. This skill extracts every inter-document reference, classifies the edge TYPE with LLM judgment, and writes first-class typed edges via `gbrain link`, so `gbrain graph-query --type` can walk the argument ("everything this brief relies on, minus anything overruled since"). Every cite-heavy corpus is the same shape: law, academic papers, patents, regulatory filings, a book's bibliography.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary operational skill body: fully executable native commands, a hard verification gate with failure-recovery paths, and an honest limitations section, all assuming Claude's competence without padding. The only deductions are minor redundancy between the Contract and Anti-Patterns sections and slightly imperfect content placement for a single-file skill with no bundle.

DimensionReasoningScore

Conciseness

The body is dense and gbrain-specific throughout — no explanations of concepts Claude already knows, and every section carries non-obvious operational detail (provenance tag rules, exact-match `--type` semantics, edge-uniqueness keys). Minor over-explanation remains: the Contract and Anti-Patterns sections repeat several points (relational-recall limitation, test-before-bulk, source scoping), which fits the 4 anchor (efficient, minor instances that could be trimmed) rather than the lean 5.

4 / 5

Actionability

Copy-paste-ready commands throughout: `gbrain link doc-b-example doc-a-example --link-type extends --link-source citation-graph --context ... --source <corpus-source>`, `gbrain graph-query ... --type overrules --direction in`, plus `link-sources` and `check-backlinks` hygiene, a worked synthetic fixture, and a concrete output-format template. Fully executable guidance covering the common cases, matching the 5 anchor; the judgment steps (detect/classify) are instruction-only but name the exact tools (`gbrain search`, `get_page`, `resolve_slugs`) and are actionable.

5 / 5

Workflow Clarity

A clearly sequenced 5-step pipeline (preflight → detect → classify → write → verify → hygiene) with an explicit hard validation gate ("The run is not complete until a `graph-query` walk... No verified walk = the run reports failure"), failure-recovery guidance for specific errors (`page_not_found`, `sync_in_progress`/`lock_busy`), and a test-before-bulk checkpoint. This matches the 5 anchor (explicit validation, feedback loops, checklist-style process) — the batch-operation cap does not apply because validation is present.

5 / 5

Progressive Disclosure

Well-organized single-file skill with clear sections (What it is / Contract / Pipeline / Run it / Output Format / When it fails / Anti-Patterns / Dedup) and clearly signaled one-level-deep references to shared convention files at the top. It fits the 4 anchor (good structure, references mostly clear, minor gaps) rather than 5 because the conventions live outside the skill directory and a couple of sections (Dedup, Anti-Patterns) could arguably be externalized if the skill grows.

4 / 5

Total

18

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A highly specific, distinctive description that names concrete actions and the exact retrieval surface, but it omits an explicit "Use when..." trigger clause from the description field itself (trigger guidance sits in a separate frontmatter `when_to_use`/`triggers` block). Trigger-term coverage is good though missing a few natural synonyms. Overall strong with one structural gap.

Suggestions

Fold an explicit 'Use when...' clause into the description field itself (e.g. 'Use when the user asks to build a citation or reference graph, trace who cites whom, or reason over a cite-heavy corpus') so consumers reading only the description see the trigger guidance.

Add a few natural trigger synonyms users would actually say — 'map citations', 'who cites whom', 'citation analysis' — to broaden keyword coverage.

Trim the rhetorical framing ('not just embeddings', the flat-similarity contrast) to reduce length without losing specificity.

DimensionReasoningScore

Specificity

Quotes multiple concrete actions — "extracts every inter-document reference, classifies the edge TYPE with LLM judgment, and writes first-class typed edges via `gbrain link`" plus the `graph-query --type` retrieval surface — comprehensively covering the pipeline. This matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); it is not 4 because no meaningful capability is left out.

5 / 5

Completeness

The description field has a clear, explicit "what" but the "when" is only weakly implied by "Every cite-heavy corpus is the same shape: law, academic papers, patents..." — there is no "Use when..." clause in the description itself, which per the rubric caps completeness at 3. It is not 4 because the trigger guidance lives in a separate frontmatter `when_to_use` field outside the evaluated target, not in the description.

3 / 5

Trigger Term Quality

Natural terms present: "citation/reference graph", "overrules", "distinguishes", "relies_on", plus domain keywords ("law, academic papers, patents, regulatory filings, a book's bibliography"). Good coverage but a few natural user phrases are missing (e.g. "map citations", "who cites whom", "citation analysis"), so it fits the 4 anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche — typed citation edges ("overrules / distinguishes / relies_on") written via `gbrain link` over an ingested corpus — with triggers no other generic skill would claim. Minimal conflict risk, matching the 5 anchor; it is not 4 because even closely related skills (citation formatting, claim verification) would not naturally fire on these phrases.

5 / 5

Total

17

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 7 suspicious

Warning

Total

14

/

16

Passed

Repository

garrytan/gbrain

Path

plugin/skills/citation-graph-ingest/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.