Skip to content
Back to search

Papermorph

An AI skill that turns books into animated, narrated, interactive web experiences

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/DozenTwelve/Papermorph with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/DozenTwelve/Papermorph'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dozentwelve--papermorph/badge.svg)](/listings/dozentwelve--papermorph)

HTML

<a href="/listings/dozentwelve--papermorph"><img src="/api/listings/dozentwelve--papermorph/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 120 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <a href="https://papermorph.diamonddoge.org/">
  3. <img src="img/readme/bookshelf.webp" alt="The Papermorph bookshelf: lessons, picture books, documentaries and interactive pages on a birch shelf" width="420">
  4. </a>
  5. </p>
  6. <p align="center">
  7. <strong>An agent skill that turns textbooks into narrated, interactive web lessons,<br>stories into paper-puppet films, and books into documentaries, upright shorts and pages you explore.</strong>
  8. </p>
  9. <p align="center">
  10. <a href="https://papermorph.diamonddoge.org/">Open the live bookshelf →</a>
  11. ·
  12. <a href=".claude/skills/papermorph/SKILL.md">Read the Skill →</a>
  13. ·
  14. <a href="https://papermorph.diamonddoge.org/work/">Work with us</a>
  15. </p>
  16. > **1,000 stars.** Thank you to everyone who starred Papermorph, tried the Skill, filed issues and sent pull requests. The first roadmap is done; the next is [below](#roadmap).
  17. Everything is a static web page: no server, no database, no account. A book is a folder you can host anywhere.
  18. ## On the shelf
  19. ### Lessons, from a textbook PDF
  20. Formulas, diagrams and scenes change step by step as the narration explains, with quick checks and chapter practice that grade the maths, not the string.
  21. [Elementary Algebra](https://papermorph.diamonddoge.org/elementary-algebra/) (68 chapters) · [Linear Algebra](https://papermorph.diamonddoge.org/linear-algebra/) (40, planes you can drag in 3D) · [Elementary Mathematics](https://papermorph.diamonddoge.org/math-notebook/) (23) · [Elementary Physics](https://papermorph.diamonddoge.org/science/) (9)
  22. <p align="center">
  23. <a href="https://papermorph.diamonddoge.org/linear-algebra/ch12/"><img src="img/readme/linear-algebra.webp" alt="Linear Algebra: three equations become three planes in 3D, drawn in one by one" width="49%"></a>
  24. <a href="https://papermorph.diamonddoge.org/science/ch12/"><img src="img/readme/physics.webp" alt="Elementary Physics: one fixed pulley changes the direction of the pull; two pulleys halve the force" width="49%"></a>
  25. </p>
  26. ### Picture books, from a story, a joke or a fairy tale
  27. Paper puppets in front of sets drawn in code or painted by an image model, with acted voices, subtitles, sound effects, music and camera work. For children who can't read yet, the film stops for a game: a character asks for one thing at a time, the child touches it in the picture, and nothing is ever called wrong. A scanned picture book can bring its own art: the figures, sets and hand lettering are cut from the pages and moved as puppets.
  28. [The Little Horse Crosses the River](https://papermorph.diamonddoge.org/little-horse/) (小马过河) · [Little Red Riding Hood](https://papermorph.diamonddoge.org/little-red-riding-hood/) · [Millions of Cats](https://papermorph.diamonddoge.org/millions-of-cats/) (Wanda Gág, 1928, cut from the book's own pages) · [Joke Collection](https://papermorph.diamonddoge.org/joke-collection/) (7 episodes)
  29. <p align="center">
  30. <a href="https://papermorph.diamonddoge.org/little-horse/ch01/"><img src="img/readme/little-horse.webp" alt="The Little Horse Crosses the River: by the river the foal asks for the bird; a tap on the ox says 'ox', a tap on the bird finds it" width="49%"></a>
  31. <a href="https://papermorph.diamonddoge.org/little-red-riding-hood/ch01/"><img src="img/readme/red-riding-hood.webp" alt="Little Red Riding Hood: the wolf in Grandma's cap and glasses, closer with every question, then the lunge" width="49%"></a>
  32. </p>
  33. ### Documentaries and upright shorts, from a book or an idea
  34. Public-domain engravings, paintings, maps and charts, moved in step with the voice, with music. A documentary can be recut as a series of upright shorts for a phone feed.
  35. [Madness and Civilization](https://papermorph.diamonddoge.org/madness/) (10 minutes, and 4 shorts) · [The Pandemic](https://papermorph.diamonddoge.org/pandemic/) (7 minutes, 6 shorts and a scroll story)
  36. <p align="center">
  37. <a href="https://papermorph.diamonddoge.org/pandemic/ch01/"><img src="img/readme/pandemic.webp" alt="The Pandemic: a world map and charts of cases and deaths as the Delta wave rises" width="73%"></a>
  38. <a href="https://papermorph.diamonddoge.org/pandemic-shorts/ch01/"><img src="img/readme/pandemic-short.webp" alt="The Pandemic as a short: Wuhan closes at 10:00 while a clock and a counter run" width="23%"></a>
  39. </p>
  40. ### Pages you play
  41. A film can stop and hand the reader the next move, a map can be walked a year at a time, and a story can unfold as the reader scrolls. The Skill makes all three: explorable maps and scroll stories have their own starting kits.
  42. [Shooting an Elephant](https://papermorph.diamonddoge.org/shooting-an-elephant/) (Orwell's essay; you hold the rifle) · [Explorable maps](https://papermorph.diamonddoge.org/maps/): [Time of the Magicians](https://papermorph.diamonddoge.org/time-of-the-magicians/) (Europe 1919–1929, four philosophers on the map) and [The Map Redrawn](https://papermorph.diamonddoge.org/meiji/) (Japan 1868–1878) · [The Pandemic as a scroll story](https://papermorph.diamonddoge.org/pandemic-scroll/)
  43. <p align="center">
  44. <a href="https://papermorph.diamonddoge.org/shooting-an-elephant/"><img src="img/readme/elephant.webp" alt="Shooting an Elephant: where to aim, then the view through the rifle sight, click to fire" width="49%"></a>
  45. <a href="https://papermorph.diamonddoge.org/time-of-the-magicians/"><img src="img/readme/magicians.webp" alt="Time of the Magicians: a map of Europe in 1919, the four philosophers walking their routes" width="49%"></a>
  46. </p>
  47. ## Get started
  48. Install the Skill in your project, for Claude Code or OpenCode:
  49. ```bash
  50. npx skills add DozenTwelve/Papermorph --skill papermorph --agent claude-code # or --agent opencode
  51. ```
  52. Then type `/papermorph`. It finds the PDF in your project (or asks for your story), tells you what kind of book it is, suggests a chapter to try first and how much animation it needs, and offers a recommended option at every step. Your choices are saved in `style.json`, so every later chapter is made to the same style.
  53. In OpenCode, a clone of this repository already has the command (`.opencode/commands/papermorph.md`) and the Skill; with a global install, copy that file to `~/.config/opencode/commands/`.
  54. You need [uv](https://docs.astral.sh/uv/), ffmpeg, and Playwright's browsers (`uv run --with playwright playwright install chromium firefox`). Narration uses Edge TTS (online) or Kokoro (local), free. A few steps are paid, optional and need an API key: acted ElevenLabs voices for picture books and documentaries, clips made from a still ([OpenRouter](https://openrouter.ai/)), and painted sets for picture books (OpenRouter or OpenAI). The newest picture books cost under $0.45 each in voices.
  55. ## How it works
  56. A book is planned before it is drawn: chapters or scenes, then a script, then a storyboard. The narration is voiced and every word gets a time, and the picture is animated to those times. The model then watches its own output (contact sheets, overlap and blank-frame checks, end-to-end tests, a director's review against approved books) and fixes what it sees. Large chapters are made by a team of subagents, each step on the model you choose ([core/team.md](.claude/skills/papermorph/references/core/team.md)). The books on the shelf were made with Opus 5.5, GPT-6.1-Sol and Sonnet 5.5; an illustrated physics chapter costs about $10–18 of model usage.
  57. Every book plays in the same player: pause anywhere, step back and forth, speed, captions, keyboard shortcuts, and progress saved per book, with the interface in English, Russian, Chinese, Japanese or Arabic (right to left). The player lives in [`engine/`](engine) and every book keeps its own copy, so a book never breaks when the engine changes; `scripts/engine.py site` updates them from the latest release (`--from you/your-fork@main` from your own).
  58. Any chapter or episode also renders to a 1080p MP4 with an `.srt`, frame by frame from the lesson clock (`scripts/export.py`), and a book can be packaged for an LMS as SCORM (`scripts/scorm.py`, [courses.md](.claude/skills/papermorph/references/lessons/courses.md)).
  59. ## Roadmap
  60. The first roadmap is done: maths books, science books, picture books, a model of your choice for every step, documentaries, and upright shorts. So are picture books for children who can't read yet: layered paper sets, four-legged puppets and listen-and-find games, in *The Little Horse* and the second *Little Red Riding Hood*; and a picture book cut from a scanned book's own pages, *Millions of Cats*. A rifle, explorable maps and a scroll story came along the way, and the Skill now makes the maps and scroll stories too. Next:
  61. - **More from a PDF of pictures.** *Millions of Cats* cut its figures into puppets; next, tap to hear names over the painting and layers that drift in parallax. For your own books or a publisher's; our own examples use public-domain books or pictures we draw.
  62. - **Lessons with their own examples.** The textbook sets what is taught, in what order and how hard; the Skill writes new worked examples and exercises, with answers computed in code, so nothing is copied from the book.
  63. - **One source, every shape.** A single Wikipedia article made into a documentary, shorts, an interactive page and a scroll story, side by side.
  64. - **Elementary Physics, remade** with what the newer books can do.
  65. ## Working with us
  66. The shelf is a set of examples: the shapes that suit a maths book, a language course, a picture book or a documentary, and one source can take several of them (*The Pandemic* is a film, six shorts and a scroll story). For publishers, schools and studios we build the pipeline around your own titles and your own style. See [the work page](https://papermorph.diamonddoge.org/work/), or write to [a972848363@gmail.com](mailto:a972848363@gmail.com) with what the titles are, who they are for, and how many you have in mind.
  67. ## FAQ
  68. **How is this different from Claude Motion?** [Claude Motion](https://claude.com/resources/articles/dashboards-and-motion) makes animated explainers. Papermorph makes whole books: many chapters in one consistent style, quizzes that are graded, progress that is saved, and a static site you own and can host anywhere.
  69. **Can I make a book from any PDF?** Yes, for your own use. The finished book contains new explanations and drawings, not the PDF's pages, but publishing a book based on someone else's textbook is your call to check.
  70. ## Contributing
  71. Fixes to the Skill and the player are welcome. Please don't open pull requests that add a copyrighted book, its PDF, or lessons made from one. Agents and people changing the repository: start with [AGENTS.md](AGENTS.md).
  72. To try the examples locally:
  73. ```bash
  74. git clone --depth 1 https://github.com/DozenTwelve/Papermorph.git
  75. cd Papermorph
  76. python3 .claude/skills/papermorph/scripts/serve.py 8765 site # then open http://localhost:8765/
  77. ```
  78. ## License
  79. [MIT](LICENSE). The bundled MathJax (`engine/vendor/mathjax`) is under the Apache License 2.0. The MIT licence covers the code. Pictures, recordings and data under `site/` keep their own licences, listed beside them (for example `site/pandemic/img/SOURCES.md`); toned copies of CC BY-SA pictures stay CC BY-SA.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.