obsidian-literature-workflow

Manages Zotero-to-Obsidian literature notes, synthesis, and canvas graph generation.

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill obsidian-literature-workflow-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-literature-workflow
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/obsidian-literature-workflow
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill obsidian-literature-workflow-tamagusko

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Keeping academic paper notes consistent inside an Obsidian research vault is tedious: Zotero metadata must be ingested, paper notes normalized to a shared schema, synthesis notes maintained, and a visual literature map refreshed after every batch of new papers. ## Core Features & Use Cases - Zotero ingestion and note normalization: Pulls papers from Zotero into canonical Papers/*.md notes with a standardized frontmatter schema (claim, method, evidence, limitation, relevance). - Literature synthesis: Maintains durable synthesis notes in Knowledge/ such as Literature-Overview, Method-Families, and Research-Gaps. - Canvas graph generation: Builds Maps/literature.canvas, an argument-map style Obsidian canvas grouping papers by subfield with thinned claim/method/gap edges, plus a legacy Mermaid map option. - Use Case: After importing 30 new Zotero entries for a project, run the workflow to create one note per paper, update the knowledge synthesis notes, and regenerate the literature canvas showing how papers relate. ## Quick Start Ask the assistant to read the papers from Zotero, create normalized notes under Papers/, and refresh the literature canvas for the current project vault.

Frequently Asked Questions about obsidian-literature-workflow

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

FAQPage Schema
How do I import Zotero papers into an Obsidian vault?

Use the zotero-obsidian-bridge skill to pull Zotero items into canonical Papers/*.md notes, using zotero_key as the durable join key. The literature workflow then normalizes metadata and structure across the collection.

How to generate an Obsidian canvas graph from paper notes?

Run the build_literature_canvas.py script against the bound project vault. It parses paper-note frontmatter and wikilinks, groups papers by subfield, and writes Maps/literature.canvas with thinned claim, method, and gap edges.

Does this workflow require the Obsidian MCP server?

No, all note reading and writing happens directly through the filesystem. The vault is treated as plain Markdown files, so no Obsidian MCP or running Obsidian instance is required.

What frontmatter schema should Obsidian paper notes use?

Each paper note needs type, title, project, authors, year, venue, citekey, status, and updated fields, plus optional keywords, concepts, methods, related_papers, and linked_knowledge lists for graph mapping.

When should the literature canvas be refreshed?

Refresh it after new Zotero-sourced notes are added, paper notes gain new linked_knowledge edges, synthesis notes are updated, or a batch ingestion or normalization pass finishes.