obsidian-literature-review

Organize papers, notes, PDFs, and citation graphs inside Obsidian vaults.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/ryan-ressmeyer/agent-config --skill obsidian-literature-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: obsidian-literature-review
Source: https://github.com/ryan-ressmeyer/agent-config/tree/main/skills/obsidian-literature-review
Command: npx skills add https://github.com/ryan-ressmeyer/agent-config --skill obsidian-literature-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pyyaml, and includes scripts (resource) components.

What problem does it solve?

Vault-based literature management inside Ryan's Obsidian vault: it coordinates adding papers (DOI/PMID/arxiv/PDF), summarizing them as citekey notes with embedded PDFs, searching, and checking integrity, all within a vault-native layout that uses References/ for notes, pdfs/ for embedded PDFs, and graph/ for citations.

Core Features & Use Cases

  • Vault-native intake: fetch metadata, create citekey notes, embed PDFs, and build citation graphs in a single vault.
  • Per-paper lifecycle: add new papers by DOI/PMID/arxiv/PDF, generate citekeys, generate or update notes, and update index.yaml.
  • Search and maintenance: query the vault's graph and notes to surface related papers and check data integrity.

Quick Start

Create a new citekey note with the required paper metadata to begin tracking a paper in the vault.

Frequently Asked Questions about obsidian-literature-review

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

FAQPage Schema
How do I organize research papers and PDFs inside my Obsidian vault?

This Skill manages literature reviews inside Obsidian by fetching metadata from DOI, PMID, arxiv, or PDF inputs, generating citekey notes, embedding PDFs, and updating index.yaml to track your references within a vault-native layout.

What's the best way to build a citation graph in Obsidian?

Building a citation graph in Obsidian is streamlined by this Skill's Python scripts, which automatically update graph folders and connect citekey notes based on fetched metadata, allowing you to explore citation relationships within a single vault layout.

Can I add papers to Obsidian using a DOI or arxiv ID?

Yes, you can add papers using DOI, PMID, arxiv, or PDF inputs. The Skill fetches the metadata for these identifiers and creates a new citekey note in the References folder while embedding the source PDF.

Do I need a specific folder structure to manage literature notes in Obsidian?

Yes, this Skill requires a specific vault layout to function correctly. It locates vault folders named References for notes, pdfs for embedded PDFs, and graph for citation relationships to perform its automated operations.

How does Obsidian literature management check data integrity for my notes?

Literature management data integrity is checked by querying the vault's graph and notes to surface related papers and verify consistency. The Skill's scripts read index.yaml and citekey notes to ensure your references are correctly tracked.