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/asset-customization.md

View on GitHub
# Asset Customization Guide

How to override user custom assets (backgrounds, sound effects, fonts, images) and best practices.

---

## Overview

Assets used for video generation are loaded in the following priority order:

```
1. User assets (~/.harness/video/assets/)      <- Highest priority
2. Skill defaults (skills/generate-video/assets/) <- Fallback
3. Built-in defaults (hardcoded)                <- Last resort
```

This mechanism allows you to use your own preferred assets without modifying the skill itself.

---

## Directory Structure

### User Asset Directory

```
~/.harness/video/assets/
+-- README.md                    # Usage guide (auto-generated)
+-- backgrounds/
|   +-- backgrounds.json         # Custom background definitions
|   +-- my-custom-bg.png         # Custom background image (optional)
+-- sounds/
|   +-- sounds.json              # Custom sound effect definitions
|   +-- impact.mp3               # High emphasis sound
|   +-- pop.mp3                  # Medium emphasis sound
|   +-- transition.mp3           # Scene transition sound
|   +-- subtle.mp3               # Low emphasis sound
+-- fonts/
|   +-- MyBrand-Bold.ttf
|   +-- MyBrand-Regular.ttf
+-- images/
    +-- logo.png
    +-- icon.png
```

### Initialization

Create the user asset directory:

```bash
node scripts/load-assets.js init
```

Or create it manually:

```bash
mkdir -p ~/.harness/video/assets/{backgrounds,sounds,fonts,images}
```

---

## Customization Methods

### 1. Background Customization

#### Steps

1. **Copy default settings**:

```bash
cp skills/generate-video/assets/backgrounds/backgrounds.json \
   ~/.harness/video/assets/backgrounds/
```

2. **Edit the settings**:

```json
{
  "version": "1.0.0",
  "backgrounds": [
    {
      "id": "my-brand",
      "name": "My Brand Background",
      "description": "Company brand colors",
      "type": "gradient",
      "colors": {
        "primary": "#1e3a8a",
        "secondary": "#3b82f6",
        "accent": "#60a5fa"
      },
      "gradient": {
        "type": "linear",
        "angle": 135,
        "stops": [
          { "color": "#1e3a8a", "position": 0 },
          { "color": "#3b82f6", "position": 50 },
          { "color": "#60a5fa", "position": 100 }
        ]
      },
      "usage": {
        "scenes": ["intro", "cta"],
        "recommended_for": "Brand-focused content"
      }
    }
  ]
}
```

3. **Use in video generation**:

```json
{
  "scene": {
    "background": "my-brand"
  }
}
```

#### Background Types

| Type | Description | Fields |
|------|-------------|--------|
| `gradient` | Gradient background | `colors`, `gradient` |
| `pattern` | Pattern background (grid, etc.) | `colors`, `gradient`, `pattern` |
| `solid` | Solid color background | `colors.primary` |
| `image` | Image background | `file` (path to image) |

#### Gradient Types

```json
// Linear gradient
"gradient": {
  "type": "linear",
  "angle": 135,
  "stops": [...]
}

// Radial gradient
"gradient": {
  "type": "radial",
  "stops": [...]
}
```

---

### 2. Sound Effect Customization

#### Steps

1. **Copy default settings**:

```bash
cp skills/generate-video/assets/sounds/sounds.json \
   ~/.harness/video/assets/sounds/
```

2. **Place sound effect files**:

```bash
# Download from FreeSound (CC0 license recommended)
cp ~/Downloads/my-impact.mp3 ~/.harness/video/assets/sounds/impact.mp3
cp ~/Downloads/my-pop.mp3 ~/.harness/video/assets/sounds/pop.mp3
```

3. **Edit the settings**:

```json
{
  "version": "1.0.0",
  "sounds": [
    {
      "id": "impact",
      "name": "Custom Impact",
      "type": "effect",
      "category": "emphasis",
      "emphasis_level": "high",
      "file": {
        "placeholder": "impact.mp3",
        "expected_duration": 0.5,
        "format": "mp3"
      },
      "volume": {
        "default": 0.7,
        "with_narration": 0.4,
        "with_bgm": 0.6
      }
    }
  ]
}
```

#### Recommended Formats

| Format | Sample Rate | Bit Depth | Notes |
|--------|-------------|-----------|-------|
| MP3 | 44100 Hz | 16-bit | Recommended (high compatibility) |
| WAV | 44100 Hz | 16-bit | High quality (large file size) |
| OGG | 44100 Hz | - | Lightweight (check browser compatibility) |

#### Recommended Volume Levels

| Context | Volume Range | Notes |
|---------|--------------|-------|
| With narration | 0.15 - 0.4 | Avoid interfering with voice |
| With BGM | 0.25 - 0.6 | Duck the BGM |
| No audio | 0.3 - 1.0 | Full volume OK |

---

### 3. Font Customization

#### Steps

1. **Place font files**:

```bash
cp ~/Downloads/MyFont-Bold.ttf ~/.harness/video/assets/fonts/
cp ~/Downloads/MyFont-Regular.ttf ~/.harness/video/assets/fonts/
```

2. **Reference in scene settings**:

```json
{
  "scene": {
    "text": {
      "content": "My Message",
      "font": {
        "family": "MyFont",
        "weight": "bold",
        "file": "~/.harness/video/assets/fonts/MyFont-Bold.ttf"
      }
    }
  }
}
```

#### Usage in Remotion

```typescript
import { loadFont } from '@remotion/google-fonts/Inter';

// Load custom font
const fontFamily = loadFont({
  src: '~/.harness/video/assets/fonts/MyFont-Bold.ttf',
  fontFamily: 'MyFont',
  fontWeight: 'bold',
});
```

#### Recommended Formats

| Format | Web Safe | Notes |
|--------|----------|-------|
| TTF | โœ… Yes | Recommended (highest compatibility) |
| OTF | โœ… Yes | OpenType features available |
| WOFF/WOFF2 | โœ… Yes | Web-optimized (lightweight) |

---

### 4. Image Customization

#### Steps

1. **Place image files**:

```bash
cp ~/Downloads/logo.png ~/.harness/video/assets/images/
cp ~/Downloads/icon.png ~/.harness/video/assets/images/
```

2. **Reference in scene settings**:

```json
{
  "scene": {
    "image": {
      "src": "~/.harness/video/assets/images/logo.png",
      "width": 200,
      "height": 100
    }
  }
}
```

#### Recommended Formats

| Format | Use Case | Notes |
|--------|----------|-------|
| PNG | Logos, icons | Supports transparency |
| JPG | Photos, backgrounds | High compression ratio |
| SVG | Vector graphics | Scales without quality loss |
| WebP | Modern environments | Lightweight, high quality |

#### Size Guidelines

| Asset Type | Recommended Size | Max Size |
|------------|------------------|----------|
| Logo | 500x500 px | 1000x1000 px |
| Icon | 128x128 px | 512x512 px |
| Background | 1920x1080 px | 3840x2160 px |
| Screenshot | 1920x1080 px | 2560x1440 px |

---

## Priority Details

### Loading Order

`scripts/load-assets.js` searches for assets in the following order:

```javascript
// 1. User assets
const userPath = '~/.harness/video/assets/{category}/{file}';
if (exists(userPath)) return userPath;

// 2. Skill defaults
const skillPath = 'skills/generate-video/assets/{category}/{file}';
if (exists(skillPath)) return skillPath;

// 3. Built-in defaults
return getBuiltInDefault();
```

### Partial Overrides

You can override only specific assets:

```bash
# Customize only backgrounds (sound effects use defaults)
cp my-backgrounds.json ~/.harness/video/assets/backgrounds/backgrounds.json
```

### Partial Overrides Within JSON

```json
// ~/.harness/video/assets/backgrounds/backgrounds.json
{
  "version": "1.0.0",
  "backgrounds": [
    {
      "id": "my-brand",
      "name": "My Brand"
      // ... custom settings
    }
    // "neutral", "highlight", etc. are omitted -> loaded from defaults
  ]
}
```

**Note**: When the same `id` exists, the user setting takes precedence.

---

## Verification

### Test Commands

```bash
# Asset loading test
node scripts/load-assets.js test

# Show background settings
node scripts/load-assets.js backgrounds

# Show sound effect settings
node scripts/load-assets.js sounds

# Show search paths
node scripts/load-assets.js paths
```

### Expected Output

```
๐Ÿงช Testing asset loader...

๐ŸŽจ Loading backgrounds...
  โœ… Loaded user backgrounds from: ~/.harness/video/assets/backgrounds/backgrounds.json

๐Ÿ”Š Loading sounds...
  โœ… Loaded skill sounds from: skills/generate-video/assets/sounds/sounds.json

๐Ÿ“‚ Asset paths:
{
  "user": "~/.harness/video/assets",
  "skill": "skills/generate-video/assets"
}
```

---

## Troubleshooting

### Issue: Assets not loading

**Cause**: Incorrect file path

**Solution**:
```bash
# Check paths
node scripts/load-assets.js paths

# Verify file existence
ls -la ~/.harness/video/assets/backgrounds/
```

### Issue: JSON parse error

**Cause**: Invalid JSON format

**Solution**:
```bash
# Validate JSON
cat ~/.harness/video/assets/backgrounds/backgrounds.json | jq .

# Check error messages
node scripts/load-assets.js test
```

### Issue: Sound effects not playing

**Cause**: Unsupported file format

**Solution**:
```bash
# Convert to MP3
ffmpeg -i input.wav -codec:a libmp3lame -b:a 192k output.mp3

# Check file info
ffprobe output.mp3
```

### Issue: Fonts not displaying

**Cause**: Font file path cannot be resolved

**Solution**:
```typescript
// Use absolute paths
const fontPath = path.join(os.homedir(), '.harness/video/assets/fonts/MyFont.ttf');
```

---

## Best Practices

### 1. Version Control

If you want to manage custom assets with Git:

```bash
# Place in project root
project-root/
+-- .video-assets/
|   +-- backgrounds/
|   +-- sounds/
|   +-- fonts/
+-- .gitignore  # Exclude .harness/

# Create symlink
ln -s $(pwd)/.video-assets ~/.harness/video/assets
```

### 2. Team Sharing

Use common assets across a team:

```bash
# Shared repository
git clone https://github.com/company/video-assets.git ~/.harness/video/assets
```

### 3. Per-Project Assets

Different assets per project:

```bash
# Switch via environment variable
export VIDEO_ASSETS_DIR=/path/to/project-specific/assets

# Reference environment variable in load-assets.js
const assetsDir = process.env.VIDEO_ASSETS_DIR || defaultPath;
```

### 4. License Management

```
~/.harness/video/assets/
+-- LICENSES.md    # License information for each asset
```

```markdown
# Asset Licenses

## Sounds

- impact.mp3: CC0, from freesound.org/s/12345
- pop.mp3: CC BY 3.0, by Author Name

## Fonts

- MyFont-Bold.ttf: SIL Open Font License
```

---

## Examples

### Brand Color Background

```json
{
  "id": "brand-primary",
  "name": "Brand Primary",
  "type": "gradient",
  "colors": {
    "primary": "#your-brand-color",
    "secondary": "#your-secondary-color"
  },
  "gradient": {
    "type": "linear",
    "angle": 135,
    "stops": [
      { "color": "#your-brand-color", "position": 0 },
      { "color": "#your-secondary-color", "position": 100 }
    ]
  },
  "usage": {
    "scenes": ["intro", "outro", "cta"]
  }
}
```

### Custom Sound Effect Set

```json
{
  "id": "whoosh",
  "name": "Whoosh Transition",
  "type": "effect",
  "category": "transition",
  "file": {
    "placeholder": "whoosh.mp3",
    "expected_duration": 0.6
  },
  "volume": {
    "default": 0.5,
    "with_narration": 0.3
  },
  "timing": {
    "offset_before_visual": -0.1
  }
}
```

### Company Logo

```json
{
  "scene": {
    "image": {
      "src": "~/.harness/video/assets/images/company-logo.png",
      "width": 300,
      "height": 150,
      "position": "top-right"
    }
  }
}
```

---

## References

- **Asset Loader**: `scripts/load-assets.js`
- **Default Backgrounds**: `assets/backgrounds/backgrounds.json`
- **Default Sounds**: `assets/sounds/sounds.json`
- **BackgroundLayer Component**: `remotion/src/components/BackgroundLayer.tsx`
- **Plans.md**: Phase 7 - Asset Foundation

---

## Changelog

- **2026-02-02**: Initial version created (Phase 7 implementation)
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