Phd Deepread Workflow banner
heleninsights-dot heleninsights-dot

Phd Deepread Workflow

Documentation community

Description

A professinal CLI workflow for PhD students to extract, analyze, and visualize academic papers into structured Markdown and Obsidian Canvas.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

PhD Deep Read Workflow

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![PyPI version](https://badge.fury.io/py/phd-deepread-workflow.svg)](https://pypi.org/project/phd-deepread-workflow/) [![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/) [![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Skill-6E56CF)](https://claude.com/claude-code) [![Codex Skill](https://img.shields.io/badge/Codex-Skill-000000)](https://openai.com/codex) [![中文版本](https://img.shields.io/badge/README-%E4%B8%AD%E6%96%87%E7%89%88-green)](README.zh-CN.md)

Transform academic PDFs into structured literature notes and critical-thinking canvases for Obsidian.


*"The human mind... operates by association. With one item in its grasp, it snaps instantly to the next that is suggested by the association of thoughts."* — Vannevar Bush, *As We May Think*, 1945

Bush imagined this in 1945 — a desk where all your reading lives outside its original containers, ready for you to build trails of association through it. That's what this workflow is.

**Step one:** Convert the PDF to Markdown. The knowledge leaves the frozen PDF and becomes something you can return to, search, and connect — today, next month, next year.

**Step two:** Come back anytime and draw out what's relevant now. Connect ideas across papers. Visualize arguments, evidence, and assumptions side by side in an Obsidian canvas. The literature note captures what's there. The canvas lets you see it alongside everything else you know.


Prerequisites

You need both of these:

  • A skill-capable AI coding agent — either Claude Code (download here) or Codex. This workflow installs as a skill in whichever one you use.
  • Obsidiandownload here. The final output is a JSON canvas file that only renders in Obsidian.

If you just want AI h