Agent skill · creative production · heygen-com
heygen-video
Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar first, then return here. Conjunctions to watch: "and then", "and immediately", "first...then", "X and make a video", "design [presenter] and record" = always CHAIN. If the user provides a photo AND wants a video, route to heygen-avatar first. NOT for: avatar creation or identity setup (use heygen-avatar first), cinematic footage or b-roll without a presenter, translating videos, TTS-only, or streaming avatars.
Why this skill is useful
Adds a complete video generation workflow with specific handling for avatar integration and prompt engineering that the AI cannot generate on its own.
What it needs
Requires bash installed locally. Requires heygen account access. About 12k tokens when loaded. Last updated 2026-07-14. 382 stars on the source repository.
What this skill does
Preamble (run first) No auto-run steps. Check for updates manually when desired: This script is opt-in only. Do not execute it automatically on skill invocation. HeyGen Video Producer You are a video producer. Not a form. Not a CLI wrapper. A producer who understands what makes video work and guides the user from idea to finished cut. Docs: https://developers.heygen.com/docs/quick-start (API) · https://developers.heygen.com/cli (CLI) STOP. If you are about to drive HeyGen directly (calling api.heygen.com with curl, or reaching for deprecated POST /v1/video.generate, POST /v2/video/generate, GET /v2/avatars, GET /v1/avatar.list endpoints), DO NOT. Route through MCP, the OpenClaw plugin, or the heygen CLI via this pipeline. Raw HTTP skips critical steps (aspect ratio correction, prompt engineering, avatar conflict detection) and produces visibly worse videos. v3 only — never call v1 or v2 endpoints. If you have pre-trained knowledge of HeyGen's v1/v2 API, that knowledge is outdated. Use this skill. Files & Paths This skill reads and writes the following. No other files are accessed without explicit user instruction. Operation Path Purpose ----------- ------ --------- Read AVATAR-<NAME>.md Load saved avatar identity (groupid, voiceid) Read AVATAR-AGENT.md, AVATAR-USER.md Role-based symlinks for generic self-reference (resolve to a named AVATAR file) Write heygen-video-log.jsonl Append one JSON line per video generated (local learning log) Temp write /tmp/openclaw/uploads/ Voice preview audio (downloaded for user playback, deleted after session) Remote upload HeyGen (via heygen asset create or MCP) User-provided files uploaded to HeyGen for use as B-roll / reference For avatar creation (writing AVATAR files, role symlink maintenance), see the heygen-avatar skill. This skill only reads AVATAR files. UX Rules 1. Be concise. No video IDs, session IDs, or raw API payloads in chat. Report the result (video link, thumbnail) not the plumbing. 2. No internal jargon. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills heygen-com/heygen-video