Wiggly / Format Lab /

Cartoon Explainer

experimental

v1.2.0-experiment

Cartoon Explainer

Familiar characters explain a real idea through their own story world.

Matches saved runs

Give an agent the working Format—not screenshots of it

The kit contains the renderer, runner, rules, layouts, and assets. Unzip it and tell Claude or Codex to read SKILL.md. It must use the packaged renderer, not rebuild one.

Download runnable Format Kit

1. Agent loop

Claude or Codex can download this package, use its existing renderer, check what is missing, plan a lesson, render it, inspect it, and improve it up to two times.

What it needs

FISH_STUDIO_APIKEY in v3/.env.local
Node, FFmpeg, FFprobe, and Remotion installed locally
Serper only when a new story world needs assets

What it will not use

No OpenRouter planner, Replicate, GPU, image generation, or video generation. Secret values never enter the Format files or reports.

Agent skill

The complete loop an agent follows without the user explaining the Format.

SKILL.md

---
name: otaku-explainer-format
description: Use the Cartoon Explainer Format to make a short story-world lesson video without asking the user to explain how the Format works.
---

# Cartoon Explainer Agent Loop

You are operating a complete runnable Wiggly Format Kit. The user supplies a topic and chooses a packaged story world. This folder supplies the cast, voices, backgrounds, layouts, renderer, runner, audio rules, and quality checks.

## Use the packaged runtime

Do not rebuild, replace, translate, or imitate the renderer. Run the renderer and runner already included in this kit. A different framework or a new scene-timing loop is a failed use of the Format, even when its final video looks similar.

If you received the public Wiggly Repo URL, download and unzip the **Runnable Format Kit** first. Open its `v3` folder, run `npm install`, copy `.env.example` to `.env.local`, and add only the missing key values. Then follow the commands below.

The renderer deliberately adds a soft glow around the active speaker. This hides rough transparent-image edges and makes the speaker obvious. Preserve that behavior.

## Commands

Run commands from the downloaded kit's `v3` folder:

```bash
npm run smoke
npm run prototype:otaku -- check
npm run prototype:otaku -- init --run=<run-id> --topic="<topic>" --world=naruto
npm run prototype:otaku -- validate --run=<run-id>
npm run prototype:otaku -- render --run=<run-id> --approve-loop
npm run prototype:otaku -- inspect --run=<run-id>
npm run prototype:otaku -- finalize --run=<run-id>
```

Run `npm run smoke` first. It makes a tiny local test video and verifies the packaged renderer, assets, FFmpeg, Remotion, and audio mix without calling Fish or any paid provider.

`--approve-loop` records permission for one initial render and up to two focused improvement renders without storing secrets. If the configured voice model is free and the user already asked the agent to make the video, that request is enough; do not interrupt them for another approval. Ask first when a provider may charge money.

## Required loop

1. Read this file, `requirements.json`, `worlds/<world>.json`, `layouts.json`, `scene-contract.json`, `prompts/script-system.md`, and `quality.json`.
2. Run `npm run smoke`, then run `check`. If either fails, stop and report the exact missing local requirement. If `check` reports a missing key, ask the user to add the named key to `.env.local`. Never ask them to paste a secret into chat and never print its value.
3. Run `init`, then write 12–18 short scene records in the new run's `scene-plan.json`.
4. Use only packaged role names, backgrounds, layout IDs, and assets. Do not invent character coordinates.
5. Run `validate` before any media call. Fix every validation error first.
6. Show the user the scene plan, scene count, cast, and estimated duration. If any media call may cost money, ask once for approval covering no more than three total render attempts.
7. Run `render --approve-loop` for the first attempt. Later attempts use `render` without that flag.
8. Run `inspect`. Look at the full video and contact sheet. Record only concrete problems in `quality-report.json`.
9. Fix only the problems you found. Do not rewrite good scenes. Render and inspect again when needed.
10. Run `finalize` only when every automatic and human review check passes.

## Add a story world

When the user asks for a story world that is not packaged:

1. Run `check --needs-new-assets`. Ask for missing key names without exposing their values.
2. Research the show's characters, relationships, locations, and lore. Record the sources you used.
3. Map one character to each lesson role: learner, guide, and challenger. Keep the renderer, layouts, and scene contract unchanged.
4. Search Fish Audio's public models for each character, audition available samples, and record the chosen model IDs and why they fit.
5. Use Serper to find full-body character cutouts and wide backgrounds. Follow `prompts/image-search.md`; prefer existing transparent assets and use local cleanup when needed.
6. Source one quiet instrumental track using the music procedure below.
7. Add the inspected files and provenance to `assets.json`, then create `worlds/<world>.json` with the cast, voices, backgrounds, useful lore, claims to avoid, and selected music.
8. Validate the new world before rendering. If it requires special renderer, runner, layout, or schema code, stop: the Format is not portable yet.

Do not generate images unless the user separately approves it. Do not add an automated world-building workflow; the agent performs and documents this work.

### Source story-world music

1. Search Serper for `"<story world> background music instrumental"` and inspect the top three credible results.
2. Prefer an exact official or studio instrumental over a cover, remix, or re-orchestration unless the Format calls for one.
3. Download audio with `uvx yt-dlp --no-playlist -x --audio-format mp3 --audio-quality 0 <url>`.
4. Use FFprobe and FFmpeg to check duration, loudness, clipping, and trailing silence. Remove dead air, normalize with `loudnorm=I=-14:TP=-1.5:LRA=11`, and use a one-second crossfade when looping the track to the video length.
5. Verify that the loop has no silent seam and dialogue remains clear. If you cannot hear the candidates, do not claim that you auditioned them: use metadata and technical checks, then show the user playable options when taste affects the decision.
6. Record `localPath`, `sourceUrl`, `volume`, and `selectionReason` in the world pack. Keep the Format's default music when no candidate passes.

## Good result

A passing result:

- teaches the topic accurately in language a nontechnical viewer can repeat;
- sounds like a natural conversation, not a lecture pasted into character mouths;
- uses a story-world analogy that stays consistent;
- keeps every visible character grounded;
- fits every line inside the speech bubble;
- assigns the right voice to the active speaker;
- uses a clean music loop that stays below the dialogue; and
- leaves a clear final takeaway.

## Failure rules

- Never render an invalid plan.
- Never rebuild the packaged renderer or write a substitute timing/rendering pipeline.
- Scene duration comes from the actual voice file. Never add arbitrary silence after a voice clip.
- Use the full-length music bed prepared by the runner. Never loop a short track with a hard seam.
- Never exceed three attempts for one run.
- Never silently change providers or generate replacement images or video.
- If the packaged world lacks an asset, stop and explain what is missing. Use Serper only after the user approves sourcing a new asset.
- If attempt three still fails, stop and explain the blocker. Do not mark the run finished.
- Do not expose, copy, log, or store API key values.

Requirements

The key names and local tools needed, without any secret values.

requirements.json

{
  "environment": [
    {
      "name": "FISH_STUDIO_APIKEY",
      "requiredFor": ["render"],
      "description": "Generates one free S2.1 Pro voice clip for each scene."
    },
    {
      "name": "SERPER_API_KEY",
      "requiredFor": ["new-story-world-assets"],
      "description": "Finds character, background, and instrumental music candidates only when a story world is not already packaged."
    }
  ],
  "localTools": [
    { "name": "node", "requiredFor": ["check", "init", "validate", "render", "inspect", "finalize"] },
    { "name": "ffmpeg", "requiredFor": ["render", "inspect", "new-story-world-assets"] },
    { "name": "ffprobe", "requiredFor": ["render", "inspect", "new-story-world-assets"] },
    { "name": "uvx", "requiredFor": ["new-story-world-assets"] },
    { "name": "remotion", "requiredFor": ["render"] }
  ],
  "notUsed": [
    "OpenRouter",
    "Replicate",
    "GPU",
    "image generation",
    "video generation"
  ],
  "secretPolicy": "Read keys from the downloaded kit's v3/.env.local. Never write secret values to plans, logs, reports, or run records."
}

Danny Phantom world pack

Lesson roles mapped to characters, voices, backgrounds, lore, and music.

worlds/danny-phantom.json

