gooseworks-ai/goose-skills / skills/video/render-3d-character-explainer
render-3d-character-explainer
VerifiedAssemble an animated character-explainer video ad (~77s, 9:16, any art style: Pixar-style 3D, claymation, anime, paper-cut, felt) on an "N types of X" listicle spine: one recurring human protagonist plus one persona character per list item. Given per-scene clips, a scene timing table and narration, it trims, normalises, concatenates and mixes them, reusing the source ad's audio (restyle) or fresh per-scene voiceover over a music bed (original), loops a scene's keyframe when its clip failed, and burns captions last. Free, deterministic assembly (Python and ffmpeg, no paid calls); the recipe supplies the clips, keyframes, audio and captions. Use for the 3d-character-explainer format.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.8 KB |
| scripts/compose.py | script | 11.7 KB |
| scripts/config.example.json | config | 4.4 KB |
| scripts/make_captions.py | script | 3.2 KB |
| skill.meta.json | config | 239 B |
| tests/smoke-test.md | markdown | 4.2 KB |
scripts/config.example.json
View on GitHub{
"_comment": "Worked example (the demo: a 'six types of laundry stains' Pixar-style 3D restyle for Sudsmith, a made-up stain-remover brand). Creative fields — scenes[].caption (the script, written in the narrator's POV from choices.narrator + choices.tone), source_audio / scenes[].vo (narration: choices.narrator + choices.narrator_voice), music_bed + music_volume (choices.music; null = no music), pad_color (brand palette) — come from the recipe's choices; never copy them as defaults. The art style (choices.visual_style) and protagonist (choices.protagonist) live in the clips/keyframes handed in, not here. The recipe binds a NEW ad's own clips / keyframes / audio / caption table here. Every path is a placeholder to REPLACE with an absolute path or a runtime working/ path. MODE: 'restyle' reuses a source ad's VO+music mix VERBATIM (source_audio) and inherits its scene timing — no per-scene vo/music fields are read. 'original' authors its own per-scene VO windows (scenes[].vo, target_sec = the MEASURED VO duration) + an optional music_bed. `keyframe` per scene is the static-still FALLBACK: if scenes[].clip is missing/failed, that scene's keyframe PNG is looped for target_sec so the master always assembles.",
"audio_mode": "restyle",
"source_audio": "/abs/or/working/audio/source-audio.mp3",
"music_bed": null,
"music_volume": 0.62,
"atempo": null,
"width": 1080,
"height": 1920,
"pad_color": "0x1c2233",
"captions_ass": "/abs/or/working/audio/captions.ass",
"caption_style": {
"font": "Arial",
"size": 64,
"outline": 6,
"shadow": 3,
"marginv": 330
},
"scenes": [
{ "id": "01", "clip": "/abs/or/working/clips/clip-01.mp4", "keyframe": "/abs/or/working/keyframes/scene-01.png", "target_sec": 4.0, "caption": "Think a stain is just a stain?" },
{ "id": "02", "clip": "/abs/or/working/clips/clip-02.mp4", "keyframe": "/abs/or/working/keyframes/scene-02.png", "target_sec": 5.3, "caption": "Scrubbing harder just spreads it." },
{ "id": "03", "clip": "/abs/or/working/clips/clip-03.mp4", "keyframe": "/abs/or/working/keyframes/scene-03.png", "target_sec": 5.3, "caption": "Each stain grips fabric differently." },
{ "id": "04", "clip": "/abs/or/working/clips/clip-04.mp4", "keyframe": "/abs/or/working/keyframes/scene-04.png", "target_sec": 4.5, "caption": "Meet the six troublemakers." },
{ "id": "05", "clip": "/abs/or/working/clips/clip-05.mp4", "keyframe": "/abs/or/working/keyframes/scene-05.png", "target_sec": 6.0, "caption": "1. The greasy splatterers." },
{ "id": "06", "clip": "/abs/or/working/clips/clip-06.mp4", "keyframe": "/abs/or/working/keyframes/scene-06.png", "target_sec": 5.5, "caption": "2. The red-wine raiders." },
{ "id": "08", "clip": "/abs/or/working/clips/clip-08.mp4", "keyframe": "/abs/or/working/keyframes/scene-08.png", "target_sec": 5.6, "caption": "3. The grass-stain sliders." },
{ "id": "09", "clip": "/abs/or/working/clips/clip-09.mp4", "keyframe": "/abs/or/working/keyframes/scene-09.png", "target_sec": 7.3, "caption": "4. Sneaky sweat-ring settlers." },
{ "id": "10", "clip": "/abs/or/working/clips/clip-10.mp4", "keyframe": "/abs/or/working/keyframes/scene-10.png", "target_sec": 4.6, "caption": "5. The ink blotters." },
{ "id": "11", "clip": "/abs/or/working/clips/clip-11.mp4", "keyframe": "/abs/or/working/keyframes/scene-11.png", "target_sec": 5.8, "caption": "6. Mystery mud from nowhere." },
{ "id": "12", "clip": "/abs/or/working/clips/clip-12.mp4", "keyframe": "/abs/or/working/keyframes/scene-12.png", "target_sec": 0.5, "caption": "But wait." },
{ "id": "13", "clip": "/abs/or/working/clips/clip-13.mp4", "keyframe": "/abs/or/working/keyframes/scene-13.png", "target_sec": 5.2, "caption": "One basic detergent can't lift every type." },
{ "id": "14", "clip": "/abs/or/working/clips/clip-14.mp4", "keyframe": "/abs/or/working/keyframes/scene-14.png", "target_sec": 2.3, "caption": "Each needs its own game plan." },
{ "id": "15", "clip": "/abs/or/working/clips/clip-15.mp4", "keyframe": "/abs/or/working/keyframes/scene-15.png", "target_sec": 2.6, "caption": "Which mess are you facing?" },
{ "id": "16", "clip": "/abs/or/working/clips/clip-16.mp4", "keyframe": "/abs/or/working/keyframes/scene-16.png", "target_sec": 5.1, "caption": null },
{ "id": "17", "clip": "/abs/or/working/clips/clip-17.mp4", "keyframe": "/abs/or/working/keyframes/scene-17.png", "target_sec": 7.2, "caption": null }
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |