pi-interactive-reading

A Pi skill for section-by-section guided reading of any document.

What it does

Breaks papers, articles, books, and technical docs into digestible chunks. After each chunk, it checks your comprehension, highlights key concepts, makes connections to earlier material, and adapts pacing to how you're doing.

Features

• Chunk-by-chunk reading — fine-grained chunks (under 7 sentences by default), no info overload
• Comprehension checks — quizzes after each section, scaled to chunk size (1~2 questions on small chunks)
• Plain-language rewrite — dense chunks (papers, dense docs) are rewritten into short plain sentences by default; original wording available on request
• Progress tracking — progress_<title>_<date>.json per source, so you can resume where you left off
• Adaptive pacing — shrinks chunks if you struggle, combines them if you breeze through
• Multi-language — matches whatever language you respond in
• Spoken sources — YouTube/podcast transcripts get cleaned of filler and off-topic noise, then rewritten as short key-point chunks

User Controls

Command	Action
next / n	Move to next chunk
skip	Skip current chunk
expand	Go deeper on the current chunk
explain	Skip the quiz this time; explain the chunk instead
original	Show the original, un-rewritten text of the current chunk
summarize	Summarize everything covered so far
overview	Show outline of remaining content
back	Go back one chunk
quit / q	End session, save progress

Install

# From npm (once published)
pi install npm:@3dalgolab/pi-interactive-reading

# From git
pi install git:github.com/3DAlgoLab/pi-interactive-reading

# Local path
pi install /path/to/pi-interactive-reading

License

MIT