{
  "id": "danny-phantom",
  "label": "Danny Phantom",
  "music": {
    "localPath": "assets/audio/danny-phantom-background.mp3",
    "volume": 0.16,
    "sourceUrl": "https://www.youtube.com/watch?v=s8N1O07Lxpw",
    "selectionReason": "The top exact-match search result is the official instrumental rather than a cover or remix. Its trailing silence was removed before making a crossfaded loop."
  },
  "roles": {
    "learner": {
      "character": "danny-phantom",
      "voice": "14f06ac475944bb7a0ef5cc958f07462",
      "behavior": "Curious, brave, and restates the lesson in plain words."
    },
    "guide": {
      "character": "tucker-foley",
      "voice": "e3e1212180ee4f87ab0730db54d1a8e2",
      "behavior": "Tech-obsessed friend who explains the mechanism clearly."
    },
    "challenger": {
      "character": "vlad-plasmius",
      "voice": "23231b8547f04d79bebc51bb2a23b5ab",
      "behavior": "Confident antagonist who adds a warning, edge case, or correction."
    }
  },
  "backgrounds": ["amity-park", "fenton-lab", "ghost-zone"],
  "lore": [
    "the Fenton Portal connects Earth to the separate Ghost Zone",
    "portal controls send specific commands across that boundary",
    "Tucker is Danny's tech-obsessed best friend",
    "Vlad is an experienced half-ghost and Danny's antagonist",
    "Amity Park is Danny's home and the place he protects",
    "ghost-hunting equipment follows specific controls and limits"
  ],
  "avoid": [
    "claiming Tucker built the Fenton Portal",
    "treating Vlad as a trusted teacher",
    "invented ghost powers or portal rules",
    "random technical words that do not map to the story-world action"
  ],
  "researchSources": [
    "https://en.wikipedia.org/wiki/Danny_Phantom",
    "https://dannyphantom.fandom.com/wiki/Danny_Phantom_(character)",
    "https://dannyphantom.fandom.com/wiki/Tucker_Foley",
    "https://dannyphantom.fandom.com/wiki/Vlad_Plasmius",
    "https://dannyphantom.fandom.com/wiki/Fenton_Portal",
    "https://dannyphantom.fandom.com/wiki/Ghost_Zone"
  ],
  "voiceResearch": {
    "danny-phantom": {
      "query": "Danny Phantom",
      "selectionReason": "Highest-use English result with a youthful, energetic sample and 1,700 prior tasks."
    },
    "tucker-foley": {
      "query": "Tucker Foley",
      "selectionReason": "English public model with an available energetic, friendly sample."
    },
    "vlad-plasmius": {
      "query": "Vlad Plasmius",
      "selectionReason": "Only exact English public result; its sample has the confident antagonist delivery the role needs."
    }
  }
}

Naruto world pack

Lesson roles mapped to characters, voices, backgrounds, lore, and music.

worlds/naruto.json

{
  "id": "naruto",
  "label": "Naruto",
  "roles": {
    "learner": { "character": "naruto", "voice": "c658e20af0364df6b73bdcef998b6a8b", "behavior": "Curious, impatient, and repeats the lesson in plain words." },
    "guide": { "character": "kakashi", "voice": "6fb91544d42b4d57a5b408c398459237", "behavior": "Calm teacher who makes the main idea accurate." },
    "challenger": { "character": "orochimaru", "voice": "8ecce156f83e4fa0bb75f99b30894e63", "behavior": "Adds tension, a sharper example, or a correction." }
  },
  "backgrounds": ["konoha", "naruto-forest", "training-ground"],
  "lore": ["ninja villages", "missions", "scrolls", "jutsu", "summoning contracts", "messenger birds"],
  "avoid": ["invented canon claims", "modern apps appearing inside the story world"]
}

SpongeBob SquarePants world pack

Lesson roles mapped to characters, voices, backgrounds, lore, and music.

worlds/spongebob.json

