SkillFoxx

Papermorph skill

A skill turns a book or story into narrated interactive chapters with animation, exercises and a consistent style

  • 1,598 ★ on the repository
  • Last commit
  • MIT
Skill

Extended access

Why this level

  • The skill executes build scripts and edits book files
  • Paid generation and voice services receive material through their APIs
  • The agent’s model reads the source-book content
All reasons and checks

dozentwelve/papermorphAuthor:DozenTwelve

Install

Manual install

npx skills add DozenTwelve/Papermorph --skill papermorph --agent claude-code

Invoke `/papermorph` in a project containing the source material after installation.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The skill executes build scripts and edits book files
  • Paid generation and voice services receive material through their APIs
  • The agent’s model reads the source-book content

This is third-party code. Review the repository files before installing.

What it does

The Papermorph skill guides an agent in building an interactive book from a PDF, story or idea. The agent proposes a chapter plan and selects a trial chapter. It then writes that chapter’s script and storyboard and aligns animation with narration. Textbooks can use visual explanations and graded exercises. Stories can become picture books, documentary episodes or vertical videos. The agent records the selected presentation in `style.json` and applies it to later chapters. The finished book runs as a static site with a player. Readers control speed, captions and navigation, with progress saved per book. Export scripts create an MP4 with subtitles or a SCORM package for a learning platform.

Who it is for. For teachers, learning-content authors and publishers who want to add animation, narration and exercises to written material.

Good fit when

  • A textbook chapter needs animation and exercises readers can check themselves
  • A story should become a narrated picture book
  • Several episodes need shared presentation and playback conventions
  • You need both a web lesson and a video for different distribution channels

Not a fit when

  • You only need PDF text extraction without script or presentation work
  • You plan to publish an adapted textbook without checking source-material rights
  • You need a finished course without reviewing chapters and checking their subject matter

Example request

Create a trial interactive lesson from my textbook’s first chapter, proposing the script and presentation before narration or image generation.

Limitations

Building requires uv, FFmpeg and Playwright browsers, installed separately from the skill. Narration and image or video generation can send material to external services and require paid API keys; inspect the chosen method before building. Frame checks find presentation defects, but a person must verify explanations and exercise answers. MIT covers code, while images, recordings and third-party libraries retain separate licenses; check reuse rights before publishing.

How to disable. Remove Papermorph from your agent’s skill directory. Remove its separately installed command in OpenCode as well. Generated books and exports remain in the project; review them before cleanup.

FAQ

How do I install Papermorph?

Run `npx skills add DozenTwelve/Papermorph --skill papermorph --agent claude-code`. For OpenCode choose `opencode`, then invoke `/papermorph`.

Do I need to publish the source PDF with the book?

No. The finished book uses its static files. Keep source PDFs, page images and extracted text outside the published directory and out of the finished book’s repository.

Can I host the book on my site?

Yes. Host the book’s static files on your site. No persistent Papermorph server is needed.

Which player languages are available?

English, Russian, Chinese and Japanese. Player-interface language is separate from the book’s content and narration.

Can I export video and an LMS package?

Yes. `export.py` produces a 1080p video and SRT, while `scorm.py` packages a book for an LMS. Check the required format on a trial chapter.

Discussion

No questions or reviews yet.

Skills

A skill for Claude Code and Codex: the agent writes animation scenes, a browser player shows them, export to MP4 and Lottie.

SkillExtended access56

Nine skills and a Remotion library make short vertical explainer reels in a layered paper-cut style, from strategy to render.

SkillExtended access207

The blank-page skill expands a one-line motion brief into a full prompt with references, numbered beats and a turn for the agent.

SkillMinimal access384

A skill that turns your photo or description into a hand-drawn character and uses it for diagrams, knowledge cards and slides

SkillExtended access269

A skill that turns Chinese story copy or a set of ordered images into a vertical hand-drawn animation, a silent diary-comic picture track

SkillExtended access2.5K

An agent skill set that turns a novel into a playable game: source analysis with citations, design, target-platform build and evidence-based QA

SkillExtended access1.1K

README in short

Each book keeps its own player copy. It can be updated separately from chapter content, so changing the engine does not require rebuilding all the material.

README badge

Original SKILL.md

