happy-video-gen

Q: How do I install happy-video-gen?

Run npx skills add https://github.com/iamzhihuix/happy-claude-skills --skill happy-video-gen in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/happy-video-gen/ (personal) or .claude/skills/happy-video-gen/ (project).

by iamzhihuixMedia & Creative

Universal AI video generation supporting OpenAI Sora, Google Veo 2/3, Runway Gen-3/Gen-4, Pika 2.2, Luma Dream Machine (Ray 2), FAL (Kling / Wan / Veo / Sora wrappers), Ark Seedance 1.5 Pro/Lite, Bailian Wanx (i2v), MiniMax Hailuo-02, and Vidu Q3. Use this skill whenever the user asks to generate, create, make, or synthesize a video from a text prompt or from a first-frame image. Covers text-to-video and image-to-video, with optional last-frame control on providers that support it. Typical phrases include "generate a video of ...", "make a 5-second clip of ...", "animate this image", "生成一段视频", "做个短片", or any mention of video-generation model families like Sora, Veo, Runway Gen, Kling, Wan, Seedance, Hailuo, Pika, Dream Machine, Vidu. Always use this skill even if the user does not name a specific model — pick a provider from their EXTEND.md defaults or available API keys. Do NOT use this skill when the user explicitly mentions 即梦 / Dreamina / Jimeng — those go to happy-dreamina instead

Installs: 163
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/iamzhihuix/happy-claude-skills --skill happy-video-gen

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads happy-video-gen automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

happy-video-gen

Generates short videos (text-to-video or image-to-video) across 10 providers through one CLI: bun scripts/main.ts .... All providers are async — the CLI submits a job, polls until the provider finishes, then downloads the MP4 / WebM.

Quick usage

# Text-to-video
bun scripts/main.ts --prompt "camera slowly pushes into a calico cat on grass" --ar 16:9 --duration 5 --video ./out.mp4

# Image-to-video (first frame)
bun scripts/main.ts --prompt "subtle zoom, leaves swaying" --image ./keyframe.png --duration 5 --video ./out.mp4

# Image-to-video with last-frame control (provider-dependent)
bun scripts/main.ts --prompt "seamless morph" --image ./a.png --last-frame ./b.png --video ./out.mp4

When to invoke this skill

User asks to generate / create / make / synthesize a video from text.
User asks to animate a still image, or provides a first-frame path.
User names any video model family (Sora, Veo, Runway, Kling, Wan, Seedance, Hailuo, Pika, Dream Machine, Vidu).

Route to happy-dreamina if the user explicitly mentions 即梦 / Jimeng / dreamina CLI. Route to happy-image-gen if the user actually wants a still image.

Step 0: Preflight (BLOCKING)

Locate EXTEND.md (same resolution order as happy-image-gen):
- ./.happy-skills/happy-video-gen/EXTEND.md
- $XDG_CONFIG_HOME/happy-skills/happy-video-gen/EXTEND.md
- ~/.happy-skills/happy-video-gen/EXTEND.md
If none, run bun scripts/main.ts --setup and walk the user through references/config/first-time-setup.md.
Verify one provider has credentials. Check env vars in the order the CLI auto-detects (see providers.md). Do not proceed without one usable provider.
Verify Bun. Fall back to npx -y bun if missing.
Warn about cost. Video generation is 10–100× more expensive per call than images. If the user asks for HD 1080P / 10-second clips, confirm before firing — show them the expected provider cost bracket from references/providers.md.

Step 1: Choose provider

Preference order:

--provider <id> explicitly passed.
EXTEND.md default_provider.
Auto-detect from env vars: fal > ark > minimax > runway > luma > pika > vidu > google > bailian > openai.

Pick by strength of the actual task:

Chinese prompts / Chinese text in frame → ark (Seedance) or bailian (Wanx).
Photorealistic portraits → google (Veo 3) or runway (Gen-4).
Anime / stylized → fal (Kling) or luma.
Cheap draft → ark Seedance Lite, fal Kling v2.5 turbo, vidu Q1.
Voice-synced dialogue video (if applicable) → google Veo 3, openai Sora 2.

