paper-glossary

Generate reviewed Obsidian glossary notes from paper source manifests with provenance validation.

1.0k|71|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/917Dhj/DeepPaperNote --skill paper-glossary
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-glossary
Source: https://github.com/917Dhj/DeepPaperNote/tree/main/skills/paper-glossary
Command: npx skills add https://github.com/917Dhj/DeepPaperNote --skill paper-glossary

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Turning a research paper into reusable glossary notes requires manually identifying key terms, writing definitions, and linking them back into article Markdown, which is repetitive and error-prone. This Skill automates that pipeline while enforcing a human review step before any note or article is modified.

Core Features & Use Cases

  • Deterministic Term Proposal: Extracts candidate terms with ordered surface forms from *_source_manifest.json and optional *_raw_sections.jsonl, bounded by a dynamic shortlist limit.
  • Review-Gated Writes: Requires a recorded semantic review and explicit user selection before triage, inventory, writing, or linking can proceed; every stage validates SHA-256 provenance chains.
  • Non-Destructive Note Management: Creates new glossary notes, enriches thin notes with only missing fields, and never overwrites existing content; optionally inserts first-safe-occurrence wiki links into an article.
  • Use Case: After reading a paper with DeepPaperNote, run this Skill to build a shared Obsidian glossary of terms like "MoE", review the shortlist, select terms, and have notes created and linked in your vault automatically.

Quick Start

Ask the agent to build glossary notes from your paper's source manifest, review the numbered shortlist it presents, and reply with the numbers of the terms you want written to your Obsidian vault.

Frequently Asked Questions about paper-glossary

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

FAQPage Schema
How do I generate Obsidian glossary notes from a paper?

Provide the paper's source manifest JSON to the proposal script, review the numbered candidate shortlist it presents, then select terms by number. The skill triages, inventories, writes, and optionally links the selected terms in your configured vault glossary directory.

How do I configure the glossary term directory?

Run configure_glossary.py with --terms-dir pointing to a directory inside an Obsidian vault containing a .obsidian folder. This writes a device-local config at ~/.paper-glossary/config.json that later runs reuse automatically.

Does this skill overwrite existing glossary notes?

No, existing notes are never replaced. Thin notes receive only missing structured fields and a missing occurrence, complete notes receive at most a missing occurrence, and all writes pass a whole-batch preflight before commit.

Can it add wiki links to my article Markdown?

Yes, when you supply an explicit article Markdown path in the same vault, the linker inserts one first-safe-occurrence wiki link per term. It skips code blocks, headings, existing links, and reference sections, and verifies the article hash before modifying it.

What happens if the review produces no candidates?

The workflow reports a no_candidates terminal state and stops without displaying an empty selector. No glossary notes or article Markdown are written in that case.

Why does the writer or linker fail with a provenance error?

Each stage recomputes the proposal, review, and selection digests against the current source manifest and saved artifacts. Any mismatch in paper ID, source hash, term order, or surface forms causes a fail-closed rejection to prevent unauthorized writes.