Skip to content

tim-hub/powerball-harness / .claude/skills/generate-video

generate-video

Verified

Generates product demo videos and release walkthroughs via Remotion. Use when creating video documentation or animated demos.

FileKindSize
SKILL.mdskill md6.6 KB
assets/backgrounds/backgrounds.jsonconfig4.9 KB
assets/sounds/sounds.jsonconfig5.7 KB
package.jsonmanifest710 B
references/MIGRATION-11.2.mdmarkdown7.9 KB
references/analyzer.mdmarkdown4.5 KB
references/asset-customization.mdmarkdown11.2 KB
references/best-practices.mdmarkdown8.6 KB
references/direction-guide.mdmarkdown14.6 KB
references/generator.mdmarkdown25.9 KB
references/image-generator.mdmarkdown9.0 KB
references/image-patterns.mdmarkdown14.5 KB
references/image-quality-check.mdmarkdown6.9 KB
references/naming-conventions.mdmarkdown6.0 KB
references/planner.mdmarkdown7.6 KB
references/visual-effects.mdmarkdown11.0 KB
remotion/components/BackgroundLayer.tsxother7.5 KB
remotion/components/EmphasisBox.tsxother5.9 KB
remotion/components/ProgressIndicator.tsxother6.8 KB
remotion/components/README.mdmarkdown8.5 KB
remotion/components/TransitionWrapper.tsxother5.7 KB
remotion/components/index.tsscript1004 B
remotion/tsconfig.jsonconfig617 B
schemas/README.mdmarkdown8.1 KB
schemas/animation.schema.jsonconfig5.2 KB
schemas/assets.manifest.schema.jsonconfig5.9 KB
schemas/character.schema.jsonconfig16.0 KB
schemas/direction.schema.jsonconfig4.5 KB
schemas/emphasis.schema.jsonconfig8.6 KB
schemas/examples/scenario-example.jsonconfig1.6 KB
schemas/examples/scene-example.jsonconfig1.6 KB
schemas/examples/video-script-example.jsonconfig5.1 KB
schemas/examples/visual-patterns/comparison-example.jsonconfig1.0 KB
schemas/examples/visual-patterns/concept-example.jsonconfig2.1 KB
schemas/examples/visual-patterns/flow-example.jsonconfig1.8 KB
schemas/examples/visual-patterns/highlight-example.jsonconfig745 B
schemas/scenario.schema.jsonconfig3.6 KB
schemas/scene.schema.jsonconfig8.2 KB
schemas/validate-schemas-basic.jsscript2.7 KB
schemas/validate-schemas.jsscript6.6 KB
schemas/video-script.schema.jsonconfig7.6 KB
schemas/visual-patterns.schema.jsonconfig14.2 KB
scripts/README.mdmarkdown7.4 KB
scripts/generate-schemas.jsexecutablescript6.2 KB
scripts/load-assets.jsexecutablescript14.1 KB
scripts/merge-scenes.jsexecutablescript15.0 KB
scripts/render-video.jsexecutablescript14.0 KB
scripts/template-registry.jsexecutablescript10.0 KB
scripts/validate-scenario.jsexecutablescript8.0 KB
scripts/validate-scene.jsexecutablescript4.3 KB
scripts/validate-video.jsexecutablescript13.0 KB
src/schemas/animation.tsscript3.7 KB
src/schemas/assets.manifest.tsscript2.8 KB
src/schemas/character.tsscript6.5 KB
src/schemas/direction.tsscript3.2 KB
src/schemas/emphasis.tsscript5.2 KB
src/schemas/index.tsscript423 B
src/schemas/scenario.tsscript2.7 KB
src/schemas/scene.tsscript5.5 KB
src/schemas/video-script.tsscript9.4 KB
src/schemas/visual-patterns.tsscript8.2 KB
src/types/README.mdmarkdown4.1 KB
src/types/components.tsscript6.0 KB
src/types/index.tsscript108 B
src/utils/README.mdmarkdown6.1 KB
src/utils/converters.jsscript5.9 KB
src/utils/converters.tsscript5.7 KB
src/utils/index.tsscript109 B
templates/image-prompts/comparison.txtmarkdown1.3 KB
templates/image-prompts/concept.txtmarkdown2.3 KB
templates/image-prompts/flow.txtmarkdown2.8 KB
templates/image-prompts/highlight.txtmarkdown3.2 KB
templates/intro-3min.jsonconfig8.9 KB
templates/teaser-90s.jsonconfig7.0 KB
tests/asset-loader.test.jsscript12.1 KB
tests/character-schema.test.jsscript7.9 KB
tests/converters.test.jsscript8.3 KB
tests/determinism.test.jsscript11.4 KB
tests/e2e/merge-e2e.test.jsscript13.3 KB
tests/e2e/render.test.jsscript6.1 KB
tests/fixtures/minimal-video-script.jsonconfig1.2 KB
tests/merge-scenes.test.jsscript17.2 KB
tests/schema-validation.test.jsscript3.7 KB
tests/validation-integration.test.jsscript12.9 KB
tests/visual-patterns.test.jsscript12.1 KB

references/direction-guide.md

View on GitHub
# Direction Guide

Defines the usage and best practices for the visual direction system in the generate-video skill.

---

## Overview

The direction system consists of the following 4 elements:

| Element | Role | Control |
|---------|------|---------|
| **transition** | Scene transitions | Fade, slide, zoom, cut |
| **emphasis** | Element highlighting | 3 levels of emphasis + sound effects |
| **background** | Background design | 5 background styles |
| **timing** | Timing adjustment | Wait times, audio offsets |

---

## Transition

### 4 Transition Types

| Type | Use Case | Visual Effect | Recommended Duration |
|------|----------|---------------|---------------------|
| **fade** | General-purpose transition | Smooth fade in/out | 500ms (15f) |
| **slideIn** | Moving to next topic | Directional slide (left/right/top/bottom) | 400ms (12f) |
| **zoom** | Drawing attention to detail | Zoom in/out | 600ms (18f) |
| **cut** | Instant transition | Cut (instantaneous) | 0ms |

### Usage Guidelines

#### fade
- **Recommended scenes**: General purpose, section start, calm transitions
- **Effect**: Visually gentle, doesn't draw too much attention
- **Examples**:
  - Intro → main explanation
  - Feature explanation → next feature explanation
  - Calm transition before CTA

```json
{
  "transition": {
    "type": "fade",
    "duration_ms": 500,
    "easing": "easeInOut"
  }
}
```

#### slideIn
- **Recommended scenes**: Topic change, comparison display, step progression
- **Effect**: Dynamic, creates anticipation for next content
- **direction**:
  - `right`: Sense of forward progress (next step)
  - `left`: Past reference (the "Before" in Before/After)
  - `top`: Important information appearing
  - `bottom`: Supplementary information added

```json
{
  "transition": {
    "type": "slideIn",
    "duration_ms": 400,
    "direction": "right",
    "easing": "easeOut"
  }
}
```

#### zoom
- **Recommended scenes**: Detail display, emphasis, impactful information
- **Effect**: Attention-drawing, impact
- **Examples**:
  - Displaying important numbers
  - Presenting core issues
  - Emphasizing differentiation points

```json
{
  "transition": {
    "type": "zoom",
    "duration_ms": 600,
    "easing": "easeInOut"
  }
}
```

#### cut
- **Recommended scenes**: Demo operations, fast-paced content, tension
- **Effect**: Instantaneous, speeds up tempo
- **Examples**:
  - Between UI operation steps
  - Fast demonstrations
  - Rhythmic feature introductions

```json
{
  "transition": {
    "type": "cut",
    "duration_ms": 0
  }
}
```

### Recommended Transitions by Funnel Stage

| Funnel Stage | Recommended Transitions | Reason |
|-------------|------------------------|--------|
| Awareness (LP/Ads) | fade, zoom | Calm, impact |
| Interest (Intro) | slideIn, fade | Dynamic, anticipation |
| Consideration (Feature Demo) | cut, slideIn | Tempo, efficiency |
| Conviction (Architecture) | fade, zoom | Detail, trust |
| Retention (Onboarding) | slideIn, cut | Step progression |

---

## Emphasis

### 3 Emphasis Levels

| Level | Use Case | Visual Effect | Recommended Sound |
|-------|----------|---------------|-------------------|
| **high** | Most important message | Large animation, bright color | whoosh, chime |
| **medium** | Important points | Medium animation, accent color | pop |
| **low** | Supplementary info | Subtle emphasis, light color | none, ding |

### Usage Guidelines

#### high (High Emphasis)
- **Recommended scenes**:
  - Hook (initial impact)
  - CTA (call to action)
  - Differentiator
  - Surprising results/numbers

- **Visual effects**:
  - Text size: extra large
  - Color: vivid (default: `#00F5FF` cyan)
  - Animation: scale 1.2, bounce
  - Sound: `whoosh` or `chime`

- **Examples**:
  - "3x faster" → high emphasis
  - "Try it free now" → high emphasis

```json
{
  "emphasis": {
    "level": "high",
    "text": ["3x faster"],
    "sound": "whoosh",
    "color": "#00F5FF",
    "position": "center"
  }
}
```

#### medium (Medium Emphasis)
- **Recommended scenes**:
  - Key points of feature explanation
  - Workflow steps
  - Problem presentation
  - Solution

- **Visual effects**:
  - Text size: large
  - Color: accent (default: `#FFC700` gold)
  - Animation: scale 1.1, fade-in
  - Sound: `pop`

- **Examples**:
  - "Step 1: Setup" → medium emphasis
  - "Having this problem?" → medium emphasis

```json
{
  "emphasis": {
    "level": "medium",
    "text": ["Step 1: Setup"],
    "sound": "pop",
    "color": "#FFC700",
    "position": "top"
  }
}
```

#### low (Low Emphasis)
- **Recommended scenes**:
  - Supplementary information
  - Light introduction of additional features
  - Annotations
  - Links to detailed information

- **Visual effects**:
  - Text size: normal
  - Color: light (default: `#A8DADC` light blue)
  - Animation: fade-in only
  - Sound: `none` or `ding`

- **Examples**:
  - "*See documentation for details" → low emphasis
  - "Many more features" → low emphasis

```json
{
  "emphasis": {
    "level": "low",
    "text": ["*See documentation for details"],
    "sound": "none",
    "color": "#A8DADC",
    "position": "bottom"
  }
}
```

### Choosing Sound Effects

| Sound | Characteristics | Recommended Use |
|-------|----------------|-----------------|
| **whoosh** | Wind sound, dynamic | high emphasis, screen transitions |
| **chime** | Chime, beautiful tone | CTA, success display |
| **pop** | Pop, light and lively | medium emphasis, button display |
| **ding** | Small bell sound | low emphasis, light notification |
| **none** | Silent | Quiet information, continuous display |

### Recommended Emphasis Levels by Funnel Stage

| Funnel Stage | Primary Emphasis | Secondary Emphasis |
|-------------|-----------------|-------------------|
| Awareness (LP/Ads) | high (frequent) | medium (moderate) |
| Interest (Intro) | high (1-2 times) | medium (frequent) |
| Consideration (Feature Demo) | medium (primary) | low (supplementary) |
| Conviction (Architecture) | medium (moderate) | low (frequent) |
| Retention (Onboarding) | high (goals) | medium (steps) |

---

## Background

### 5 Background Styles

| Type | Visual Characteristics | Use Case | Color Examples |
|------|----------------------|----------|----------------|
| **cyberpunk** | Neon, grid, futuristic | Tech, cutting-edge appeal | `#0a0e27` + `#00f5ff` |
| **corporate** | Refined, trustworthy, professional | B2B, enterprise | `#1a1a2e` + `#16213e` |
| **minimal** | Simple, clean, focused | Explanation-focused, documentation | `#ffffff` + `#f0f0f0` |
| **gradient** | Colorful, dynamic, approachable | B2C, casual | `#667eea` → `#764ba2` |
| **particles** | Dynamic particles, energetic | Hook, CTA, impact | `#000000` + particles |

### Usage Guidelines

#### cyberpunk
- **Recommended scenes**:
  - Demonstrating technological advancement
  - Developer tools
  - AI/ML feature introduction
  - Architecture diagrams

- **Characteristics**:
  - Neon grid
  - Glitch effects
  - Blue/cyan color scheme

```json
{
  "background": {
    "type": "cyberpunk",
    "primaryColor": "#0a0e27",
    "secondaryColor": "#00f5ff",
    "opacity": 0.9
  }
}
```

#### corporate
- **Recommended scenes**:
  - B2B products
  - Enterprise features
  - Security/reliability appeal
  - Case studies/results

- **Characteristics**:
  - Dark blue tones
  - Clean gradients
  - Calm atmosphere

```json
{
  "background": {
    "type": "corporate",
    "primaryColor": "#1a1a2e",
    "secondaryColor": "#16213e",
    "opacity": 1
  }
}
```

#### minimal
- **Recommended scenes**:
  - Focusing on content
  - Complex diagrams/code display
  - Onboarding
  - Documentation-style explanations

- **Characteristics**:
  - White/gray tones
  - Simple
  - Visibility-focused

```json
{
  "background": {
    "type": "minimal",
    "primaryColor": "#ffffff",
    "secondaryColor": "#f0f0f0",
    "opacity": 1
  }
}
```

#### gradient
- **Recommended scenes**:
  - B2C products
  - Approachability appeal
  - Intro/CTA
  - Casual tone

- **Characteristics**:
  - Colorful gradients
  - Soft impression
  - Visually enjoyable

```json
{
  "background": {
    "type": "gradient",
    "primaryColor": "#667eea",
    "secondaryColor": "#764ba2",
    "opacity": 0.95
  }
}
```

#### particles
- **Recommended scenes**:
  - Hook (opening impact)
  - CTA (call to action)
  - Important turning points
  - Energetic impression

- **Characteristics**:
  - Dynamic particles
  - Sense of energy
  - Attention-drawing

```json
{
  "background": {
    "type": "particles",
    "primaryColor": "#000000",
    "secondaryColor": "#00f5ff",
    "opacity": 0.8
  }
}
```

### Recommended Backgrounds by Funnel Stage

| Funnel Stage | Recommended Background | Reason |
|-------------|----------------------|--------|
| Awareness (LP/Ads) | particles, gradient | Visual impact |
| Interest (Intro) | gradient, cyberpunk | Approachability, cutting-edge |
| Consideration (Feature Demo) | minimal, corporate | Focus, trust |
| Conviction (Architecture) | corporate, cyberpunk | Professional |
| Retention (Onboarding) | minimal, gradient | Simple, friendly |

---

## Timing

### Timing Parameters

| Parameter | Use Case | Recommended Value |
|-----------|----------|-------------------|
| **delay_before** | Wait before scene start | 0-15f (0-500ms) |
| **delay_after** | Wait after scene end | 0-30f (0-1000ms) |
| **audio_start_offset** | Audio start offset | 30f (1000ms, standard) |

### Usage Guidelines

#### delay_before (Pre-start Wait)
- **Use cases**:
  - Visual settling after transition
  - Lingering from previous scene
  - Pause to draw attention

- **Recommended values**:
  - `0f`: When transition is sufficient
  - `5-10f`: Light pause
  - `15f`: Firm pause

```json
{
  "timing": {
    "delay_before": 10
  }
}
```

#### delay_after (Post-end Wait)
- **Use cases**:
  - Lingering after audio ends
  - Ensuring CTA display time
  - Ensuring reading time

- **Recommended values**:
  - `0f`: Move to next immediately
  - `15-20f`: Standard lingering
  - `30f`: Ensure thorough reading

```json
{
  "timing": {
    "delay_after": 20
  }
}
```

#### audio_start_offset (Audio Start Offset)
- **Use cases**:
  - Wait after scene display before audio starts
  - Audio starts after visual settling

- **Recommended values**:
  - `30f` (1000ms): Standard (recommended)
  - `15f` (500ms): Fast-paced
  - `45f` (1500ms): Relaxed

```json
{
  "timing": {
    "audio_start_offset": 30
  }
}
```

### Important Audio Sync Rules

> **Important**: Strictly follow these rules for narrated videos

1. **Scene length formula**:
   ```
   duration_ms = audio_start_offset + audio_length + delay_after
   ```

2. **Pre-check audio length**:
   ```bash
   ffprobe -v error -show_entries format=duration \
     -of default=noprint_wrappers=1:nokey=1 audio/scene.wav
   ```

3. **Coordination with transitions**:
   ```
   Scene start = Previous scene start + Previous scene length - Transition length
   Audio start = Scene start + audio_start_offset
   ```

4. **Ensure margins**:
   - Audio must finish before transition starts
   - Ensure at least `delay_after: 20f`

---

## Best Practices

### 1. Direction Combinations by Funnel Stage

#### 90-Second LP/Ad Teaser (Awareness to Interest)
```json
{
  "hook": {
    "transition": { "type": "zoom", "duration_ms": 600 },
    "emphasis": { "level": "high", "sound": "whoosh" },
    "background": { "type": "particles" },
    "timing": { "delay_before": 10, "delay_after": 20 }
  },
  "problem": {
    "transition": { "type": "slideIn", "direction": "right", "duration_ms": 400 },
    "emphasis": { "level": "medium", "sound": "pop" },
    "background": { "type": "gradient" },
    "timing": { "delay_before": 0, "delay_after": 15 }
  },
  "cta": {
    "transition": { "type": "zoom", "duration_ms": 600 },
    "emphasis": { "level": "high", "sound": "chime" },
    "background": { "type": "particles" },
    "timing": { "delay_before": 15, "delay_after": 30 }
  }
}
```

#### 3-Minute Intro Demo (Interest → Consideration)
```json
{
  "intro": {
    "transition": { "type": "fade", "duration_ms": 500 },
    "emphasis": { "level": "high", "sound": "whoosh" },
    "background": { "type": "gradient" },
    "timing": { "delay_before": 0, "delay_after": 20 }
  },
  "demo": {
    "transition": { "type": "cut", "duration_ms": 0 },
    "emphasis": { "level": "medium", "sound": "pop" },
    "background": { "type": "minimal" },
    "timing": { "delay_before": 0, "delay_after": 10 }
  },
  "cta": {
    "transition": { "type": "fade", "duration_ms": 500 },
    "emphasis": { "level": "high", "sound": "chime" },
    "background": { "type": "gradient" },
    "timing": { "delay_before": 10, "delay_after": 30 }
  }
}
```

### 2. Appropriate Sound Effect Usage

**Rules**:
- Maximum **5-7 sound effects** per video
- Reduce sound effects in consecutive scenes (diminishing returns from habituation)
- Always attach sound effects to high emphasis
- Medium emphasis is selective
- Low emphasis is basically silent

### 3. Background Consistency

**Rules**:
- Maximum **2-3 background types** per video
- Unify within sections (same background within a section)
- Only Hook/CTA may use special backgrounds (particles)

### 4. Transition Rhythm

**Rules**:
- Don't use the same transition more than 3 times consecutively
- Combine fast transitions (cut) with varied pacing (fade/zoom)
- Recommend fade or zoom at section start

### 5. Emphasis Level Distribution

**Rules (for 90-second video)**:
- high: 2-3 times (Hook, Differentiator, CTA)
- medium: 5-8 times (key messages)
- low: as needed (supplementary information)

---

## Design Checklist

Verify the following when designing scene direction:

### Transition
- [ ] Selected transition appropriate for scene purpose
- [ ] Avoided consecutive use of same transition
- [ ] duration_ms is appropriate (fade: 500ms, slideIn: 400ms, zoom: 600ms)

### Emphasis
- [ ] Emphasis level is appropriate (high: most important only)
- [ ] Sound effect usage count is appropriate (5-7 total)
- [ ] Keywords to emphasize specified in text array

### Background
- [ ] Background type matches funnel stage
- [ ] Background unified within section
- [ ] primaryColor and secondaryColor specified

### Timing
- [ ] audio_start_offset is 30f (standard)
- [ ] Scene length = audio_start + audio length + delay_after
- [ ] Audio finishes before transition starts

### Overall Balance
- [ ] Sound effects used 5-7 times or less
- [ ] Background types limited to 2-3
- [ ] high emphasis limited to 2-3 times

---

## Related Documents

- [generator.md](./generator.md) - Parallel generation flow
- [visual-effects.md](./visual-effects.md) - Visual effects library
- [schemas/direction.schema.json](../schemas/direction.schema.json) - Direction schema definition
- [schemas/emphasis.schema.json](../schemas/emphasis.schema.json) - Emphasis schema definition
- [schemas/animation.schema.json](../schemas/animation.schema.json) - Animation schema definition
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall