Skip to content
Skills Library
Marketing & content · Building & coding

papermorph

/papermorph

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, upright shorts for a phone feed that make one point in under three minutes, scroll stories whose picture changes as the reader scrolls, and maps you explore, where a stretch of history plays year by year and the reader clicks the people and places on it. Use for book planning, storyboards, chapter animation and exercises, narration, and cover and contents p

Repository
papermorph ↗
Licence
MIT
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
141
Scripts
72
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 72 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: assets/scorm/scorm-bridge.js, assets/scorm/scorm-host.js, assets/scorm/test/check_scorm.py, assets/scorm/test/serve.py, assets/templates/documentary/lib/film.js, assets/templates/e2e.py, assets/templates/explore/lib/events.js, assets/templates/explore/lib/explore.js, assets/templates/explore/lib/sprite.js, assets/templates/explore/lib/states.js, assets/templates/explore/lib/story.js, assets/templa

What it does and when to use it

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, upright shorts for a phone feed that make one point in under three minutes, scroll stories whose picture changes as the reader scrolls, and maps you explore, where a stretch of history plays year by year and the reader clicks the people and places on it. Use for book planning, storyboards, chapter animation and exercises, narration, and cover and contents p

Original author 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, upright shorts for a phone feed that make one point in under three minutes, scroll stories whose picture changes as the reader scrolls, and maps you explore, where a stretch of history plays year by year and the reader clicks the people and places on it. Use for book planning, storyboards, chapter animation and exercises, narration, and cover and contents p

How it works

  1. Which tier
  2. Reference books
  3. Project layout
  4. Scripts
  5. Context
Original SKILL.md headings · 89 lines, 1,566 words
SKILL.md preview
---
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, upright shorts for a phone feed that make one point in under three minutes, scroll stories whose picture changes as the reader scrolls, and maps you explore, where a stretch of history plays year by year and the reader clicks the people and places on it. 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", "fix this animation" or "make an interactive map of Europe in the 1920s". 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) · [maths.md](references/lessons/maths.md) (math.js, math parts, LaTeX) · [questions.md](references/lessons/questions.md) · [figures.md](references/lessons/figures.md) (figures the reader moves) · [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 (its own scanned pictures: [stories.md](references/picture-books/stories.md#from-a-scanned-books-own-pictures)) | 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) · [listen-and-find.md](references/picture-books/listen-and-find.md) (a finding game for young children) |
| 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) |
| A film's material, or an idea that is mostly maps and numbers, to read at the reader's own pace on a page whose picture changes as it scrolls (a scroll story) | Films: scroll page | [films.md](references/films/films.md) | [scroll.md](references/films/scroll.md) |
| A stretch of history to explore on a map, year by year: borders that change, people who move (one page, its own player, not the engine) | Pages you explore | [explore.md](references/explore/explore.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, the paid steps (keys, prices, ledger, balance), `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.

## Reference books

The reference books are the bar: levels to reach, not formats to copy. Each is the folder `site/<slug>/` of the Papermorph repository (https://github.com/DozenTwelve/Papermorph), served at `https://papermorph.diamonddoge.org/<slug>/`, so its source can be read in a checkout or fetched from either address when the Skill is installed on its own. The tier files name the file in a book worth opening for a given step.

| Tier | Books (slug) |
|---|---|
| Lessons | tier 1: *Elementary Algebra* (`elementary-algebra`), *Math Notebook* (`math-notebook`); tier 2: *Science* (`science`); a light board with dark ink: `physics-notebook` |
| Picture books | *The Little Horse Crosses the River* (`little-horse`) and *Little Red Riding Hood* (`little-red-riding-hood`): all in code, a cast voiced by ElevenLabs, a listen-and-find stop, the newest and the bar; *Joke Collection* (`joke-collection`): painted sets, puppets in code, a series of episodes; *Millions of Cats* (`millions-of-cats`, Wanda Gág, 1928): a scanned book's own pictures lifted into sets and puppets (not on the shelf) |
| Documentaries | *Madness and Civilization* (`madness`, after Foucault, ten minutes), *The Pandemic* (`pandemic`), *Shooting an Elephant* (`shooting-an-elephant`, one the reader acts in) |
| Shorts | the *Madness and Civilization* shorts (`madness-shorts`; episode 1, *The Ship*, is the worked example), *The Pandemic* shorts (`pandemic-shorts`) |

*Tulip Mania* (`tulip-mania`) is a test film made from the Skill alone, with no help beyond these files; the files cite what it ran into.

## Project layout

```
books/<book>/                  private: source, style.json, storyboards, art, review/ (tier files list their own)
content/<book>/chNN/           narration.<lang>.json and the voice cache
tools/<book>/                  tests, audio scripts, evidence
site/<book>/                   the static book (only this is delivered)
  index.html                   cover and contents, or a series page
  lib/                         the engine (synced by engine.py), lib/book.css (this book's settings), the tier's kit, the book's own pieces
  img/                         the book's pictures
  chNN/index.html, audio/<lang>/   a chapter or episode, its beat MP3s and timings.js (films and picture books: audio/sfx/, audio/bgm/)
```

`SKILL` means this skill's absolute folder; `<book>` is the book slug, `<lang>` its primary language code. `new_book.py` starts a book of any tier ([core/publish.md](references/core/publish.md#start-a-book-folder)).

Needs: `uv`, `ffmpeg`/`ffprobe`, Edge TTS network access (or Kokoro, local), github.com for `engine.py` when the repository's `engine/` folder is not at hand, an OpenRouter key only for the paid steps the user chooses (`paint.py`, `eleven.py`, `video.py`; `paint_openai.py` takes an OpenAI key), and Playwright browsers (`uv run --with playwright playwright install chromium firefox`; where Playwright's Chromium does not run, set `CHROME` to an installed Chrome, Chromium, Brave or Edge). Preview: `python3 SKILL/scripts/serve.py 8765 site` (no browser caching).