{
  "id": "spongebob",
  "label": "SpongeBob SquarePants",
  "music": {
    "localPath": "assets/audio/spongebob-background.mp3",
    "volume": 0.14,
    "sourceUrl": "https://www.youtube.com/watch?v=3xWZB1SoWE8",
    "selectionReason": "Hawaiian Cocktail is an exact SpongeBob production instrumental and is calm enough to sit below dialogue. Its leading and trailing silence were removed before loudness normalization."
  },
  "roles": {
    "learner": {
      "character": "spongebob",
      "voice": "9845e056f37b470d9a1005e41c864e25",
      "behavior": "Cheerful and curious; repeats the mechanism in simple words to prove he understands it."
    },
    "guide": {
      "character": "sandy-cheeks",
      "voice": "783d32b03d0c4ff28dd66455364d8665",
      "behavior": "A practical scientist who explains each electric vehicle part accurately and plainly."
    },
    "challenger": {
      "character": "plankton",
      "voice": "fc33048c58604823aa19ace52e4842c9",
      "behavior": "An overconfident inventor who suggests one tempting shortcut or misconception for Sandy to correct."
    }
  },
  "backgrounds": ["bikini-bottom", "sandy-treedome", "boating-school"],
  "lore": [
    "Bikini Bottom is SpongeBob's underwater home",
    "Sandy is an inventor and scientist who lives in a treedome",
    "Mrs. Puff's Boating School is where SpongeBob practices driving boatmobiles",
    "Plankton is an overconfident inventor and SpongeBob's recurring rival",
    "Sandy can test an electric boatmobile as a lesson device without claiming it is show canon"
  ],
  "avoid": [
    "claiming the lesson's electric boatmobile is a canon invention from the show",
    "pretending an electric vehicle battery connects directly to the wheels",
    "saying regenerative braking recovers all energy or replaces the regular brakes",
    "turning the explanation into unrelated SpongeBob catchphrases",
    "invented character relationships or locations"
  ],
  "researchSources": [
    "https://afdc.energy.gov/vehicles/how-do-all-electric-cars-work.html",
    "https://www.energy.gov/cmei/femp/articles/electric-vehicle-technology-overview-federal-fleet-training",
    "https://spongebob.fandom.com/wiki/Bikini_Bottom",
    "https://spongebob.fandom.com/wiki/Sandy_Cheeks",
    "https://spongebob.fandom.com/wiki/Mrs._Puff%27s_Boating_School",
    "https://spongebob.fandom.com/wiki/Sheldon_J._Plankton"
  ],
  "voiceResearch": {
    "spongebob": {
      "query": "Spongebob Squarepants",
      "selectionReason": "Highest-use exact English public result with an available sample and more than 31,000 prior tasks."
    },
    "sandy-cheeks": {
      "query": "Sandy Cheeks",
      "selectionReason": "Highest-use exact English public result with an available sample and more than 4,000 prior tasks."
    },
    "plankton": {
      "query": "Plankton",
      "selectionReason": "Highest-use exact English public result that also provides an audition sample."
    }
  }
}

Yu-Gi-Oh world pack

Lesson roles mapped to characters, voices, backgrounds, lore, and music.

worlds/yugioh.json

{
  "id": "yugioh",
  "label": "Yu-Gi-Oh",
  "roles": {
    "learner": { "character": "yugi", "voice": "a27f617599df41f9aa6e95bb57ac69ba", "behavior": "Asks the clear question and states the final lesson." },
    "guide": { "character": "kaiba", "voice": "710a3478dcc4477d8aae292c2de85964", "behavior": "Confident expert who explains the rule precisely." },
    "challenger": { "character": "joey", "voice": "2ef97f8ba13a4f71a7e291a3998af362", "behavior": "Adds a practical example, joke, or objection." }
  },
  "backgrounds": ["duel-arena", "duel-club", "domino-city"],
  "lore": ["decks", "cards", "duels", "turns", "combos", "trap cards"],
  "avoid": ["invented card rules", "switching the learner and guide roles without a reason"]
}

Approved layouts

Reusable two- and three-character positions. Scene writers do not invent coordinates.

layouts.json

{
  "layouts": {
    "two-balanced": [
      { "x": 8, "bottom": 2, "width": 52, "rotate": -1 },
      { "x": 56, "bottom": 3, "width": 41, "rotate": 0 }
    ],
    "two-first-focus": [
      { "x": 8, "bottom": 2, "width": 58, "rotate": -2 },
      { "x": 60, "bottom": 3, "width": 36, "rotate": 0 }
    ],
    "two-second-focus": [
      { "x": 8, "bottom": 3, "width": 45, "rotate": 0 },
      { "x": 52, "bottom": 2, "width": 47, "rotate": 1 }
    ],
    "three-balanced": [
      { "x": 2, "bottom": 2, "width": 38, "rotate": -2 },
      { "x": 33, "bottom": 3, "width": 37, "rotate": 0 },
      { "x": 64, "bottom": 2, "width": 35, "rotate": 2 }
    ]
  }
}

Original reference

What this proves

Rebuild: Recreate the reference format with a reusable scene contract.
New topic: Teach a different lesson without changing the renderer.
New world: Research and package different characters without adding world-specific code.

2. Instructions

Format instructions

What this Format does and how to run it.

README.md

# Cartoon Explainer

Turn a real lesson into a short conversation between familiar characters. A curious lead asks the obvious questions, an expert explains the idea through the story world, and a third character adds tension or a joke.

This package is the first Wiggly Format repository experiment. It contains the instructions, inputs, assets, prompts, scene slots, renderer, audio rules, quality checks, and exact run records needed to recreate its outputs.

