heleninsights-dot

Phd Deepread Workflow — Documentation skill for Claude Code

Documentation community

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

How to install Phd Deepread Workflow

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

What Phd Deepread Workflow does

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

Alternatives in Documentation

Docx — Create, edit, and analyze Word documents with tracked changes, comments, and formatting 94.1k ★
Repo Recap — Generate a structured recap of the repository state: open PRs, open issues, recent releases, and executive sum 11.9k ★
Ars Format Convert — ARS academic-paper format-convert mode — convert to LaTeX / DOCX / PDF / Markdown 4.5k ★

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.
Obsidian — download here. The final output is a JSON canvas file that only renders in Obsidian.

If you just want AI h