Step 2: Fill parameters

--prompt: always double-quote.
--image <path> / --last-frame <path>: local paths, will be base64-encoded as data URIs automatically. --last-frame only accepted by Luma and a few FAL endpoints.
--duration <seconds>: 5 is universal default. Caps: Sora-2 / Kling up to 10; Seedance up to 10; Luma up to 9.
--ar <ratio>: 16:9 / 9:16 / 1:1 / 4:3 / 3:4. See references/aspect_ratio_map.md for provider-specific quirks.
--resolution: 480p / 720p / 1080p. Not all providers honour it; most cap at 720p on cheap tiers.
--poll-timeout: default 600s (10 min). Increase for 1080P or >5s clips.

Step 3: Submit and wait

bun scripts/main.ts \
  --prompt "..." \
  --video ./out.mp4 \
  --provider ark \
  --duration 5 \
  --ar 16:9 \
  --resolution 720p

While waiting, do not fire another job on the same provider — concurrency caps on cheap tiers are strict (often 1). On success the CLI writes the MP4 and reports size + path. JSON output:

{ "success": true, "provider": "ark", "model": "doubao-seedance-1-0-lite-t2v-250408", "video": "/abs/out.mp4", "size_bytes": 4823456, "format": "mp4" }

Step 4: Timeouts and recovery

If polling exceeds --poll-timeout, the CLI throws with the provider-specific external id (task id / job id / operation name / request id). Capture it from stderr and resume later with provider-specific tooling. See references/async-protocol.md for the per-provider id format and manual resume commands.

References

references/providers.md — all 10 providers with env vars, defaults, cost notes, feature matrix.
references/async-protocol.md — external id format per provider + how to resume a stuck task.
references/aspect_ratio_map.md — --ar mapping per provider.
references/error_codes.md — common errors and fixes.
references/config/first-time-setup.md — setup walkthrough.
references/config/extend-schema.md — EXTEND.md schema.
assets/EXTEND.template.md — config template.

FAQ

What does the happy-video-gen skill do?

How do I install happy-video-gen?

Run npx skills add https://github.com/iamzhihuix/happy-claude-skills --skill happy-video-gen in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/happy-video-gen/ (personal) or .claude/skills/happy-video-gen/ (project).

Which AI agents can use happy-video-gen?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is happy-video-gen safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains happy-video-gen?

It is published by iamzhihuix in iamzhihuix/happy-claude-skills. It has 163 recorded installs.

Source

iamzhihuix/happy-claude-skills $View on skills.sh

Works with

Claude CodeCodexCursorGitHub CopilotGemini CLIWindsurfClineOpenCodeRoo CodeGooseAmpKiro

Files 24 · 69.7 KB

SKILL.md5.7 KB
assets/EXTEND.template.md1.6 KB
package.json346 B
references/aspect_ratio_map.md1.1 KB
references/async-protocol.md3.0 KB
references/config/extend-schema.md2.0 KB
references/config/first-time-setup.md2.5 KB
references/error_codes.md2.7 KB
references/providers.md3.8 KB
scripts/main.ts8.9 KB
scripts/providers/ark.ts4.0 KB
scripts/providers/bailian.ts3.3 KB
scripts/providers/fal.ts4.0 KB
scripts/providers/google.ts3.4 KB
scripts/providers/luma.ts3.1 KB
scripts/providers/minimax.ts3.7 KB
scripts/providers/openai.ts2.9 KB
scripts/providers/pika.ts2.7 KB
scripts/providers/runway.ts3.1 KB
scripts/providers/vidu.ts3.0 KB
scripts/types.ts1.7 KB
scripts/utils/aspect_ratio.ts706 B
scripts/utils/async.ts1.7 KB
scripts/utils/output.ts853 B