ai-video-gen · calesthio — Claude Code and Codex skill: AI video from text
ai-video-gen turns a written prompt into a video clip through HeyGen, fal.ai, Kling or Gemini, choosing a gateway for the job.
AGPL-3.0 ★ 78,316 updated 2026-11-10
npx skills add calesthio/OpenMontage --skill ai-video-gen -a claude-codeWhat ai-video-gen 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.
What it helps with
- 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 for the agent
- Generate a 10-second clip: a drone over a coastal city at sunset, 16:9.
- Use
shot_03.pngas the reference image and turn it into video. - In this clip, remove the car on the left and relight it for evening.
How to install ai-video-gen
1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill ai-video-gen -a claude-code2Manually: put the files in place
~/.claude/skills/ai-video-gen/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ai-video-gen/
1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill ai-video-gen -a codex2Manually: put the files in place
.agents/skills/ai-video-gen/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill ai-video-gen -a cursor2Manually: put the files in place
.cursor/skills/ai-video-gen/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install calesthio/OpenMontage .agents/skills/ai-video-gen2Manually: put the files in place
.github/skills/ai-video-gen/SKILL.md1Skills CLI (Vercel)
npx skills add calesthio/OpenMontage --skill ai-video-gen -a gemini-cli2Platform CLI
gemini skills install https://github.com/calesthio/OpenMontage --path .agents/skills/ai-video-genManually: put the files in place
.devin/skills/ai-video-gen/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ai-video-gen
How do I install ai-video-gen in Claude Code?
Run npx skills add calesthio/OpenMontage --skill ai-video-gen -a claude-code. The skill file lands at ~/.claude/skills/ai-video-gen/SKILL.md.
What does ai-video-gen do?
It generates video clips from text prompts across several gateways and picks a provider based on the credentials you have and the cost.
Do I need a separate key for each provider?
You need at least one of the listed environment variables. Note that fal.ai Kling and Kling Official are distinct paths: kling_video uses FAL_KEY, while kling_official_video needs KLING_API_KEY.
Similar skills
All skills for AI and ML →ai-video-gen by other authors comes first.