gooseworks-ai/goose-skills / skills/video/render-absurdist-explainer
render-absurdist-explainer
VerifiedAssemble an absurdist animated-explainer video ad (~38s, 9:16) from per-scene i2v clips + their measured VO windows — retime each clip to its VO, re-encode every segment to identical 30fps/libx264/yuv420p so the concat demuxer never drops frames, concat, build a REAL-product PIL end card (never AI) held static, mix VO (loudnorm I=-14) under music (loudnorm I=-26, volume 0.62, amix normalize=0), and burn libass captions last. FREE deterministic assembly (bash-free, Python + ffmpeg + PIL); the recipe supplies the clips, VO, music, product photo, palette, and caption table and gates the paid keyframe/clip/VO/music calls to their own capabilities. Use for the absurdist-explainer format.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.5 KB |
| scripts/build_endcard.py | script | 7.3 KB |
| scripts/compose.py | script | 16.5 KB |
| scripts/config.example.json | config | 4.5 KB |
| scripts/make_captions.py | script | 3.4 KB |
| skill.meta.json | config | 236 B |
| tests/smoke-test.md | markdown | 4.2 KB |
scripts/make_captions.py
View on GitHub#!/usr/bin/env python3
"""make_captions.py — emit a libass .ass, one caption pill per scene (v1).
Ports the validated caption recipe from the format's reference runs.
Reads the SAME config.json compose.py reads, so the per-scene target seconds are the
single source of truth — the caption windows are derived from the compose scene table,
guaranteeing they stay in lockstep with the cut.
Caption style (validated on both reference runs):
Arial 64px, white #FFFFFF, 6px outline #141414, 3px shadow, bottom-third MarginV=330.
Rules:
- Dialogue start = scene_start + 0.08s (avoids the caption flashing a frame before the
cut — see the molecule's Failure Modes).
- Each scene window is snapped to whole frames with the same rule compose.py uses, and
the cue end is rounded DOWN to the .ass time step (0.01s). So a caption never
outlives its cut by a frame.
- A scene with no `caption` (e.g. the end card) is suppressed — its own typeset copy
carries the message, and two text layers at the same spot are both unreadable.
"""
import argparse, json, math, os
FPS = 30 # must match compose.py
HEADER = """[Script Info]
ScriptType: v4.00+
PlayResX: 1080
PlayResY: 1920
WrapStyle: 0
ScaledBorderAndShadow: yes
[V4+ Styles]
Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding
Style: Cap,{font},{size},&H00FFFFFF,&H000000FF,&H00141414,&H00000000,-1,0,0,0,100,100,0,0,1,{outline},{shadow},2,90,90,{marginv},1
[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
"""
def ts(s):
h = int(s // 3600)
m = int((s % 3600) // 60)
sec = s % 60
return f"{h}:{m:02d}:{sec:05.2f}"
def snap(sec):
"""Snap a duration to whole frames, in seconds. The SAME rule as compose.py snap()."""
return int(float(sec) * FPS + 0.5) / FPS
def main():
ap = argparse.ArgumentParser(description="Emit the per-scene caption .ass.")
ap.add_argument("--config", required=True)
ap.add_argument("--out", help="output .ass path (defaults to config.captions_ass)")
a = ap.parse_args()
with open(a.config, encoding="utf-8-sig") as f: # UTF-8, with or without a BOM
cfg = json.load(f)
scenes = cfg["scenes"]
cap_cfg = cfg.get("caption_style", {})
header = HEADER.format(
font=cap_cfg.get("font", "Arial"),
size=cap_cfg.get("size", 64),
outline=cap_cfg.get("outline", 6),
shadow=cap_cfg.get("shadow", 3),
marginv=cap_cfg.get("marginv", 330),
)
lines, t = [], 0.0
for s in scenes:
dur = snap(s["target_sec"])
cap = s.get("caption")
if cap:
end = math.floor((t + dur) * 100 + 1e-6) / 100 # never past the cut
lines.append(f"Dialogue: 0,{ts(t + 0.08)},{ts(end)},Cap,,0,0,0,,{cap}")
t += dur
# end card window has no caption (its typeset copy carries it)
out = a.out or cfg.get("captions_ass")
if not out:
raise SystemExit("no --out and no config.captions_ass set")
os.makedirs(os.path.dirname(os.path.abspath(out)), exist_ok=True)
with open(out, "w", encoding="utf-8") as f:
f.write(header + "\n".join(lines) + "\n")
print(f"captions.ass written - {len(lines)} cues, total {t:.2f}s -> {out}")
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |