/iblai-marketing-video

Produce marketing video — product demos, explainers, social clips, ads — using AI generation models, AI avatars, and programmatic frameworks.

Step 0: Context Check

Read .agents/product-marketing-context.md (or .claude/product-marketing-context.md on older setups) first. Only ask for what isn't there.

Pull this context:

1. Video Goal

• Video type (product demo, explainer, testimonial, social clip, ad, tutorial)
• Target platform (YouTube, TikTok/Reels/Shorts, website, ads, sales deck)
• Desired length

2. Production Approach

• Need a human presenter? (AI avatar vs. voiceover vs. screen recording)
• Existing footage or assets? (Screenshots, logos, product UI)
• Need generated footage? (AI-generated scenes, B-roll)
• One-off or repeatable template?

3. Technical Context

• Tech stack (Node.js, Python, etc.)
• API keys for any video tools?
• Budget constraints (some tools charge per minute)

Choosing Your Approach

Programmatic Video

Build videos with code. Best for repeatable, templated, or data-driven video at scale.

Hyperframes (HTML/CSS — recommended for agents)

Open-source, Apache 2.0, from HeyGen. Plain HTML/CSS/JS — no framework DSL. LLM-native: AI models generate better HTML than React components.

npm install hyperframes

Key concept: each frame is an HTML document. Compose frames into a timeline, render to MP4.

import { render } from "hyperframes";

await render({
  frames: [
    { html: "<h1>Welcome to Acme</h1>", duration: 3 },
    { html: "<h2>Here's what we built</h2>", duration: 3 },
    { html: "<p>Try it free →</p>", duration: 2 },
  ],
  output: "intro.mp4",
  width: 1080,
  height: 1920, // 9:16 for vertical
});

Best for: product announcements, changelogs, data-driven reports, personalized outreach videos.

Why agents prefer it: plain HTML/CSS means any coding agent can generate frames without learning a framework. Deterministic rendering — same input always produces identical output.

Remotion (React)

Mature open-source framework. More powerful than Hyperframes but requires React knowledge.

npx create-video@latest

Key concept: React components are frames. Props drive content. Render locally or via Remotion Lambda (AWS) for scale.

export const ProductDemo: React.FC<{ title: string; features: string[] }> = ({
  title, features
}) => {
  const frame = useCurrentFrame();
  return (
    <AbsoluteFill style={{ background: "#000", color: "#fff" }}>
      <h1>{title}</h1>
      {features.map((f, i) => (
        <Sequence from={i * 30} key={i}>
          <p>{f}</p>
        </Sequence>
      ))}
    </AbsoluteFill>
  );
};

Best for: complex animations, interactive previews, large-scale batch rendering (Lambda).

When to Pick Which

AI Video Generation

Generate original footage from text or image prompts. Use for B-roll, hero visuals, and scenes you can't practically film.

Model Comparison

Sora (OpenAI) has had limited availability and reliability issues. Check current status before recommending.

Prompting for Video Models

Good video prompts specify: subject + action + camera + style + mood

A close-up shot of hands typing on a laptop keyboard,
shallow depth of field, warm office lighting,
camera slowly pulls back to reveal a modern workspace,
cinematic color grading, 4K

Common mistakes:

• Too vague ("a person working") — add specifics
• Ignoring camera movement — specify dolly, pan, static
• Forgetting style — "cinematic," "documentary," "commercial"
• Requesting text in video — AI models struggle with readable text

Detailed prompting guides: [references/ai-video-prompting.md](references/ai-video-prompting.md).

When to Use AI Generation vs. Stock

AI Avatars

Create talking-head videos without filming. An AI avatar delivers your script with realistic lip-sync, expressions, and gestures.

HeyGen (recommended — has MCP server)

Best lip-sync and micro-expressions. 230+ avatars, 140+ languages.

Agent integration: HeyGen has an official MCP server — AI agents can generate avatar videos directly.

Current pricing: heygen.com/pricing.

Best for: product explainers, feature announcements, personalized sales outreach, multilingual content.

Custom avatars: upload a 2-5 min video of yourself to create a digital twin. Looks and sounds like you, generates videos from text scripts.

Synthesia

Full-body avatars with expressive body language. Built-in script generation from URLs/docs.

Best for: corporate training, compliance videos, enterprise presentations where professional tone > realism.

When to Use Avatars vs. Other Approaches

Editing & Repurposing Tools

Turn existing content into multiple video formats.

Repurposing Workflow

Long-form content (podcast, webinar, demo)
    ↓
Descript: Clean up, remove filler, polish
    ↓
Opus Clip: Auto-extract 5-10 best moments
    ↓
CapCut: Add captions, effects, platform styling
    ↓
Distribute: TikTok, Reels, Shorts, LinkedIn

Video Production Workflows

Product Demo Video

1. Script the key features and value props (use /iblai-marketing-copywriting)
2. Screen record the product flow
3. Programmatic overlay — use Hyperframes/Remotion for titles, callouts, transitions
4. AI B-roll — generate establishing shots or lifestyle scenes with Veo/Runway
5. Voiceover — record yourself or use an AI avatar for narration
6. Export at platform-appropriate specs

Explainer Video

1. Script the problem → solution → CTA arc
2. Choose presenter — AI avatar (HeyGen) or voiceover + visuals
3. Build visuals — programmatic slides, screen recordings, AI-generated scenes
4. Add captions — always, for accessibility and engagement
5. Export — landscape for YouTube/website, vertical for social

Batch Social Clips

1. Create master template in Hyperframes/Remotion
2. Feed data — product features, testimonials, stats
3. Render batch — one template, many variations
4. Add platform-specific captions via CapCut or Captions.ai
5. Schedule across platforms

Agent-Native Video Pipeline

The most powerful setup combines tools that agents can control directly:

Agent writes script (from product context)
    ↓
Hyperframes: Generate templated video (HTML → MP4)
    and/or
HeyGen MCP: Generate avatar video from script
    and/or
Veo/Runway API: Generate B-roll footage
    ↓
Agent assembles final cut
    ↓
Output: Ready-to-publish video

Why this is agent-native:

• Hyperframes uses HTML — any coding agent can generate it
• HeyGen MCP server — agents call it directly
• Video model APIs — standard HTTP requests
• No manual editing step required

Common Mistakes

1. Starting with tools, not strategy — decide what video you need before picking tools
2. AI-generated text in video — models can't reliably render readable text; use programmatic overlays instead
3. Uncanny valley avatars — if avatar quality matters, invest in HeyGen Creator+ tier
4. No captions — 85% of social video is watched without sound
5. Wrong aspect ratio — 9:16 for social, 16:9 for YouTube/website, 1:1 for feeds
6. Over-producing — authentic often outperforms polished, especially on TikTok

Task-Specific Questions

1. Video type? (Demo, explainer, social clip, ad, tutorial.)
2. Human presenter or voiceover/text?
3. One-off or repeatable template?
4. Target platform? (Determines aspect ratio and length.)
5. Existing assets to work with? (Screenshots, footage, scripts.)
6. Budget for video tools?

Tool Integrations

Related Skills

• iblai-marketing-social-content: Video content strategy, hooks, what to post
• iblai-marketing-ad-creative: Paid video ad creative and iteration
• iblai-marketing-copywriting: Video scripts and messaging
• iblai-marketing-psychology: Hooks and persuasion in video