phd-deepread

Extract academic PDFs and generate Obsidian-ready notes with YAML frontmatter.

57|4|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/heleninsights-dot/phd-deepread-workflow --skill phd-deepread
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phd-deepread
Source: https://github.com/heleninsights-dot/phd-deepread-workflow/tree/main
Command: npx skills add https://github.com/heleninsights-dot/phd-deepread-workflow --skill phd-deepread

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires PyMuPDF, pytesseract, Pillow, and includes scripts (resource) components.

What problem does it solve?

Researchers and power users often spend excessive time turning academic PDFs into actionable, Obsidian-ready literature notes. This skill automates extraction, AI-assisted note generation, and critical-thinking canvases to streamline systematic reviews and knowledge-building workflows.

Core Features & Use Cases

  • Text-First PDF Extraction: Uses PyMuPDF for fast text extraction with optional OCR fallback (Tesseract) for scanned or complex pages.
  • Structured Note Generation: Template-driven generation that produces YAML frontmatter notes compatible with Dataview and Obsidian.
  • Critical-Thinking Canvases: 9-node JSON Canvas outputs for deep, structured critique and reasoning.
  • Workflow Automation: End-to-end orchestration of extract → generate → canvas, including batch processing.

Quick Start

Run phd-deepread extract paper.pdf to produce markdown_output, then run generate and canvas to complete the workflow.

Frequently Asked Questions about phd-deepread

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

FAQPage Schema
How do I convert academic PDFs into structured Obsidian literature notes?

Structured Obsidian literature notes are generated by extracting text via PyMuPDF and applying AI-assisted templates. This skill outputs markdown files with YAML frontmatter, Dataview callouts, and wikilinks, automating the extract-generate workflow for academic PDFs.

Does this PDF extraction tool support scanned documents or image-based pages?

Yes, scanned documents and image-based pages are supported via an OCR fallback. The skill uses PyMuPDF for fast text-first extraction, automatically falling back to Tesseract OCR when encountering complex or scanned pages that lack embedded text layers.

What is a JSON canvas for critical thinking and how does it help analyze research papers?

A JSON canvas for critical thinking is a structured nine-node visual layout that facilitates deep critique and reasoning. This skill generates these canvases to help users systematically deconstruct research papers, providing a structured framework for analyzing academic arguments and findings.

Can I batch process multiple PDFs for systematic literature reviews?

Yes, batch processing of multiple PDFs is supported for systematic literature reviews. The skill includes an end-to-end extract-generate-canvas workflow that applies to both single papers and batch processing, streamlining the extraction and note generation across multiple academic documents simultaneously.

Do I need Tesseract and Python libraries installed to extract text from PDFs?

Yes, you need Tesseract installed along with the PyMuPDF, pytesseract, and Pillow Python libraries. These dependencies are required for the core PDF extraction functionality, with pytesseract providing the OCR fallback for scanned academic documents.

How do I generate YAML frontmatter and Dataview callouts from a research paper?

Generating YAML frontmatter and Dataview callouts from a research paper requires running the generate command after PDF text extraction. The skill applies template-driven generation to produce Obsidian-compatible markdown notes, converting extracted text into structured metadata and visual callouts.