## Scripts

All in `SKILL/scripts/`; each prints its usage with `--help` when run with the `uv run --with …` its docstring's first lines name (without its packages even `--help` stops on the import).

| For | Scripts |
|---|---|
| Every book | `new_book.py` start a book folder · `serve.py` preview without caching · `engine.py` sync the engine into books · `tts.py` narration and word times · `eleven.py` the same from ElevenLabs (paid) · `level.py` even loudness · `lint.py` static checks · `check.py` page errors, console warnings and beat lengths in Chromium and Firefox · `shot.py` beat screenshots · `strip.py` storyboard sheets and motion strips · `still.py` stretches where nothing moves · `playlog.py` sounds and captions against the picture · `perf.py` Firefox frame times · `export.py` MP4 and `.srt` · `sfx.py` synthesized effects |
| Lessons | `outline.py` and `split_pages.py` page map and chapter text · `check_blank.py` empty openings · `overlap.py` arrows through text · `sprites.py` image processing steps · `refs.py` verified citations · `items.py` question bank · `scorm.py` LMS package |
| Picture books | `mouths.py` mouth shapes · `join.py` one clip per scene · `bake_sets.py` set layers · `bake_puppets.py` puppet bitmaps · `paint.py` / `paint_openai.py` image-model pictures · `painted.py` place them in the book · `lift.py` figures, sets and lettering cut from a scanned book's own pictures · `cutout.py` image-model pictures on a key colour cut into puppet pieces and props |
| Pages you explore | `topo.py` the map's TopoJSON from Natural Earth · `explore.py` checks, shots, Firefox timing and the narration file for an explorable map |
| Films | `commons.py` public-domain pictures and recordings with their licences · `prep.py` print, line and full-bleed treatments · `trace.py` drawings that draw themselves on · `video.py` a clip from a still · `frames.py` a clip as treated frames · `geo.py` the map kit's data from Natural Earth · `music.py` a track cut to the film, the bed in the voice's gaps, and the music, beds and effects against each line · `safe.py` words outside an upright film's safe area |

`silence.py`, `ledger.py` (the one cost ledger: date, chapter, file, model, what, cost) and `browsers.py` are helpers the others import.

## Context

