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.
Example: Paul Graham's epic essay, How to Do Great Work.
| Before | After |
|---|---|
 |
 |
| Open original essay | Open live reading space · Watch the X post |
|
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. |
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-readingChoose 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 -yCodex
Install the skill into your local Codex skills folder:
npx skills add ryannli/immersive-readingChoose 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-readingChoose Cursor if the installer asks.
Antigravity CLI
agy plugin install https://github.com/ryannli/immersive-reading.gitOther 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 -yUse $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.
MIT.