obsidian-literature-base

Installation
SKILL.md

Build an Obsidian literature base

Create a browse-focused catalogue over existing OmniScholar publications. Do not upload PDFs, re-run MinerU, or write to Zotero for this workflow.

Workflow

  1. Confirm the Obsidian vault root that contains OmniScholar publication folders and their metadata.json files.
  2. Discover valid publication sidecars (schemaVersion: 1 with publication and zotero objects). Treat the MinerU Markdown, Zotero reading record, and images in one publication directory as one paper.
  3. Derive topics in this order:
    • Extract Zotero tags prefixed with topic/ or 主题/, stripping the prefix.
    • Only for papers without prefixed topics, optionally assign 1–3 concise AI topics from title and abstract. Read the MinerU body only when those fields are insufficient.
    • Never write AI topics back to Zotero.
  4. When AI topics are needed, save a temporary JSON mapping described in references/schema.md. Then run scripts/build_literature_base.py with the vault root and optional mapping.
  5. When the user wants a knowledge Wiki, add --wiki. Generate topic pages only for topics shared by at least two papers unless the user chooses another threshold.
  6. Verify the generated .base is valid YAML and each generated literature-index.md links to the correct MinerU document, Zotero reading record, cover, image assets, and eligible topic pages.
  7. Report the Base path, indexed paper count, topic-source counts, Wiki page count, stale Wiki pages, and any papers without topics or images.

Resolve the deterministic script relative to this SKILL.md; do not assume the user's current directory is the Skill directory. Use it instead of reconstructing index notes or Base YAML manually:

Installs
3
GitHub Stars
5
First Seen
Oct 3, 2026