ryannli/immersive-reading
ryannli/immersive-reading has 49 GitHub stars and 6 forks. GitHot measured 0 stars in 24 hours and +1 in 7 days. Last checked 2026-11-09 19:48 UTC. Last push 2026-07-01.
Turn dense long-form ideas into immersive Reading Editions.
Measured star growth
- in 24h
- 0
- in 7 days
- +1
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
README.md
OriginalImmersive Reading
Turn dense long-form ideas into bespoke learning spaces that are delightful to explore.
Bring a link, essay, transcript, note, or paper. Get back a polished learning space with chapters, source attribution, search, highlights, notes, and optional bilingual support.
Not A Summary. A Co-Reading Space.
Example: Paul Graham's epic essay, How to Do Great Work.
| Before | After |
|---|---|
![]() |
![]() |
| Open original essay | Open live reading space · Watch the X post |
What It Builds
|
01 · BRING Source material Essays, posts, transcripts, notes, papers, URLs, or local files. raw text link file |
02 · SHAPE Agent-built structure Chapters, section beats, anchor quotes, source media, and optional study language. chapters quotes media |
03 · OPEN Interactive learning space A static reader with search, highlights, notes, attribution, and theme support. search highlights notes |
|
READING FLOW Turn dense text into a path. Chapter openings, section beats, anchor quotes, and scroll-driven transitions. |
STUDY SURFACE Make the source usable. Search, highlights, notes, copyable notes, optional bilingual support, and light/dark mode. |
REUSABLE SCAFFOLD Ship the same quality again. Validated article data, source media, and static output ready for local use or Vercel. |
Quick Start
Claude Code
Install and run it as a Claude Code plugin. Send these as four separate Claude Code messages:
/plugin marketplace add ryannli/immersive-reading
/plugin install immersive-reading@immersive-reading
/reload-plugins
/immersive-reading:immersive-reading
Then paste any essay, post, transcript, note, paper, URL, or local file you want to turn into a learning space.
Or install it as an open agent skill:
npx skills add ryannli/immersive-reading
Choose Claude Code if the installer asks. Then start a new Claude Code session
and ask for immersive-reading.
No-prompt install:
npx skills add ryannli/immersive-reading -g -a claude-code -y
Codex
Install the skill into your local Codex skills folder:
npx skills add ryannli/immersive-reading
Choose Codex if the installer asks. Then start a new Codex session and use:
Use $immersive-reading on this article:
https://paulgraham.com/greatwork.html
Cursor
Install the skill into Cursor:
npx skills add ryannli/immersive-reading
Choose Cursor if the installer asks.
Antigravity CLI
agy plugin install https://github.com/ryannli/immersive-reading.git
Other SKILL.md-compatible agents
The Skills CLI can install this repo into supported coding agents. It fetches
the skills/immersive-reading folder directly from GitHub; this repo does not
need to be published as an npm package.
Replace codex with your agent name:
npx skills add ryannli/immersive-reading -g -a codex -y
Start With Anything
Use $immersive-reading on this article:
https://paulgraham.com/greatwork.html
For bilingual reading:
Use $immersive-reading on this link and add Spanish bilingual mode:
https://paulgraham.com/greatwork.html
You can also paste text or point to a local file. The agent chooses where to create the site and tells you when it is ready.
License
MIT.
Explore related projects
sindresorhus/awesome
😎 Awesome lists about all kinds of interesting topics [NOTE: Pull requests are temporarily disabled until I have a chance to catch up with the existing ones]
534,755 starsEbookFoundation/free-programming-books
:books: Freely available programming books
401,452 starsnilbuild/developer-roadmap
Interactive roadmaps, guides and other educational content to help developers grow in their careers.
371,743 starsvinta/awesome-python
The definitive list that answers "I want to do X in Python, which tool should I use?"
333,807 stars