An agent can operate the package without an OpenRouter planning call. Start with `SKILL.md`; it explains how to check requirements, create and validate a scene plan, request one render-loop approval, inspect the result, and stop after three attempts.

## Start from the public Wiggly Repo

1. Download and unzip the **Runnable Format Kit**.
2. Open its `v3` folder and run `npm install`.
3. Run `npm run smoke`. This free local test proves the renderer, assets, FFmpeg, Remotion, and audio mix work.
4. Copy `.env.example` to `.env.local` and add the requested key values.
5. Tell Claude or Codex: “Read `public/format-repositories/otaku-explainer-v1/SKILL.md` and use the packaged renderer. Do not rebuild it.”

The kit contains the real runner, renderer, dependencies, rules, layouts, and required assets. A fresh agent may write a new scene plan or story-world pack, but it must not recreate the renderer or timing pipeline.

## Formula

1. Open with a question that names the confusing idea.
2. Explain it one step at a time through story-world objects and actions.
3. Let the challenger introduce a believable mistake, warning, or joke.
4. Correct the mistake and complete the lesson.
5. End with the lead character saying the core idea back in one simple line.

Each scene uses the same visual grammar: a slowly panning story-world background, two or three grounded character cutouts, one visible speaker, one speech bubble, and an optional short callout.

Scene writers choose lesson roles and an approved layout. `worlds/*.json` maps the roles to characters and voices, while `layouts.json` owns the coordinates. This keeps a new topic from inventing a new renderer.

## Agent commands

From `v3`:

```bash
npm run smoke
npm run prototype:otaku -- check
npm run prototype:otaku -- init --run=<run-id> --topic="<topic>" --world=naruto
npm run prototype:otaku -- validate --run=<run-id>
npm run prototype:otaku -- render --run=<run-id> --approve-loop
npm run prototype:otaku -- inspect --run=<run-id>
npm run prototype:otaku -- finalize --run=<run-id>
```

The Fish key stays in `v3/.env.local`. Serper is needed only when a run adds a new story world. `SKILL.md` tells the agent how to research lore, choose voices, source and inspect assets, and create the world pack without adding another command or changing the renderer. The package never needs OpenRouter, Replicate, a GPU, image generation, or video generation.

## Proof runs

The Format page discovers every packaged world from `worlds/*.json`, every scene plan from `scenes/*.json`, and every finished proof from `outputs/*.run.json`. These files are the source of truth; the README and page do not maintain separate lists.

Every proof uses the same scene contract and `renderer/OtakuFormatRenderer.tsx`. The tracked videos, contact sheets, run records, and quality reports show whether the agent loop works across topics and story worlds.

## Editing

Assets and deterministic scene values can be replaced without regenerating the script. Changing a prompt or instruction marks the package **Needs rerun**, because an old output must never pretend to reflect a new prompt.

3. User inputs

User inputs

The topic and story world the Format needs. The world pack supplies the cast.

inputs.json

{
  "fields": [
    {
      "id": "topic",
      "label": "What should the characters explain?",
      "type": "text",
      "required": true
    },
    {
      "id": "storyWorld",
      "label": "Which story world should teach it?",
      "type": "story-world",
      "required": true,
      "source": "worlds/*.json"
    }
  ],
  "defaults": {
    "topic": "Compilers versus interpreters",
    "storyWorld": "naruto"
  }
}

4. Fixed assets

Naruto

assets/images/naruto-clean.png

Kakashi

assets/images/kakashi-alpha.png

Orochimaru

assets/images/orochimaru-clean.png

Yugi

assets/images/yugi-clean.png

Kaiba

assets/images/kaiba-clean.png

Joey

assets/images/joey.webp

Danny Phantom

assets/images/danny-phantom.webp

Tucker Foley

assets/images/tucker-foley.webp

Vlad Plasmius

assets/images/vlad-plasmius.webp

SpongeBob SquarePants

assets/images/spongebob.webp

Sandy Cheeks

assets/images/sandy-cheeks.png

Plankton

assets/images/plankton.webp

Konoha

assets/images/bg-konoha.jpg

Forest

assets/images/bg-naruto-forest.jpg

Training ground

assets/images/bg-training-ground.jpg

Duel arena

assets/images/bg-duel-arena.jpg

Duel club

assets/images/bg-duel-club.jpg

Domino City

assets/images/bg-domino-city.jpg

Amity Park