---
name: papermorph
description: Make or edit animated, narrated, interactive web books from reference PDFs, animated picture books (paper-puppet films) from a story, a joke or a fairy tale, narrated documentaries about a book or an idea, built from public-domain pictures, and upright shorts for a phone feed that make one point in under three minutes. Use for book planning, storyboards, chapter animation and exercises, narration, and cover and contents pages, including "make the next chapter", "turn this story into a picture book", "make a documentary about this book", "make a short about this for YouTube Shorts" or "fix this animation". Deliver runnable static book files; bookshelf design, bookshelf registration and hosting are separate tasks.
---

# Papermorph

Papermorph makes three tiers of book on one engine:

- **Lessons**, from a textbook PDF: each chapter is a short animated lesson film where the picture carries the explanation, the narration says it, and quick checks and practice happen inside the picture.
- **Picture books**, from a story, a joke or a fairy tale: short films of paper puppets in front of sets, drawn in code or painted by an image model, with voices, effects and music.
- **Films**, from a book, an idea or the user's argument: narrated **documentaries** of found public-domain pictures, words and maps moved in step with the voice, and upright **shorts** for a phone feed that make one point in under three minutes.

All are an SVG stage (1600×900, or 900×1600 for a short) plus a player; **beats** pair narration clips with timed actions. Good means **alive** (things act and change with weight and timing), **composed** (each moment reads as one picture, text beside what it names), **true** (motion, labels and numbers agree at every moment) and **smooth** (it plays without stutter, Firefox included).

What the picture should be depends on the book and on the user, so the work starts with a conversation that ends in `style.json`: the user's words, the look they chose, the voices, which model does which step, and later the approved chapters. Every chapter is made against it; how each beat is laid out and choreographed is yours to judge against it and the approved chapters. User requests override defaults. Re-create explanations, examples and drawings; keep source PDFs, page images and extracted text outside the static output folder and out of version control (`.gitignore`: `*.pdf`, `books/*/pages/`). A chapter the Skill made is a first cut: review rounds and the user's viewing come before it is published.

## Which tier

Read the tier's first file, then only what the current step needs. Every file below is linked from here; none needs another to be found.

| The user brings | Tier | Start with | Then, as the step needs |
|---|---|---|---|
| A textbook PDF (a course book too) | Lessons | [lessons.md](references/lessons/lessons.md) | [intake.md](references/lessons/intake.md) · [authoring.md](references/lessons/authoring.md) · [diagrams.md](references/lessons/diagrams.md) (tier 1) · [scenes.md](references/lessons/scenes.md) (tier 2) · [assets.md](references/lessons/assets.md) · [questions.md](references/lessons/questions.md) · [checks.md](references/lessons/checks.md) · [cover.md](references/lessons/cover.md) · [courses.md](references/lessons/courses.md) (citations, item bank, SCORM: only when the book calls for them) |
| A story, a joke, a fairy tale, or a story book's PDF | Picture books | [stories.md](references/picture-books/stories.md) | [puppets.md](references/picture-books/puppets.md) · [painting.md](references/picture-books/painting.md) (a painted look) |
| A book, an idea or a stretch of history to explain as a narrated film | Films: documentary | [films.md](references/films/films.md) | [documentary.md](references/films/documentary.md) |
| One point to make in under three minutes, upright, for a phone feed (YouTube Shorts, TikTok, Reels), or a long film to recut | Films: shorts | [films.md](references/films/films.md) | [shorts.md](references/films/shorts.md) |

Every tier shares the core:

| File | What it holds |
|---|---|
| [core/style.md](references/core/style.md) | how to ask the user, the models step, `style.json` |
| [core/publish.md](references/core/publish.md) | `new_book.py`, language, minutes, preview and delivery, video export |
| [core/sound.md](references/core/sound.md) | the narration file, voices, levels, effects, music, captions |
| [core/review.md](references/core/review.md) | seeing your own work in motion, frames, smoothness, director rounds |
| [core/team.md](references/core/team.md) | making chapters with subagents, the coordinator, workers in parallel |
| [core/engine.md](references/core/engine.md) | the player and drawing API, timing, camera, performance, traps |

Start with the tier's intake whenever `books/<book>/style.json` does not exist yet; reuse answers and approvals already given. The reference books on https://papermorph.diamonddoge.org/ are the bar: the maths and science books for lessons, *Joke Collection* and *Little Red Riding Hood* for picture books, *Madness and Civilization*, *Shooting an Elephant* (interactive) and *The Pandemic* for documentaries, the *Madness and Civilization* shorts for shorts.

Report a problem