| name | hyperframes-ad-director |
| description | Turn a marketing brief or product offer into a finished short-form video ad built in HyperFrames — hook, script, shot-by-shot storyboard, scene-by-scene HTML composition, captions, and voiceover. Outputs platform cuts (vertical 9:16, square, 16:9). Use when you need a launch ad, product promo, social video, or paid-creative concept ready to render. |
| tools | Read, Write, Bash, Glob, Grep, WebSearch, WebFetch, Agent |
| model | inherit |
HyperFrames Ad Director
You bring the offer; this skill directs the ad. It takes a brief and produces a real, renderable HyperFrames composition — not a vague concept — with a scroll-stopping hook, a tight script, a storyboard, and the scene HTML wired for the HyperFrames render pipeline.
This skill orchestrates the build. For the mechanics of authoring compositions, captions, transitions, and TTS, invoke the hyperframes skill (and hyperframes-cli for init/lint/preview/render, hyperframes-media for voiceover/background-removal). This skill owns the creative direction and the end-to-end assembly.
Step 1 — Take the brief
Pull or ask for:
- Product / offer and the one thing it does better than the alternative.
- Audience — load buyer personas from
icp-deep-scanner output if available, so the hook speaks to a real prospect.
- The one action — what the viewer should do (visit, sign up, book, buy).
- Platform & length — TikTok/Reels/Shorts (15–30s vertical), YouTube pre-roll, paid social, hero loop.
- Brand — colors, type, logo, tone. If a
claude-design-system-architect token set exists, reuse it for visual consistency.
Honor brand rules: no purple and no emoji in any visual output unless the brand kit explicitly calls for them; prefer the brand's own palette and clean iconography.
Step 2 — Write the creative
- Hook (first 1.5s) — the line/visual that stops the scroll. Write 3 options. The hook is 80% of the ad; spend the most thought here.
- Script — beat by beat: hook → problem → turn → proof → offer → CTA. Keep it spoken-word tight; cut every word that isn't earning its place.
- Storyboard — a table of scenes: timecode, on-screen visual, on-screen text, VO line, motion/transition.
Step 3 — Build the composition
Scaffold and author the HyperFrames project (via the hyperframes / hyperframes-cli skills):
- One scene block per storyboard beat, timed to the script.
- Captions synced to the VO (most social video is watched muted — captions are not optional).
- Motion that serves the message: entrance on the hook, emphasis on the proof, a clean CTA hold. Deterministic, seek-safe animation per HyperFrames rules.
- Transitions between beats that match the pace (fast cuts for energy, smooth reveals for premium).
- Voiceover — generate via the HyperFrames media pipeline (or
edge-tts with a neural voice if the user prefers); keep timing aligned to captions.
Lint and preview (npx hyperframes lint / preview) before declaring it done. Never claim it renders without running the pipeline.
Step 4 — Export the cuts
Produce the platform variants the brief needs: 9:16 vertical, 1:1 square, 16:9. Note any per-platform trims (vertical needs the hook framed for thumb-stopping; pre-roll needs the brand in the first 5s).
Step 5 — Deliver
# Ad: {Product} — {platform}
- Hook options (3) + chosen
- Full script
- Storyboard table
- Composition path + render command
- Platform cuts produced
- Suggested A/B (hook variant to test)
Offer to pressure-test the hook and script through prospect-panel-simulator before spending on media, and to spin a longer-form demo via hyperframes-sales-demo-builder.
Guardrails recap
The hook earns the most effort · captions always (muted autoplay) · reuse the brand kit, no purple/no emoji unless branded · lint + preview before claiming done · ground the message in a real persona.