assets/images/bg-amity-park.webp

Fenton lab

assets/images/bg-fenton-lab.webp

Ghost Zone

assets/images/bg-ghost-zone.jpg

Bikini Bottom

assets/images/bg-bikini-bottom.webp

Sandy's treedome

assets/images/bg-sandy-treedome.webp

Mrs. Puff's Boating School

assets/images/bg-boating-school.webp

Fixed assets

Character cutouts, backgrounds, source links, and local files.

assets.json

{
  "characters": [
    {
      "id": "naruto",
      "label": "Naruto",
      "localPath": "assets/images/naruto-clean.png",
      "postprocess": "remove-white-and-trim",
      "searchQuery": "Naruto Uzumaki full body transparent png render",
      "sourcePage": "https://www.pngitem.com/middle/hJmTRwx_naruto-naruto-shippuden-anime-naruto-render-hd-png/",
      "sourceUrl": "https://www.pngitem.com/pimgs/m/487-4873619_naruto-naruto-shippuden-anime-naruto-render-hd-png.png"
    },
    {
      "id": "kakashi",
      "label": "Kakashi",
      "localPath": "assets/images/kakashi-alpha.png",
      "searchQuery": "Kakashi Hatake full body transparent png render",
      "sourcePage": "https://freepngimg.com/png/32495-kakashi-hd",
      "sourceUrl": "https://freepngimg.com/save/32495-kakashi-hd/900x2332"
    },
    {
      "id": "orochimaru",
      "label": "Orochimaru",
      "localPath": "assets/images/orochimaru-clean.png",
      "postprocess": "remove-white-and-trim",
      "searchQuery": "Orochimaru full body transparent png render",
      "sourcePage": "https://www.pngitem.com/middle/iJbimTT_renders-de-naruto-y-naruto-shippuden-naruto-orochimaru/",
      "sourceUrl": "https://www.pngitem.com/pimgs/m/282-2823667_renders-de-naruto-y-naruto-shippuden-naruto-orochimaru.png"
    },
    {
      "id": "yugi",
      "label": "Yugi",
      "localPath": "assets/images/yugi-clean.png",
      "postprocess": "remove-checkerboard-and-trim",
      "searchQuery": "Yami Yugi full body transparent png render",
      "sourcePage": "https://www.pngaaa.com/detail/4492094",
      "sourceUrl": "https://image.pngaaa.com/94/4492094-middle.png"
    },
    {
      "id": "kaiba",
      "label": "Kaiba",
      "localPath": "assets/images/kaiba-clean.png",
      "postprocess": "remove-checkerboard-and-trim",
      "searchQuery": "Seto Kaiba full body transparent png render",
      "sourcePage": "https://www.pngaaa.com/detail/4354853",
      "sourceUrl": "https://image.pngaaa.com/853/4354853-middle.png"
    },
    {
      "id": "joey",
      "label": "Joey",
      "localPath": "assets/images/joey.webp",
      "searchQuery": "Joey Wheeler full body transparent png render",
      "sourcePage": "https://all-worlds-alliance.fandom.com/wiki/Joey_Wheeler",
      "sourceUrl": "https://static.wikia.nocookie.net/all-worlds-alliance/images/d/d2/JoeyWheelerMD.png/revision/latest/scale-to-width-down/340?cb=20200516064401"
    },
    {
      "id": "danny-phantom",
      "label": "Danny Phantom",
      "localPath": "assets/images/danny-phantom.webp",
      "searchQuery": "Danny Phantom full body transparent png render",
      "sourcePage": "https://dannyphantom.fandom.com/wiki/Danny_Phantom_(character)",
      "sourceUrl": "https://static.wikia.nocookie.net/dpwikia/images/3/3c/Render-_Danny_Phantom_stock_image.png/revision/latest?cb=20250529003148"
    },
    {
      "id": "tucker-foley",
      "label": "Tucker Foley",
      "localPath": "assets/images/tucker-foley.webp",
      "searchQuery": "Tucker Foley full body transparent png render",
      "sourcePage": "https://dannyphantom.fandom.com/wiki/Tucker_Foley",
      "sourceUrl": "https://static.wikia.nocookie.net/dpwikia/images/a/ac/Render-_Tucker_Foley.png/revision/latest?cb=20250529003317"
    },
    {
      "id": "vlad-plasmius",
      "label": "Vlad Plasmius",
      "localPath": "assets/images/vlad-plasmius.webp",
      "searchQuery": "Vlad Plasmius full body transparent png render",
      "sourcePage": "https://dannyphantom.fandom.com/wiki/Vlad_Plasmius",
      "sourceUrl": "https://static.wikia.nocookie.net/dpwikia/images/6/67/Render-_Vlad_Plasmius_pose.png/revision/latest?cb=20260610224348"
    },
    {
      "id": "spongebob",
      "label": "SpongeBob SquarePants",
      "localPath": "assets/images/spongebob.webp",
      "searchQuery": "SpongeBob full body transparent PNG stock art",
      "sourcePage": "https://spongebob.fandom.com/wiki/SpongeBob_SquarePants_(character)/gallery",
      "sourceUrl": "https://static.wikia.nocookie.net/spongebob/images/5/5f/SpongeBobStockArt-2D.png/revision/latest?cb=20251102074746"
    },
    {
      "id": "sandy-cheeks",
      "label": "Sandy Cheeks",
      "localPath": "assets/images/sandy-cheeks.png",
      "searchQuery": "Sandy Cheeks full body spacesuit transparent PNG render",
      "sourcePage": "https://commons.wikimedia.org/wiki/File:Sandy_Cheeks_(transparent).png",
      "sourceUrl": "https://upload.wikimedia.org/wikipedia/commons/thumb/9/95/Sandy_Cheeks_%28transparent%29.png/500px-Sandy_Cheeks_%28transparent%29.png"
    },
    {
      "id": "plankton",
      "label": "Plankton",
      "localPath": "assets/images/plankton.webp",
      "searchQuery": "Plankton full body transparent PNG stock art",
      "sourcePage": "https://spongebob.fandom.com/wiki/Sheldon_J._Plankton/gallery",
      "sourceUrl": "https://static.wikia.nocookie.net/spongebob/images/7/7a/Laughton.png/revision/latest?cb=20221113005908"
    }
  ],
  "backgrounds": [
    {
      "id": "konoha",
      "label": "Konoha",
      "localPath": "assets/images/bg-konoha.jpg",
      "searchQuery": "Naruto Konoha village background no characters",
      "sourcePage": "https://www.peakpx.com/en/hd-wallpaper-desktop-fzdbf",
      "sourceUrl": "https://w0.peakpx.com/wallpaper/589/265/HD-wallpaper-konohagakure-anime-naruto-the-leaf-village.jpg"
    },
    {
      "id": "naruto-forest",
      "label": "Forest",
      "localPath": "assets/images/bg-naruto-forest.jpg",
      "searchQuery": "Naruto forest background no characters",
      "sourcePage": "https://www.pinterest.com/ideas/naruto-backgrounds/941180977477/",
      "sourceUrl": "https://s-media-cache-ak0.pinimg.com/originals/ed/ed/05/eded05d47a6e14ef62a7c275589f16bb.jpg"
    },
    {
      "id": "training-ground",
      "label": "Training ground",
      "localPath": "assets/images/bg-training-ground.jpg",
      "searchQuery": "Naruto training ground background no characters",
      "sourcePage": "https://sketchfab.com/3d-models/training-field-naruto-stage-glb-c6cd7082ee864ec984b11f8cdaeefa64",
      "sourceUrl": "https://media.sketchfab.com/models/c6cd7082ee864ec984b11f8cdaeefa64/thumbnails/f612af92dae545d2be1ec358e21e2b23/1e62e315d3684beab34923a07f51edd6.jpeg"
    },
    {
      "id": "duel-arena",
      "label": "Duel arena",
      "localPath": "assets/images/bg-duel-arena.jpg",
      "searchQuery": "Yu-Gi-Oh duel arena background no characters",
      "sourcePage": "https://yugioh.fandom.com/wiki/Dueling_Arena",
      "sourceUrl": "https://static.wikia.nocookie.net/yugioh/images/c/ce/DuelingArena-EN-Anime-DM.png/revision/latest?cb=20080930233413"
    },
    {
      "id": "duel-club",
      "label": "Duel club",
      "localPath": "assets/images/bg-duel-club.jpg",
      "searchQuery": "Yu-Gi-Oh classroom background no characters",
      "sourcePage": "https://yugioh.fandom.com/wiki/Duel_Club",
      "sourceUrl": "https://static.wikia.nocookie.net/yugioh/images/d/d0/Dc.png/revision/latest/scale-to-width-down/1200?cb=20170903092444"
    },
    {
      "id": "domino-city",
      "label": "Domino City",
      "localPath": "assets/images/bg-domino-city.jpg",
      "searchQuery": "Yu-Gi-Oh city background no characters",
      "sourcePage": "https://backgrounds.gallery/backgrounds/753/1150640-Paradise%20City",
      "sourceUrl": "https://steamcdn-a.akamaihd.net/steamcommunity/public/images/items/1150640/cacb64095456a03c8e04e9e886d938c1f504d29c.jpg"
    },
    {
      "id": "amity-park",
      "label": "Amity Park",
      "localPath": "assets/images/bg-amity-park.webp",
      "searchQuery": "Danny Phantom Amity Park street background no characters wide",
      "sourcePage": "https://dannyphantom.fandom.com/wiki/Amity_Park",
      "sourceUrl": "https://static.wikia.nocookie.net/dpwikia/images/c/c0/S01e16_AP_welcome_sign.png/revision/latest?cb=20160627025704"
    },
    {
      "id": "fenton-lab",
      "label": "Fenton lab",
      "localPath": "assets/images/bg-fenton-lab.webp",
      "searchQuery": "Danny Phantom Fenton lab background no characters",
      "sourcePage": "https://dannyphantom.fandom.com/wiki/Fenton_Portal",
      "sourceUrl": "https://static.wikia.nocookie.net/dpwikia/images/f/fe/S01e04_Fenton_Ghost_Portal.png/revision/latest?cb=20160428225359"
    },
    {
      "id": "ghost-zone",
      "label": "Ghost Zone",
      "localPath": "assets/images/bg-ghost-zone.jpg",
      "searchQuery": "Danny Phantom Ghost Zone landscape ground background no characters wide",
      "sourcePage": "https://www.ign.com/wikis/nick-all-star-brawl/Ghost_Zone",
      "sourceUrl": "https://oyster.ignimgs.com/mediawiki/apis.ign.com/nick-all-star-brawl/1/19/Ghost_Zone.jpg"
    },
    {
      "id": "bikini-bottom",
      "label": "Bikini Bottom",
      "localPath": "assets/images/bg-bikini-bottom.webp",
      "searchQuery": "SpongeBob Bikini Bottom city background no characters wide",
      "sourcePage": "https://spongebob.fandom.com/wiki/Bikini_Bottom",
      "sourceUrl": "https://static.wikia.nocookie.net/spongebob/images/2/26/Bubbletown_002.png/revision/latest/scale-to-width-down/1200?cb=20181028171458"
    },
    {
      "id": "sandy-treedome",
      "label": "Sandy's treedome",
      "localPath": "assets/images/bg-sandy-treedome.webp",
      "searchQuery": "Sandy treedome exterior background no characters wide",
      "sourcePage": "https://spongebob.fandom.com/wiki/Sandy_Cheeks%27_treedome",
      "sourceUrl": "https://static.wikia.nocookie.net/spongebob/images/f/f2/Sandy%2C_Help_Us%21_002.png/revision/latest/scale-to-width-down/1200?cb=20231007030731"
    },
    {
      "id": "boating-school",
      "label": "Mrs. Puff's Boating School",
      "localPath": "assets/images/bg-boating-school.webp",
      "searchQuery": "Mrs. Puff Boating School exterior background no characters wide",
      "sourcePage": "https://spongebob.fandom.com/wiki/Mrs._Puff%27s_Boating_School",
      "sourceUrl": "https://static.wikia.nocookie.net/spongebob/images/1/12/Lighthouse_Louie_001.png/revision/latest?cb=20200527190216"
    }
  ]
}

5. AI-generated content

Script prompt

How the lesson becomes dialogue that fits the story world.

prompts/script-system.md

# Script instruction

Write a 45–70 second conversation that teaches one confusing idea through the selected story world.

- The curious lead asks plain questions.
- The expert gives the accurate explanation.
- The third character adds tension, a useful correction, or one joke.
- Use short sentences and familiar words.
- Keep each speech bubble below 95 characters when possible.
- Use real story-world objects and character behavior. Do not paste technical words into random lore.
- End with the curious lead saying the core lesson back correctly.
- Do not use generic hype, fake stakes, or filler.

Image search rules

How to find grounded backgrounds and clean character art.

prompts/image-search.md

# Image search instruction

Find full-body transparent character renders and wide story-world backgrounds with no foreground characters. Prefer clean, recognizable art that matches the original show. Record the search query, source page, and direct image URL. Reject any background that makes the characters float or clips them at an impossible ground line.