Shorts Animator
A script and a look in, an animated short out. You write the lines and draw every shot as canvas code; the
tool paints it on the GPU on twos, narrates it with a local Kokoro voice, captions it, scores it and
encodes the MP4. Nothing is filmed, generated by an image model, or licensed.
SA = node <this skill's folder>/scripts/sa.ts. Write the full command each time. One folder per short:
WORK=./<slug>-short. First run on a machine: SA doctor (checks Node, ffmpeg, Chrome, sets up the voice,
renders a 3-second test).
1. Decide, do not interrogate
Decide the lines, shots, look, voice and music yourself. Ask one question only if the subject is unclear.
A pasted script is used word for word. A topic: write it per references/writing.md.
| they say |
look |
| oil, painterly, Van Gogh, swirly, "like the faith shorts" |
oil |
| watercolour, soft, dreamy, children's book |
watercolor |
| crayon, pastel, chalk, for kids |
pastel |
| ink, comic, graphic novel, line art |
ink |
| flat, storybook, gouache, poster, calm |
gouache |
Custom look: "look": { "base": "oil", "brush": 16, "palette": {...} }. Read references/looks.md only
when overriding numbers. Voice bm_george (default, scripture and quotes), am_michael, bf_emma
(stories), af_heart (kids); speed 0.85 to 0.95 reads calm. Their recording: "voice": { "file": "assets/voice.m4a" } with say lines matching it in order. "voice": "none" for music only. Music
mood: tender, hopeful, night, wonder, playful, none, or a track path. SA looks lists all.
2. Write the plan and the drawings
SA new "$WORK" --look oil # short.json + scenes.js + assets/
short.json lines: { "say": "...", "scene": "meadow" | ["a", "b"], "move": "push", "hold": 0.8 }.
- A list of scenes cuts on the caption chunks. Cut often: a new picture every 1.5 to 3 s.
move: push, pull, pan-left, pan-right, rise, fall, drift, still. transition: cut, fade, dip (rarely).
caption shows different words; / forces a break. captions.style: box, plain, none.
format: 9:16 (default), 16:9, 1:1, 4:5. twos: 2 (hand-drawn), 1 (smooth).
scenes.js: window.SCENES = { "meadow": (k) => { k.sky({...}); k.person({...}); } }. Read
references/kit.md before writing scenes. Draw like a painter:
- Big simple shapes, strong value contrast, one subject. The paint pass adds texture; draw nothing fussy.
- Keep faces out of the caption band (about 77% down).
- Every shot different: place, scale, day and night, warm and cool. Match the words.
- Small motion:
pose: "walk", dx, rain, glints. k.t seconds, k.p progress 0 to 1.
- No helper for it (a boat, an animal)? Write a small function with
k.g, flat shapes in the palette.
3. Check, then look (budgeted)
SA check "$WORK" # no browser, about a second: missing scenes, throwing scenes, unknown kit calls,
# figures under the captions, line and total length
SA frames "$WORK" # narrates (cached), one painted frame per shot -> frames/sheet.jpg
SA still "$WORK" 7 # one shot full size, only when the sheet shows a problem you cannot place
Fix every ERROR from check before spending a browser run. Then read frames/sheet.jpg once. Fix muddy
or empty shots, a figure lost in its background (contrast, rim), look-alike shots, a red "no scene"
frame, and every ⚠ the page said line. Budget: at most two frames rounds before the first render.
Images are the expensive part of this loop; do not reopen a sheet you have already judged.
4. Render and deliver
SA render "$WORK" # about a minute for 40 s -> <title>.mp4, renders/vN.mp4 (+ its short.json), qa/sheet.jpg
Read qa/sheet.jpg only if the render printed a warning or they report a problem. Tell them in two
lines what it is (look, length, shots) and: "Tell me what to change, one sentence is enough."
5. One-sentence changes
Smallest change, SA check, render, show. SA set "$WORK" voice.speed=0.85 music.mood=night edits
short.json (JSON values; plain text otherwise) and refuses an invalid result.
| they say |
change |
| more painterly, softer |
look or its numbers (brush, swirl, wash) |
| slower, faster |
voice.speed, pause |
| a woman's voice, American |
voice.id |
| no music, more emotional |
music.mood |
| bigger captions, no box |
captions.size 52, captions.style plain |
| for YouTube |
format 16:9, redraw shots whose layout breaks |
| change shot 4 |
that scene function only |
When something goes wrong
| symptom |
fix |
| no Chrome |
install Chrome, or SA doctor fetches a headless one |
| "painting on the CPU" |
works, about 10x slower |
| narrator setup fails |
needs Python 3.10+ or uv; or use "voice": "none" or their recording |
| voice timing off with their recording |
say lines must match its words, in order |
1---2name: shorts-animator3description: Use when someone wants a narrated, painted or hand-drawn animated short (TikTok, Reels, YouTube Shorts) from a script or topic and a look described in words. Every frame is drawn in code and GPU-painted, voiced locally, captioned and scored into an MP4; no image models or stock.4license: MIT5allowed-tools: Bash, Read, Write, Edit6compatibility: Codex, Claude Code, Hermes Agent, Cursor, GitHub Copilot, Windsurf, Kiro, and other Agent Skills compatible tools. Needs Node 22.18+, ffmpeg and Chrome; the narrator installs Python and its voice model on first use.7metadata:8 source: https://skillmd.com/skills/oleg-koval/shorts-animator9 targets: [_source-only]10 author: Oleg Koval11 tags:12 - video13 - animation14 - shorts15 - narration16 - canvas17---1819# Shorts Animator2021A script and a look in, an animated short out. You write the lines and draw every shot as canvas code; the22tool paints it on the GPU on twos, narrates it with a local Kokoro voice, captions it, scores it and23encodes the MP4. Nothing is filmed, generated by an image model, or licensed.2425`SA` = `node <this skill's folder>/scripts/sa.ts`. Write the full command each time. One folder per short:26`WORK=./<slug>-short`. First run on a machine: `SA doctor` (checks Node, ffmpeg, Chrome, sets up the voice,27renders a 3-second test).2829## 1. Decide, do not interrogate3031Decide the lines, shots, look, voice and music yourself. Ask one question only if the subject is unclear.32A pasted script is used word for word. A topic: write it per `references/writing.md`.3334| they say | look |35|---|---|36| oil, painterly, Van Gogh, swirly, "like the faith shorts" | `oil` |37| watercolour, soft, dreamy, children's book | `watercolor` |38| crayon, pastel, chalk, for kids | `pastel` |39| ink, comic, graphic novel, line art | `ink` |40| flat, storybook, gouache, poster, calm | `gouache` |4142Custom look: `"look": { "base": "oil", "brush": 16, "palette": {...} }`. Read `references/looks.md` only43when overriding numbers. Voice `bm_george` (default, scripture and quotes), `am_michael`, `bf_emma`44(stories), `af_heart` (kids); `speed` 0.85 to 0.95 reads calm. Their recording: `"voice": { "file":45"assets/voice.m4a" }` with `say` lines matching it in order. `"voice": "none"` for music only. Music46`mood`: `tender`, `hopeful`, `night`, `wonder`, `playful`, `none`, or a track path. `SA looks` lists all.4748## 2. Write the plan and the drawings4950```bash51SA new "$WORK" --look oil # short.json + scenes.js + assets/52```5354`short.json` lines: `{ "say": "...", "scene": "meadow" | ["a", "b"], "move": "push", "hold": 0.8 }`.55- A list of scenes cuts on the caption chunks. Cut often: a new picture every 1.5 to 3 s.56- `move`: push, pull, pan-left, pan-right, rise, fall, drift, still. `transition`: cut, fade, dip (rarely).57- `caption` shows different words; `/` forces a break. `captions.style`: box, plain, none.58- `format`: 9:16 (default), 16:9, 1:1, 4:5. `twos`: 2 (hand-drawn), 1 (smooth).5960`scenes.js`: `window.SCENES = { "meadow": (k) => { k.sky({...}); k.person({...}); } }`. Read61`references/kit.md` before writing scenes. Draw like a painter:62- Big simple shapes, strong value contrast, one subject. The paint pass adds texture; draw nothing fussy.63- Keep faces out of the caption band (about 77% down).64- Every shot different: place, scale, day and night, warm and cool. Match the words.65- Small motion: `pose: "walk"`, `dx`, rain, glints. `k.t` seconds, `k.p` progress 0 to 1.66- No helper for it (a boat, an animal)? Write a small function with `k.g`, flat shapes in the palette.6768## 3. Check, then look (budgeted)6970```bash71SA check "$WORK" # no browser, about a second: missing scenes, throwing scenes, unknown kit calls,72 # figures under the captions, line and total length73SA frames "$WORK" # narrates (cached), one painted frame per shot -> frames/sheet.jpg74SA still "$WORK" 7 # one shot full size, only when the sheet shows a problem you cannot place75```7677Fix every `ERROR` from `check` before spending a browser run. Then read `frames/sheet.jpg` once. Fix muddy78or empty shots, a figure lost in its background (contrast, `rim`), look-alike shots, a red "no scene"79frame, and every `⚠ the page said` line. **Budget: at most two frames rounds before the first render.**80Images are the expensive part of this loop; do not reopen a sheet you have already judged.8182## 4. Render and deliver8384```bash85SA render "$WORK" # about a minute for 40 s -> <title>.mp4, renders/vN.mp4 (+ its short.json), qa/sheet.jpg86```8788Read `qa/sheet.jpg` only if the render printed a warning or they report a problem. Tell them in two89lines what it is (look, length, shots) and: "Tell me what to change, one sentence is enough."9091## 5. One-sentence changes9293Smallest change, `SA check`, render, show. `SA set "$WORK" voice.speed=0.85 music.mood=night` edits94short.json (JSON values; plain text otherwise) and refuses an invalid result.9596| they say | change |97|---|---|98| more painterly, softer | `look` or its numbers (brush, swirl, wash) |99| slower, faster | `voice.speed`, `pause` |100| a woman's voice, American | `voice.id` |101| no music, more emotional | `music.mood` |102| bigger captions, no box | `captions.size` 52, `captions.style` plain |103| for YouTube | `format` 16:9, redraw shots whose layout breaks |104| change shot 4 | that scene function only |105106## When something goes wrong107108| symptom | fix |109|---|---|110| no Chrome | install Chrome, or `SA doctor` fetches a headless one |111| "painting on the CPU" | works, about 10x slower |112| narrator setup fails | needs Python 3.10+ or `uv`; or use `"voice": "none"` or their recording |113| voice timing off with their recording | `say` lines must match its words, in order |