- Talk with the user from the main conversation: intake, and every sheet and choice of the pilot. When subagents are available, chapters are made as a team, each step on the model the user chose, with the main conversation as the pilot's coordinator ([core/team.md](references/core/team.md#the-coordinator) says what that allows); without them, run the same steps in the current agent with file-based state.
- Use the engine API and inspect individual functions when needed; copy kit files rather than reading their full source as instructions.
- Keep `style.json` current and short; chapter status, errata and historical feedback stay in `chapters.md` and `chapters/chNN.md`.
Files in this package (141)
  • SKILL.md 12 KB
  • assets/scorm/launch.html 1 KB
  • assets/scorm/scorm-bridge.js 3 KB
  • assets/scorm/scorm-host.js 7 KB
  • assets/scorm/test/check_scorm.py 5 KB
  • assets/scorm/test/mock-lms.html 3 KB
  • assets/scorm/test/serve.py 1 KB
  • assets/templates/book.html 4 KB
  • assets/templates/chapter.html 4 KB
  • assets/templates/e2e.py 6 KB
  • assets/templates/narration.en.json 1 KB
  • assets/templates/style.json 2 KB
  • assets/templates/unit-art.js 2 KB
  • assets/templates/documentary/chapter.html 3 KB
  • assets/templates/documentary/narration.en.json 1 KB
  • assets/templates/documentary/style.json 1 KB
  • assets/templates/documentary/lib/book.css 1 KB
  • assets/templates/documentary/lib/film.js 14 KB
  • assets/templates/documentary/lib/fonts.css 4 KB
  • assets/templates/documentary/lib/fonts/EBGaramond-italic-400-latin-ext.woff2 49 KB
  • assets/templates/documentary/lib/fonts/EBGaramond-italic-400-latin.woff2 26 KB
  • assets/templates/documentary/lib/fonts/EBGaramond-normal-400-latin-ext.woff2 59 KB
  • assets/templates/documentary/lib/fonts/EBGaramond-normal-400-latin.woff2 24 KB
  • assets/templates/documentary/lib/fonts/EBGaramond-normal-500-latin-ext.woff2 66 KB
  • assets/templates/documentary/lib/fonts/EBGaramond-normal-500-latin.woff2 25 KB
  • assets/templates/documentary/lib/fonts/OFL-EBGaramond.txt 4 KB
  • assets/templates/documentary/lib/fonts/OFL-Oswald.txt 4 KB
  • assets/templates/documentary/lib/fonts/Oswald-normal-500-latin-ext.woff2 12 KB
  • assets/templates/documentary/lib/fonts/Oswald-normal-500-latin.woff2 13 KB
  • assets/templates/documentary/lib/fonts/Oswald-normal-600-latin-ext.woff2 12 KB
  • assets/templates/documentary/lib/fonts/Oswald-normal-600-latin.woff2 13 KB
  • assets/templates/explore/index.html 4 KB
  • assets/templates/explore/style.json 1 KB
  • assets/templates/explore/data/map.topo.json 107 KB
  • assets/templates/explore/lib/events.js 2 KB
  • assets/templates/explore/lib/explore.js 63 KB
  • assets/templates/explore/lib/page.css 20 KB
  • assets/templates/explore/lib/sprite.js 1 KB
  • assets/templates/explore/lib/states.js 5 KB
  • assets/templates/explore/lib/story.js 4 KB
  • assets/templates/explore/lib/topo.js 5 KB
  • assets/templates/maps/sample.html 7 KB
  • assets/templates/maps/lib/globe.js 8 KB
  • assets/templates/maps/lib/map.js 31 KB
  • assets/templates/picture-book/chapter.html 4 KB
  • assets/templates/picture-book/narration.en.json 1 KB
  • assets/templates/picture-book/painted.json 1 KB
  • assets/templates/picture-book/scene1.js 4 KB
  • assets/templates/picture-book/series.html 7 KB
  • assets/templates/picture-book/sets.js 5 KB
  • assets/templates/picture-book/style.json 1 KB
  • assets/templates/picture-book/lib/cast.js 52 KB
  • assets/templates/picture-book/lib/cut.js 12 KB
  • assets/templates/picture-book/lib/paper.js 24 KB
  • assets/templates/picture-book/lib/shared.js 2 KB
  • assets/templates/scroll/e2e.py 7 KB
  • assets/templates/scroll/index.html 3 KB
  • assets/templates/scroll/story.js 6 KB
  • assets/templates/scroll/style.json 1 KB
  • assets/templates/scroll/img/geo-lite.js 75 KB
  • assets/templates/scroll/lib/scroll.css 5 KB
  • assets/templates/scroll/lib/scroll.js 12 KB
  • assets/templates/shorts/chapter.html 3 KB
  • assets/templates/shorts/narration.en.json 1 KB
  • assets/templates/shorts/style.json 2 KB
  • assets/templates/shorts/lib/book.css 1 KB
  • assets/templates/shorts/lib/icons-LICENSE.txt 1 KB
  • assets/templates/shorts/lib/icons.js 14 KB
  • assets/templates/shorts/lib/shorts.js 16 KB
  • references/core/engine.md 26 KB
  • references/core/publish.md 8 KB
  • references/core/review.md 9 KB
  • references/core/sound.md 20 KB
  • references/core/style.md 12 KB
  • references/core/team.md 6 KB
  • references/explore/explore.md 11 KB
  • references/films/documentary.md 9 KB
  • references/films/films.md 18 KB
  • references/films/scroll.md 11 KB
  • references/films/shorts.md 12 KB
  • references/lessons/assets.md 2 KB
  • references/lessons/authoring.md 3 KB
  • references/lessons/checks.md 2 KB
  • references/lessons/courses.md 8 KB
  • references/lessons/cover.md 3 KB
  • references/lessons/diagrams.md 2 KB
  • references/lessons/figures.md 10 KB
  • references/lessons/intake.md 5 KB
  • references/lessons/lessons.md 8 KB
  • references/lessons/maths.md 6 KB
  • references/lessons/questions.md 5 KB
  • references/lessons/scenes.md 4 KB
  • references/picture-books/listen-and-find.md 8 KB
  • references/picture-books/painting.md 6 KB
  • references/picture-books/puppets.md 22 KB
  • references/picture-books/stories.md 23 KB
  • scripts/bake_puppets.py 5 KB
  • scripts/bake_sets.py 4 KB
  • scripts/browsers.py 5 KB
  • scripts/check.py 7 KB
  • scripts/check_blank.py 4 KB
  • scripts/commons.py 10 KB
  • scripts/cutout.py 9 KB
  • scripts/eleven.py 21 KB
  • scripts/engine.py 6 KB
  • scripts/explore.py 13 KB
  • scripts/export.py 29 KB
  • scripts/frames.py 3 KB
  • scripts/geo.py 12 KB
  • scripts/items.py 4 KB
  • scripts/join.py 13 KB
  • scripts/ledger.py 2 KB
  • scripts/level.py 10 KB
  • scripts/lift.py 28 KB
  • scripts/lint.py 26 KB
  • scripts/mouths.py 4 KB
  • scripts/music.py 34 KB
  • scripts/new_book.py 12 KB
  • scripts/outline.py 7 KB
  • scripts/overlap.py 8 KB
  • scripts/paint.py 5 KB
  • scripts/paint_openai.py 6 KB
  • scripts/painted.py 8 KB
  • scripts/perf.py 7 KB
  • scripts/playlog.py 10 KB
  • scripts/prep.py 6 KB
  • scripts/refs.py 18 KB
  • scripts/safe.py 4 KB
  • scripts/scorm.py 10 KB
  • scripts/serve.py 3 KB
  • scripts/sfx.py 36 KB
  • scripts/shot.py 11 KB
  • scripts/silence.py 1 KB
  • scripts/split_pages.py 6 KB
  • scripts/sprites.py 4 KB
  • scripts/still.py 6 KB
  • scripts/strip.py 9 KB
  • scripts/topo.py 11 KB
  • scripts/trace.py 4 KB
  • scripts/tts.py 19 KB
  • scripts/video.py 4 KB

Versions

The database has no other skills named papermorph.

Database snapshot: 13.11.2026 · package version c5fced482cd5 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90faceless-video
    Create finished multi-scene, narrator-led faceless explainers, documentaries, educational stories, myth or fairy-tale retellings, kids stories, and narrated picture stories. Do not use for single clips, ads, UGC, talking heads, or silent animation.
  • 95v1-explainer-video
    Create narrated animated explainers. Use for "make an explainer video", "explain this PR in a video", or "animate this concept with narration".
  • 100book-architect
    Design the structural and emotional architecture for nonfiction books. Use when an author has a validated book concept and needs to create the blueprint before drafting. Triggers include requests to structure a book, create a chapter outline, design a table of contents, map the…
  • 100animation-studio
    This skill should be used when the user asks to "make an animated video about X with music", "make a cartoon / animated short", "animate this story", "make a video like the Opus animations", "make an explainer animation (with a voiceover)", "make a promo video for my app / brand…
  • 100white-model-city-film
    Create data-driven white-model (白模) city documentaries with Three.js, geographic building data, historical map layers, narration and music through Sumi Studio MCP. Use for 3D city-history films, map-based urban-growth animations, or adapting the included Suzhou documentary to another city.
  • 95video-storytelling
    Create coherent video story sequences with AI-generated images and narrated audio. Combines image-generation and elevenlabs skills to produce complete video stories with visual and narrative consistency across all scenes. Maintains character appearance, style, lighting, and…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.