Skip to main content
skill CX Codex

hyperframes-ad-director — Claude Code skill: what it does

hyperframes-ad-director turns a marketing brief into a finished short-form video ad built in HyperFrames: hook, script, storyboard, HTML composition, captions, and voiceover.

MIT 185 installs ★ 440 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OneWave-AI/claude-skills --skill hyperframes-ad-director -a claude-code
Open on GitHub

What hyperframes-ad-director does

The skill takes a product description or offer and produces a renderable HyperFrames project — with a scroll-stopping hook, a tight script, a shot-by-shot storyboard, and an HTML composition wired for the render pipeline. Generates platform variants: vertical 9:16 for TikTok and Reels, square 1:1, horizontal 16:9 for pre-roll. Captions are synced to voiceover because most social video plays muted.

Works in five steps: gathers the brief (product, audience, action, platform, brand), writes three hook options and a script following hook → problem → turn → proof → offer → CTA, builds a storyboard with timecode, visuals, and text, assembles the HyperFrames composition with animations and transitions, exports cuts for each platform. Without FFmpeg and HyperFrames dependencies the composition will not build — the skill lints and previews before declaring it ready. Reuses colors and tokens from claude-design-system-architect if present in the project.

The hook is 80% of the ad, so the skill proposes three variants and provides a table for A/B testing. Can run the script through prospect-panel-simulator to check response before spending on media.

What it helps with

  • assemble a short video ad from a brief in one pass
  • write a hook that stops the scroll in the first one and a half seconds
  • sync captions to voiceover for muted autoplay
  • export 9:16, 1:1, and 16:9 variants for different platforms
  • test three hook variants before launching the campaign

Example prompts for the agent

  • Build a launch ad for a SaaS product: audience is startup founders, platform is Instagram Reels, 20 seconds long
  • Assemble a promo video from the brief in brief.md, vertical format for TikTok, action is landing page visit
  • Write three hook variants for an online course video and build a HyperFrames composition with captions

How to install hyperframes-ad-director

1Skills CLI (Vercel)

npx skills add OneWave-AI/claude-skills --skill hyperframes-ad-director -a claude-code

2Manually: put the files in place

~/.claude/skills/hyperframes-ad-director/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/hyperframes-ad-director/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about hyperframes-ad-director

How to install hyperframes-ad-director in Claude Code?

Run npx skills add OneWave-AI/claude-skills --skill hyperframes-ad-director -a claude-code, then open ~/.claude/skills/hyperframes-ad-director/SKILL.md.

What does hyperframes-ad-director do?

Turns a marketing brief into a finished short video ad built in HyperFrames: writes hook and script, builds a storyboard, assembles an HTML composition with captions and voiceover, exports variants for TikTok, Reels, YouTube.

What does hyperframes-ad-director need to work?

FFmpeg and HyperFrames dependencies — the skill calls hyperframes and hyperframes-cli for composition assembly, linting, and rendering. Without them the project will not build or run in preview.

Source text

SKILL.md · MIT
---
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

1. **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.
2. **Script** — beat by beat: hook → problem → turn → proof → offer → CTA. Keep it spoken-word tight; cut every word that isn't earning its place.
3. **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
```markdown
# 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.

© OneWave-AI · MIT · OneWave-AI/claude-skills

Similar skills

All skills for Marketing and content →
tiktok-launch-video Cogny AI tiktok-launch-video — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that renders a 9:16 TikTok-native launch video via HyperFrames: hook inside the first second, burned-in captions, fast cuts. CX Codex +1 ★ 116repo stars hyperframes-cli heygen-com hyperframes-cli is a Claude Code skill for managing HyperFrames video projects, from scaffolding and frame checks to timeline edits and rendering. The agent invokes it to inspect or build a video. CX Codex +1 1,700,000installs website-to-hyperframes official HeyGen The website-to-hyperframes skill turns a website URL into a HyperFrames video project, covering capture, scripting, storyboarding, voice timing, and validation. CX Codex GP ChatGPT +1 2installs hyperframes calesthio This skill routes video and motion requests through HyperFrames, which renders compositions from HTML. Use it for editing, animation, captions, and finished video. CX Codex +1 ★ 78,316repo stars motion-director motionforge contributors motion-director — a skill for Claude Code that guides coded motion-design videos from brief to checked MP4. It starts on requests for a reel, animated explainer, product clip, or video cover and captions. CX Codex +1 ★ 128repo stars hyperframes-registry heygen-com hyperframes-registry is a skill that finds and adds editable HyperFrames blocks for transitions, titles, captions, charts, maps, and 3D scenes. It searches the catalog before manual effect building. CX Codex +1 1,400,000installs

From the same set185

The whole set →
expansion-revenue-finder The expansion-revenue-finder skill for Claude Code finds upsell and cross-sell opportunities by analyzing product usage, team growth, and competitive pressure, then scores each by revenue potential, effort, and likelihood. CX Codex +1 247installs agent-swarm-deployer agent-swarm-deployer deploys parallel sub-agent swarms for heavy data jobs like bulk document summarization, dataset processing, and multi-record content generation. CX Codex +1 247installs churn-autopsy churn-autopsy — a skill for post-mortem analysis of client churn. Collects interaction history, support tickets, usage logs and exit feedback, then builds a timeline of decline and identifies root causes. CX Codex +1 244installs scout-pro scout-pro scans conversation history, verifies installed tools, and builds multi-skill chains tailored to your current development task. CX Codex +1 244installs claude-design-critic The claude-design-critic skill reviews a website or UI for generic design and copy, then ranks concrete fixes. Use it after generating a frontend or when a page feels bland. CX Codex +1 184installs claude-landing-composer claude-landing-composer builds custom Next.js landing pages with Tailwind v4 and Motion animations. Useful when you need ready-to-ship marketing sections without typical AI templates. CX Codex +1 178installs claude-design-system-architect claude-design-system-architect is a Claude Code skill that turns a brand brief or existing site into reusable design tokens, component specs, and project files. It defines shared rules for a new product or inconsistent UI. CX Codex +1 172installs prospect-panel-simulator prospect-panel-simulator is a skill that simulates buyer reactions to sales and marketing materials before they go live, surfacing objections and likely next actions. CX Codex +1 164installs

Project sponsors

Companies that keep this analytics open