# ai-video-gen

ai-video-gen turns a written prompt into a video clip through HeyGen, fal.ai, Kling or Gemini, choosing a gateway for the job.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 78316 repo stars
- Author: calesthio
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/ai-video-gen/SKILL.md
- Updated: 2026-11-10
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/calesthio-ai-video-gen

## What it does

The skill takes a shot description and routes it to one of four gateways: HeyGen, fal.ai, the official Kling API or Gemini. What comes back is a link to the rendered clip. Each gateway has its own tools, among them `heygen_video`, `seedance_video`, `kling_official_video` and `gemini_omni_video`, plus calls for VEO, MiniMax and Runway models.

Provider tools are not called directly. `video_selector` runs first: it checks which gateways have credentials, weighs cost and falls back to another provider when the chosen one is unavailable. Refining an existing take is a separate path — only Gemini Omni Flash keeps state across turns, so adding an object or changing the lighting does not mean re-rendering the whole scene.

One key is the floor: `HEYGEN_API_KEY`, `FAL_KEY`, `KLING_API_KEY`, `GEMINI_API_KEY` or `GOOGLE_API_KEY`. They do not cross over. `FAL_KEY` will not drive `kling_official_video`, because that path wants `KLING_API_KEY` and handles image upload its own way. The repo ships under AGPL-3.0.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill ai-video-gen -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ai-video-gen/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ai-video-gen/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill ai-video-gen -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ai-video-gen/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill ai-video-gen -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ai-video-gen/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install calesthio/OpenMontage .agents/skills/ai-video-gen
```

2. **Manually: put the files in place**
- File: `.github/skills/ai-video-gen/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add calesthio/OpenMontage --skill ai-video-gen -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/calesthio/OpenMontage --path .agents/skills/ai-video-gen
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ai-video-gen/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/calesthio/OpenMontage/tree/HEAD/.agents/skills/ai-video-gen/SKILL.md

## When to use it
- turn a written brief into a finished ad clip
- animate a still reference image
- fix one detail in an existing take without re-rendering it
- compare provider cost for a single prompt
- match a gateway to the API key you already have

## Example prompts
- Generate a 10-second clip: a drone over a coastal city at sunset, 16:9.
- Use `shot_03.png` as the reference image and turn it into video.
- In this clip, remove the car on the left and relight it for evening.

## Similar
- [capy-video-gen-skill](https://affpapa.org/en/nevibecode/skills/capy-video-gen-skill.md) — skill · ★ 138 repo stars
- [video](https://affpapa.org/en/nevibecode/skills/video.md) — skill · 98700 installs
- [video-generation](https://affpapa.org/en/nevibecode/skills/video-generation.md) — skill · 3000 installs
- [kling-video](https://affpapa.org/en/nevibecode/skills/kling-video.md) — skill · 240 installs
- [ai-video-generation](https://affpapa.org/en/nevibecode/skills/pexoai-ai-video-generation.md) — skill · 130 installs
- [fal-video-edit](https://affpapa.org/en/nevibecode/skills/fal-video-edit.md) — skill · 2900 installs

## Other versions with the same name
- [ai-video-gen · calesthio](https://affpapa.org/en/nevibecode/skills/ai-video-gen.md) — 1400 installs
- [ai-video-gen · sundial-org](https://affpapa.org/en/nevibecode/skills/sundial-org-ai-video-gen.md) — 155 installs

From the same set: [calesthio/openmontage](https://affpapa.org/en/nevibecode/by/calesthio/openmontage.md) — 101 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
