gooseworks-ai/goose-skills / skills/video/render-offer-ad
render-offer-ad
VerifiedRender a punchy ~12s vertical (9:16) music-only direct-response OFFER ad as a 4-beat kinetic-typography film — HEADLINE slam → real PRODUCT drop → CLAIM/proof → CTA pill — from one config of copy slots, a real product photo, a brand palette, fonts, bpm, and beat split. DETERMINISTIC + FREE (a bundled Remotion project; springs + interpolate, no AI-gen for visuals). Backgrounds are engine gradient divs off the palette, props are inline SVG, the ONLY composited bitmap is the REAL product photo (objectFit:contain, never stretched), and ALL headline/claim/CTA/URL/wordmark text is typeset in the engine — never AI-rendered (the format's credibility guard). A driver binds the config to Remotion input props, renders the 9:16 master, and derives a 1:1 center-crop with ffmpeg. Two gating checks run before render (claim verbs must match the product's physical format; the claim beat needs an edge-entry mechanism prop). Use for the motion-graphics-offer-ad format.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.7 KB |
| project/.gitignore | other | 143 B |
| project/package.json | manifest | 503 B |
| project/public/.gitkeep | other | 0 B |
| project/remotion.config.ts | script | 116 B |
| project/src/Main.tsx | other | 1.5 KB |
| project/src/Root.tsx | other | 1.0 KB |
| project/src/fonts.ts | script | 1.4 KB |
| project/src/index.ts | script | 108 B |
| project/src/lib/anim.ts | script | 4.8 KB |
| project/src/props.ts | script | 4.2 KB |
| project/src/scenes/Scene01.tsx | other | 5.0 KB |
| project/src/scenes/Scene02.tsx | other | 4.9 KB |
| project/src/scenes/Scene03.tsx | other | 6.5 KB |
| project/src/scenes/Scene04.tsx | other | 3.5 KB |
| project/tsconfig.json | config | 293 B |
| scripts/config.example.json | config | 2.7 KB |
| scripts/render.py | script | 11.8 KB |
| skill.meta.json | config | 210 B |
| tests/smoke-test.md | markdown | 4.8 KB |
tests/smoke-test.md
View on GitHub# Smoke test — render-offer-ad
Verifies the free, deterministic Remotion assembly end-to-end. No paid calls. Needs:
**Node.js ≥18** and the bundled Remotion project's deps (the kit provides them;
`render.py` sets up `project/` if `node_modules` is absent), plus **ffmpeg** on PATH for the
1:1 crop. If node/Remotion aren't available, do the validation-only Phase B (config
binding + render-command wiring) and NOTE that a full render needs node/Remotion installed.
## Setup
```bash
cd skills/video/render-offer-ad
mkdir -p /tmp/offer-ad-smoke
# Copy the example config and REPLACE the placeholder paths:
# - product_hero_image : a REAL product photo (clean/transparent bg, any png/webp)
# - music.bed : an instrumental bed (or delete the "music" block to render silent)
cp scripts/config.example.json /tmp/offer-ad-smoke/config.json
# For a fast 2-second synthetic render, edit the copied config:
# - beat_split_sec : [0.5, 0.5, 0.5, 0.5] (→ 60 frames total ≈ 2s)
# - product_hero_image : any small png with a transparent bg
# - delete the "music" block (silent) so no audio asset is needed
```
## Phase A — full render (node + Remotion present)
```bash
python3 scripts/render.py \
--config /tmp/offer-ad-smoke/config.json \
--work-dir /tmp/offer-ad-smoke \
--out /tmp/offer-ad-smoke/master
```
Runs the two gating checks, stages the product photo into `project/public/`, writes the
input props to `/tmp/offer-ad-smoke/props.json`, renders `offer-ad --props …` to
`master-9x16.mp4`, then ffmpeg center-crops to `master-1x1.mp4`.
## Phase B — validation only (no node / Remotion not installed)
```bash
# 1) Gating checks + config→props binding, WITHOUT rendering. Point product_hero_image
# at any existing file (a placeholder is fine for the bind check). This exercises the
# gates and writes props.json; the render step will then fail only at `npx remotion`.
python3 scripts/render.py \
--config /tmp/offer-ad-smoke/config.json \
--work-dir /tmp/offer-ad-smoke \
--out /tmp/offer-ad-smoke/master ; echo "exit=$?"
# Inspect the bound input props:
cat /tmp/offer-ad-smoke/props.json
# 2) Confirm the render-command wiring is correct (no hardcoded /Users or clients paths):
grep -n "remotion render offer-ad" scripts/render.py
grep -n "crop=1080:1080" scripts/render.py
```
`props.json` must contain the config's copy slots / palette / bpm / beat_split mapped onto
the `OfferAdProps` keys (`palette`, `copy`, `product_image`, `mechanism_prop`, `bpm`,
`beat_split_sec`, `fonts`, `music`). NOTE in the run log that a full render needs
node/Remotion installed.
## Expect
- The two GATING CHECKS pass for the example config (`product_format: liquid` with
`spoon / 0 mess` claim vocab; `mechanism_prop: spoon`). Flip a claim line to a
powder verb (e.g. `scoop`) → `render.py` exits non-zero with a CLAIM-MATCHES-FORMAT
failure. Set `mechanism_prop` to something unsupported → a CLAIM-BEAT MECHANISM PROP
failure.
- `render.py` writes `/tmp/offer-ad-smoke/props.json` (the bound Remotion input props).
- Phase A writes `master-9x16.mp4` (1080×1920, 30fps) and, when `1:1` is in `aspects`,
`master-1x1.mp4` (1080×1080). Duration = `sum(beat_split_sec) × 30` frames (the 2s
synthetic config → 60 frames).
- Run the `watch` skill on `master-9x16.mp4`: the headline slams WORD-BY-WORD on the beat;
the real product photo drops in + idle-bobs and is NOT stretched (aspect preserved); the
mechanism prop enters from a frame edge on the claim beat; the claim lines drop in
staggered; the CTA label + URL are readable; the hard cuts land on the beat downbeats;
music (if supplied) is present and ramps out.
## Fail signals
- **`CLAIM-MATCHES-FORMAT gate failed`** → the claim/motif copy uses foreign-format verbs
for the declared `product_format` (a liquid using powder grammar). Rewrite the claim to
the product's real format. Use `--skip-gates` only if the mismatch is intentional.
- **`CLAIM-BEAT MECHANISM PROP gate failed`** → `mechanism_prop` isn't `spoon` or
`accent`. A text-only claim beat is too static — supply an edge-entry prop.
- **Product photo looks stretched / wrong aspect** → the source image was pre-distorted;
the engine uses `objectFit:contain` and never stretches. Supply a clean product photo.
- **Text looks smeared/warped** → something AI-rendered a letter; this engine typesets ALL
text in Remotion (springs + DOM), never a video model. Never route copy through image-gen.
- **Duration is wrong / cuts don't land on the beat** → `beat_split_sec` doesn't sum to
the intended length or doesn't match the `bpm`; the cut frames are DERIVED from
`beat_split_sec` (`Math.round(sec × 30)`), so re-time the split, don't trim the video.
- **`npx remotion` not found** → node/Remotion isn't installed; run `cd project && npm
install` (this capability legitimately requires a node runtime — the renderer is a
Remotion project).
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |