Skip to content

gooseworks-ai/goose-skills / skills/video/render-stopmotion-hand-swatch-cycle

render-stopmotion-hand-swatch-cycle

Verified

Assemble a stop-motion hand-swatch-cycle product-demo ad from a config — a sequence of still PLATES (one hand swiping a single-barrel product across a test surface, the barrel + swatch changing per plate while the hand, background, crop, and lighting stay locked) is PNG→mp4 loop-encoded at each plate's own stop-motion hold (fast motion frames 150–250ms, per-shade ~380ms, hero beats 1100–1800ms), concat-demuxed with HARD cuts into a silent master, closed on a Playwright HTML-rendered branded end card (serif tagline + sans subtitle + real logo SVG over a hero BG, never AI-rendered text), and muxed with a pre-sourced music track playing under the end card with a fade tail (no VO). This is the FREE deterministic assembly stage (loop-encode + concat-demux + end-card render + music mux); the master-anchor plate, shade plates, and end-card BG come from create-image-gpt-image-fal and the track from create-music-elevenlabs. Use for the stopmotion-hand-swatch-cycle format.

FileKindSize
SKILL.mdskill md4.9 KB
scripts/PIPELINE.mdmarkdown5.7 KB
scripts/README.mdmarkdown3.0 KB
scripts/config.example.jsonconfig11.2 KB
skill.meta.jsonconfig190 B
tests/smoke-test.mdmarkdown1.4 KB

scripts/README.md

View on GitHub
# render-stopmotion-hand-swatch-cycle scripts — the FREE assembly

`render-stopmotion-hand-swatch-cycle` is the **deterministic, free assembly stage** of the stop-motion
hand-swatch-cycle format. The paid stages (the master-anchor plate, the N per-shade / motion / finale
plates, the end-card hero BG, the music track) are separate capabilities —
`create-image-gpt-image-fal` and `create-music-elevenlabs`. This capability spends nothing: it takes
the ordered plate PNGs + per-plate holds + the end-card hero BG + the brand logo SVG + the music
track and stitches the finished master. Re-cuts (re-timed holds, a re-ordered cycle, a swapped end
card, a different track) reuse the existing plates and spend nothing.

`config.example.json` is the worked example (Kestrel Art Supply "Swipe Your Color", ~16.6s 1080×1920) —
its hand, background, surface and music are the demo's; the recipe's choices supply yours.
`PIPELINE.md` maps every config block to its source step. This README documents the FREE assembly
pieces that `render-stopmotion-hand-swatch-cycle` owns.

## 1. Still plates — PNG→mp4 loop-encode at each plate's stop-motion hold

Each plate is a static PNG, loop-encoded to a short mp4 at its own `pose_hold_ms` (`ffmpeg -loop 1
-t <hold>`, scale/crop to 1080×1920 @ 30fps crf18). This is stop-motion — discrete held frames, no
camera moves, no character animation. The holds set the cadence: fast motion / half-painted plates
150–250ms, per-shade plates ~380ms (or ~1000ms for a slower, more scannable cycle), hero / bookend
beats 1100–1800ms. Average ~380ms gives the tactile frame-swap feel.

## 2. Concat-demux on hard cuts

Concat-**demux** the plate mp4s in order (`ffmpeg -f concat` over the ordered plate list) with HARD
cuts — no dissolves. The frame-swap tactility is the whole point of stop-motion; a crossfade erases
it. Concat-demux (not `filter_complex`) is correct because the plates are silent stills with no audio
to reconcile. The demo ran 27 plate clips into a ~13.6s silent body master.

## 3. End card — Playwright HTML from the real logo SVG, no AI text

The end card is a Playwright (Chromium headless) render of an HTML template — a serif tagline + a
sans subtitle + the real logo SVG composited over a `gpt-image-2` hero product/swatch BG — rendered
to a silent ~3s clip. The brand text is **never** AI-rendered — a diffusion model garbles a wordmark.
On macOS pick a font with the em-dash / middle-dot glyph for the subtitle separator.

## 4. FFmpeg composite + music mux

FFmpeg stitches the master: loop-encode each plate, concat-demux on hard cuts into the silent body
master, append the end card holding ~3s, then mux the pre-sourced music track (volume ≈0.4, fade
in/out) OVER the whole video including the end card with a fade at the tail (no silent tail — the
video ends WITH the music). The music IS the bed — no separate VO. Output is a 1080×1920 h264 + aac
master (~16.6s). Deterministic, no paid calls, no keys (beyond the Playwright/Chromium the end-card
render needs).
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall