whatisgithub

What is deep-reading-coach?

fanpuyen/deep-reading-coach — explained in plain English

Analysis updated 2026-05-18

31PythonAudience · generalComplexity · 2/5Setup · easy

In one sentence

A Codex skill that acts as a reading coach, helping you preview, deeply analyze, compare, or plan your reading of books and PDFs.

Mindmap

mindmap
  root((deep reading coach))
    What it does
      Reading coach
      Codex skill
      Structures reading
    Modes
      Quick preview
      Deep breakdown
      Thematic research
      Reading plan
    Tech stack
      Python scripts
      PDF OCR tools
    Use cases
      Decide what to read
      Compare sources
      Build reading plan
    Audience
      Readers
      Researchers
      Book clubs

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Get a fast orientation on whether a book is worth reading and which chapters matter most.

USE CASE 2

Produce a full analytical breakdown of a book's central argument and key terms.

USE CASE 3

Compare several books or articles on the same topic and see where they agree or disagree.

USE CASE 4

Build a time-boxed reading plan when you only have a few hours to spend.

What is it built with?

PythonCodex

How does it compare?

fanpuyen/deep-reading-coachcoleam00/harness-engineering-democolor4-alt/citecheck
Stars313131
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Copy the whole skill folder (including scripts and references) into your Codex skills directory and restart Codex.

So what is it?

Deep Reading Coach is a skill for Codex, an AI coding and task assistant, that helps you read books and PDF documents more carefully and systematically. Rather than just summarizing what you give it, it acts as a structured reading guide that adapts its approach based on what you actually want to get out of a document. The README is written primarily in Chinese and draws heavily on the methodology from the Chinese translation of "How to Read a Book" by Mortimer Adler. The skill supports four main modes. The first, called Quick Preview, gives you a fast orientation: it tells you what a book is about, who it is for, which chapters are worth reading closely, and helps you decide whether to continue. The second mode, Deep Breakdown, is a full analytical reading that maps the author's central question and argument structure, identifies key terms and propositions, and builds a complete reading outline. The third mode, Thematic Research, lets you compare several books or articles on a single topic, building a neutral shared vocabulary and mapping where different sources agree or disagree. The fourth mode, Reading Plan, helps you when you have limited time, producing a schedule with priorities for which sections to read closely and which to skim. The skill also includes Python helper scripts for working with PDF files. One script diagnoses whether a PDF can be read as text or is a scanned image version. Others handle OCR using Windows built-in tools, Tesseract, or AI vision models for difficult scans. Installation means placing the entire skill folder in the Codex user skills directory (a specific path under your user profile), then restarting Codex so it loads the new skill. The README notes that the scripts folder must be included alongside the main skill definition file, since the PDF processing tools are part of how the skill works.

Copy-paste prompts

Prompt 1
Use deep-reading-coach to quickly preview this PDF and tell me which chapters are worth reading closely.
Prompt 2
Use deep-reading-coach to deeply break down this book's main argument, key concepts, and reasoning.
Prompt 3
Use deep-reading-coach to compare these three books on the same topic and map where they disagree.
Prompt 4
I only have two hours, use deep-reading-coach to plan the order I should read this book in.

Frequently asked questions

What is deep-reading-coach?

A Codex skill that acts as a reading coach, helping you preview, deeply analyze, compare, or plan your reading of books and PDFs.

What language is deep-reading-coach written in?

Mainly Python. The stack also includes Python, Codex.

How hard is deep-reading-coach to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is deep-reading-coach for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.