Engineering & AI
Papermorph turns textbook PDFs into interactive web lessons
Papermorph helps an AI agent turn a section of a textbook PDF into an animated web lesson with narration and automatically graded questions.
Summary
- Papermorph turns a section of a textbook PDF into an animated web lesson with automatically graded questions.
- The agent drafts a storyboard, generates narration, and syncs the visuals to the audio. The author reviews the lesson before publishing.
- Pilot one equation with a balance scale, then check the narration, answers, and phone playback.

To show students why you subtract the same number from both sides of an equation, use Papermorph to animate and narrate a worked example, then pause for a question. The project's Elementary Algebra demo shows how narration and questions fit into the lesson itself.
HubCom reviewed the Papermorph documentation at commit 839a62c and checked the engine v2.11 release on November 21, 2026. We have yet to run the pilot below or use Papermorph on a client project.
What does it solve?
- Teach a textbook example one step at a time. Choose a topic and let the agent draft an example, narration, and visuals that follow the solution.
- Ask a question at the right moment. Learners can stop at the step they are watching, answer, and continue. README
Features
- Storyboard and narration. The agent breaks the lesson into short segments, each tying a narration clip to an action on screen.
- Static web lesson. The output folder contains the lesson page, player, and audio for static hosting. Skill documentation

When to use it
Pick a lesson with a step students need to see, such as taking the same number of blocks off each side of a scale. If you plan to develop a whole chapter, approve one pilot lesson and save your choices for voice, visuals, and pacing in style.json. README
What to watch for
- Set up the runtime. Prepare
uv, FFmpeg, and Playwright browsers. The README lists online Edge TTS and local Kokoro as narration options. README - Keep source files in the working folder. Use a PDF you have permission to use and keep it and its extracted pages out of the published folder. Skill documentation
Trial setup
Write one or two PDF pages on linear equations. Ask the agent to illustrate 2x + 3 = 7 with a balance scale. After removing three blocks from each side, ask, “What is each x block worth?”
Steps
- Install the skill in your project. For Claude Code, run
npx skills add DozenTwelve/Papermorph --skill papermorph --agent claude-code. The README also covers OpenCode. README - Limit the pilot. Run
/papermorph, give it the PDF path, and ask for one lesson. Review the storyboard and answer before the agent builds the visuals. Skill documentation - Open the preview. Use the preview server described in the skill. Play from the beginning and answer at the pause. Skill documentation
Common mistakes
- Animation gets ahead of the narration. Listen for the instruction as three blocks disappear from each side.
- A correct answer gets marked wrong. Submit one correct answer and one incorrect answer to verify the feedback.
How to verify the result
- Compare each step with the source. After three blocks come off each side, the visuals and narration should lead to
2x = 4, thenx = 2. - Open it on desktop and phone. Start the narration, pause at the question, and resume after answering. On iPhone or iPad, listen for the narration after the pause too. Engine v2.11 release notes
- Review the publish folder. Serve the static lesson files and confirm the folder excludes the source PDF.
Out of scope
Picture books, MP4 export, and packaging lessons for an LMS.
Terms in this article (4)
- Papermorph
- A skill that guides an AI agent through creating interactive lessons, books, or stories for the web.
- Storyboard
- A sequence of sketches or notes showing what learners will see and hear in each segment.
- TTS
- Text-to-speech software that turns written text into spoken audio.
- Static web lesson
- A lesson served from ready-made files that can run interactions in the browser.
Frequently asked questions
Does Papermorph produce a video or a web lesson?
The pilot uses a static web lesson with interactive questions. The repository also supplies a script for exporting chapters as MP4 with subtitles.
Do I need an API key for the algebra pilot?
The README lists Edge TTS and Kokoro for narration. The agent still needs access to its model. Some paid voice, image, or clip options require a separate API key.
Sources
- Papermorph README, DozenTwelve
- Papermorph skill, DozenTwelve
- Elementary Algebra, DozenTwelve
- Papermorph Engine v2.11, DozenTwelve