Skip to content
cccskills
FreePublished on GitHub

obsidian-literature-workflow

Organize paper notes in an Obsidian project vault and synthesize them into lasting literature summaries. It standardizes review sections, tracks collection coverage, connects papers to project knowledge, and refreshes a visual literature map through filesystem operations.

OriginalShow the original description

Use this skill when the user keeps paper notes inside an Obsidian project knowledge base and wants filesystem-first literature review, explicit agent-first Zotero ingestion, `Papers/` plus `Knowledge/` synthesis, collection-wide normalization, and a default literature canvas without Obsidian MCP.

Works withObsidian

Run score Not tested

See how to install

Good for

  • Standardizing existing paper notes
  • Importing Zotero papers into an Obsidian vault
  • Summarizing methods and research gaps
  • Checking collection coverage and mapping paper relationships

Files included (6)

  • SKILL.md3.8 KB
  • references/CANVAS-WORKFLOW.md1.7 KB
  • references/GRAPH-WORKFLOW.md768 B
  • references/PAPER-NOTE-SCHEMA.md1.3 KB
  • scripts/build_literature_canvas.py22.6 KB
  • scripts/build_literature_graph.py9.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Obsidian Literature Workflow

Handle the literature sub-workflow inside the filesystem-first Obsidian project knowledge base.

Role in the workflow

This is a supporting skill under obsidian-project-memory.

Use it when the user says things like:

  • “My papers are in Obsidian”
  • “Read papers from Zotero and create notes in the vault”
  • “Review the notes under Papers/”
  • “Generate literature knowledge notes from this project vault”
  • “Connect paper notes to project knowledge”
  • “Show me the literature structure as a map/graph”
  • “Check whether all papers already have detailed notes”

Assumptions

  • The project is already bound through .claude/project-memory/registry.yaml, or can be imported with obsidian-project-bootstrap
  • Durable paper notes live under Papers/ inside Research/{project-slug}/
  • Obsidian note writing is done through the filesystem; no Obsidian MCP is required
  • Zotero may still be used as the source of metadata/full text; use $zotero-obsidian-bridge when the source corpus is in Zotero

Default workflow

  1. Read bound project memory and locate the vault root.
  2. If the source papers are in Zotero, explicitly use $zotero-obsidian-bridge to pull them into canonical Papers/*.md notes.
  3. Scan Papers/ and adjacent synthesis notes using filesystem tools.
  4. Normalize note metadata and structure using $obsidian-markdown.
    • Prefer the standardized review schema:
      • Claim
      • Method
      • Evidence
      • Limitation
      • Direct relevance to repo
      • Relation to other papers
  5. Query narrowly first:
    • read the relevant paper notes,
    • then the linked Knowledge/ notes,
    • and only then open Writing/ if the user asked for a review or comparison deliverable.
  6. Prefer updating existing paper notes and literature synthesis notes over creating sibling notes.
  7. Default literature synthesis should land in Knowledge/, not Experiments/ or Results/:
    • update Knowledge/Literature-Overview.md
    • update Knowledge/Method-Families.md
    • update Knowledge/Research-Gaps.md when the synthesis is stable enough to deserve canonical notes.
  8. If the source is a named collection and the user cares about completeness, maintain a collection inventory note with explicit coverage mapping.
  9. Refresh Maps/literature.canvas after major paper-note changes or batch note creation.
    • Prefer argument-map structure over dense all-to-all links.
    • Prefer semantic filtering and edge thinning.
    • Create Maps/literature-main.canvas only when a lightweight presentation graph is needed.
  10. Update the daily note and project memory with what changed.

Default outputs

  • Papers/ remains first-class: one durable paper note per paper whenever possible
  • Knowledge/ holds durable literature synthesis notes
  • Maps/literature.canvas is the default visual graph surface
  • literature work should usually produce at least one of:
    • new or updated paper notes,
    • new or updated knowledge notes,
    • literature-canvas refresh,
    • optional writing synthesis when requested

Default stance

Do not assume by default:

  • Concepts/
  • Datasets/
  • .base views

The literature workflow may create Maps/literature.canvas by default. Other artifacts still require explicit justification.

References

Load only what is needed:

  • references/PAPER-NOTE-SCHEMA.md - detailed paper-note frontmatter and sections
  • references/CANVAS-WORKFLOW.md - how and when to refresh Maps/literature.canvas

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a1

FreeSummary

Turn a broad research idea into clear, testable questions. Compare familiar and less conventional approaches, structure the selected question around its population and methods, and assess variables, feasibility, and potential theoretical contributions.

  • Turn a research topic into testable questions
  • Narrow an overly broad research question
  • Compare alternative research angles
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

a2

FreeSummary

Helps build a research framework by comparing theories, mapping relationships between variables, and deriving testable hypotheses. Explores less conventional options, examines weaknesses and competing explanations, and produces diagrams with anticipated reviewer objections.

  • Comparing theories for a research question
  • Deriving hypotheses from relationships between variables
  • Examining weaknesses and anticipated reviewer objections
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

a5

FreeSummary

Clarify the philosophical assumptions behind a research project and check whether they fit the proposed methods. Get a reasoned research stance, draft proposal wording, and guidance for explaining how the researcher's background and values shape the study.

  • Clarifying philosophical foundations for a research proposal
  • Explaining why the chosen research methods fit the study
  • Drafting a statement about the researcher's position
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

academic-paper

FreeSummary

Plan and draft academic papers through specialized agent roles covering literature, arguments, citations, and review. Get chapter guidance, revision roadmaps, Traditional Chinese and English abstracts, and documents formatted as LaTeX, DOCX, PDF, or Markdown.

  • Planning a paper chapter by chapter
  • Drafting a paper from research materials
  • Turning reviewer comments into a revision roadmap
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

Turn a detailed outline into a philosophy or interdisciplinary manuscript. Draft chapters with repeated quality reviews, check terminology and arguments across sections, and prepare the manuscript, evaluation reports, abstract, and metadata for submission.

  • Draft a full paper from a detailed outline
  • Review argument and citation quality chapter by chapter
  • Check terminology and argument flow across chapters
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

Simulate academic peer review through five reviewer roles tailored to the paper's field. Receive separate critiques, an editorial decision, and a prioritized revision roadmap, or check whether a revised manuscript addresses earlier comments.

  • Review a manuscript before journal submission
  • Examine research methods and statistical validity
  • Challenge core arguments and alternative explanations
brycewang-stanford/Auto-Empirical-Research-Skills4.8KUpdated Oct 20, 2026

See all skills by brycewang-stanford

Report a problem with this skill