Super Video Maker Skill

---
name: super-video-maker
description: |
  End-to-end AI video production skill for agentic frameworks. Use when the
  user asks to make, edit, repurpose, caption, soundtrack, or export videos
  using HeyGen avatars, Seedance or ByteDance b-roll, OpenAI image generation
  and editing, AI UGC ads, Remotion, HyperFrames, screen recordings, FFmpeg,
  captions, ElevenLabs music, Suno, or social-video variants.
metadata:
  requires:
    env:
      - HEYGEN_API_KEY
      - HEYGEN_AVATAR_ID
      - FALAI_API_KEY
      - OPENAI_API_KEY
      - ELEVENLABS_API_KEY
---

# Super Video Maker

## What this skill does

Turns a video idea, script, product flow, screen recording, avatar brief, or
existing long-form video into polished video assets. The skill can produce:

- **Avatar Explainers** (`avatar-explainer`): proof-driven avatar videos with a synthetic presenter, screen recordings/source receipts, UI micro-stories, captions, and action takeaways,
- **UGC AI Ads** (`ugc-ai-ad`): paid-social ads with a fictional AI creator, reference-image character consistency, Seedance 2.5 clips, ElevenLabs voice consistency, hook variants, captions, and direct-response CTAs,
- **Motion Collage Explainers** (`motion-collage-explainer`): faceless one-idea explainer shorts built from a bold screen-print cutout collage still (`gpt-image-2`) animated into a living collage with Seedance 2.5, narrated in a calm "In a Nutshell" documentary voice (see `MOTION_COLLAGE_STYLE.md`),
- avatar videos with HeyGen,
- AI b-roll with Seedance 2.5 through fal.ai,
- generated or edited images with OpenAI image models,
- screen recordings with cursor/event logs,
- motion graphics in Remotion or HyperFrames,
- captions, subtitles, music, and final FFmpeg exports.

## Read these files when needed

- `VIDEO_COPY_PLAYBOOK.md` for the copy layer of EVERY recipe: the four-line spine (one viewer, one promise, one mechanism, one next step), the two-track rule (voice carries the argument, screen carries the evidence, neither repeats the other), on-screen copy craft (kinetic headlines, data badges, ghost titles, end-card offers, the typographic strike), format-by-format arcs, credibility rules, and the copy gate to run before the first paid generation call. Read it BEFORE writing any script, hook, headline, or CTA, and read its section 11 FIRST: a transcribed reference VO in the owner-approved PLAIN REGISTER (zero figures of speech in 70 seconds) plus a before/after table of copy the owner rejected as "too poetic, too conceptual, AI slop". The pointing test lives there: if the viewer cannot point at the noun you just said, rewrite it. Pairs with the `copywriting-skill` skill, which owns the general voice and rhythm rules.
- `SPOKEN_VO_HUMANIZER.md` for how a spoken line should SOUND (12 rules for short-form scripts + the banned spoken-AI tells list).
- `HOOK_PLAYBOOK_ARTICLE_SPRINT.md` for hook families, the angle-before-copy rule, and loop accounting.
- `recipes/README.md` and `tools/video_recipes.py` for machine-readable video recipes (list, match, plan, validate).
- `REFERENCE.md` for provider capabilities and routing decisions.
- `FFMPEG_PLAYBOOK.md` for exact FFmpeg recipes.
- `WORKFLOW_EXAMPLES.md` for full production examples.
- `REMOTION_VIDEO_GUIDE.md` for Remotion motion-design rules.
- `TABLETOP_EXPLAINER_PLAYBOOK.md` + `workflows/tabletop-levels-explainer/` for building tiered "levels-of-X" explainer reels (fictional presenter + first/last-frame craft b-roll + beat-locked switch-assembly).
- `LIVING_CANVAS_PLAYBOOK.md` + `workflows/living-canvas-explainer/` for boutique-grade single-canvas SaaS launch/explainer videos: element-level pacing on one continuous canvas (0-3 hard cuts), VO-word-locked camera choreography over persistent UI cards, causal physics + layout reflow + transformation chains, story cold-opens with emotional VO and comedy timing, three-band music, and a beat-locked SFX bus. Read it BEFORE any "make it feel like a top motion studio" request — every duration, zoom factor, and spring constant is specified.
- `HYPERREALISTIC_IMAGE_SOP.md` for the 12-part framework that turns a reference image into a photorealistic, non-AI-looking UGC creator prompt. Read it before generating any creator still or hyperrealistic character.
- `MOTION_COLLAGE_STYLE.md` for the `motion-collage-explainer` recipe: how to build a bold screen-print cutout collage still with `gpt-image-2`, animate it into a living collage with Seedance 2.5, and narrate it in a calm "In a Nutshell" documentary explainer voice. Read it before making any faceless collage/idiom/concept explainer short.
- `REVIEW_VIDEO_PLAYBOOK.md` + `commands/review-video.md` for the `review-conquest-compilation` recipe (`/review-video`): a faceless VO montage of REAL, verified competitor reviews targeting the "<competitor> reviews" keyword, that names the recurring complaints, positions **the user's own business** as the alternative, then appends the user's own testimonial reel. Read it before making any competitor-review / comparison / conquest video. The business at the end is a variable — never hardcode a specific company.

## Operating rules

1. **Run a staged pipeline, not random tool calls.** Use: intake -> script/shot list -> assets -> assembly -> FFmpeg finishing -> QC -> exports.
1a. **Copy is a production gate, not a garnish.** Before the first TTS call, clip generation, or timeline build, write the four-line spine from `VIDEO_COPY_PLAYBOOK.md` (one viewer, one promise, one mechanism, one next step), pick the angle, and run its copy checklist. Voice and screen must never carry the same sentence: mute the video and the story should still track, blank the screen and the argument should still land. This ordering is not stylistic. In VO-locked formats the script IS the timeline, so a script change after the build re-locks every frame number.