Skip to content

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

docs(skill): models are chosen among what the host can start; checkout v5

DozenTwelve0e8b5c3177a6
diff --git a/.claude/skills/papermorph/references/core/style.md b/.claude/skills/papermorph/references/core/style.md
index 79d8d0c..c25c861 100644
--- a/.claude/skills/papermorph/references/core/style.md
+++ b/.claude/skills/papermorph/references/core/style.md
@@ -12,7 +12,7 @@ Left to guess what the user wants, an agent's guesses diverge from run to run. S
## Models
-Which model does which step is the user's choice; users run the Skill with different models and providers, and a book can mix them. Show the tier's defaults as one table, one row per step of its team ([core/team.md](team.md)), and ask: keep it (recommended), or change some rows. Any model the user names is fine.
+Which model does which step is the user's choice, among the models the host running the Skill can start; a user who wants another provider's models makes the book in that provider's host. Show the tier's defaults as one table, one row per step of its team ([core/team.md](team.md)), and ask: keep it (recommended), or change some rows.
The defaults are the splits that made approved books; a cheaper split is the user's to try.
@@ -29,7 +29,7 @@ The defaults are the splits that made approved books; a cheaper split is the use
A middle model on a lesson's picture step made two maths chapters that were acceptable but monotonous: a cheaper choice for tier 1 when the user wants it. No cheaper split of a film has been tried.
-**small**, **middle** and **strong** stand for the user's current fast, balanced and most capable models; write the actual names into `models`, keyed by step as in the [lesson](../../assets/templates/style.json) or [picture-book](../../assets/templates/picture-book/style.json) template (a picture book's keys name its roles: `script`, `kit`, `scenes`, `sound`, `director`, `reviewers`; a [documentary](../../assets/templates/documentary/style.json)'s and a [short](../../assets/templates/shorts/style.json)'s: `script`, `pictures`, `beats`, `checks`, `director`). Without subagents one agent does every step on its own model, and the table only records that. The user can change a row at any time; later chapters follow the table as it stands.
+**small**, **middle** and **strong** stand for the user's current fast, balanced and most capable models; write the actual names into `models`, keyed by step as in the [lesson](../../assets/templates/style.json) or [picture-book](../../assets/templates/picture-book/style.json) template (a picture book's keys name its roles: `script`, `kit`, `scenes`, `sound`, `director`, `reviewers`; a [documentary](../../assets/templates/documentary/style.json)'s and a [short](../../assets/templates/shorts/style.json)'s: `script`, `pictures`, `beats`, `checks`, `director`). Claude Code starts a subagent on `opus`, `sonnet`, `haiku` or `fable`; a host that cannot choose a subagent's model, or has no subagents, runs every step on the conversation's model, so say that to the user and let the table record it. A model the host cannot start is named to the user, not swapped for another. The user can change a row at any time; later chapters follow the table as it stands.
## style.json
diff --git a/.github/workflows/checks.yml b/.github/workflows/checks.yml
index 73c49c8..1301f37 100644
--- a/.github/workflows/checks.yml
+++ b/.github/workflows/checks.yml
@@ -13,7 +13,7 @@ jobs:
runs-on: ubuntu-latest
timeout-minutes: 5
steps:
- - uses: actions/checkout@v4
+ - uses: actions/checkout@v5
- name: Skill docs agree with its files
run: python3 .github/scripts/check_skill.py
- name: Python scripts (pyflakes errors, no unused-import noise)
@@ -23,6 +23,6 @@ jobs:
runs-on: ubuntu-latest
timeout-minutes: 10
steps:
- - uses: actions/checkout@v4
+ - uses: actions/checkout@v5
- name: Engine copies, lint, script syntax
run: python3 .github/scripts/check_site.py
diff --git a/README.md b/README.md
index 18a82df..19652a8 100644
--- a/README.md
+++ b/README.md
@@ -105,7 +105,7 @@ Ticked items are in the Skill today. The Skill currently goes as far as document
- [x] **Maths books:** formulas and diagrams that change step by step, with quizzes.
- [x] **Science books:** illustrated scenes, acting characters, camera work.
- [x] **Picture books:** paper-puppet films from a story, a joke or a fairy tale.
-- [ ] **Choosing the model for every step**, with defaults that depend on how much animation a book needs.
+- [x] **Choosing the model for every step**, with defaults that depend on how much animation a book needs.
- [x] **Documentaries:** narrated films of public-domain pictures about a book or an idea. *Madness and Civilization* on the shelf is the reference film.
- [x] **Vertical shorts** of documentaries: one point in under three minutes for a phone feed.