Agent skill · creative production · heygen-com
heygen-avatar
Create a persistent HeyGen avatar — a reusable face + voice identity for the agent, the user, or any named character — powered by HeyGen Avatar V technology. Prompt-based creation by default (description → HeyGen builds it); photo upload is optional for real-person digital twins. Use when: (1) giving the agent a face + voice so it can present videos ("bring yourself to life", "create your avatar", "give yourself an avatar", "design a presenter", "set up an avatar", "let's make an avatar"), (2) the user wants to appear in videos as themselves ("create my avatar", "I want my face in a video", "digital twin of me", "build me an avatar"), (3) building a named character presenter ("create an avatar called Cleo", "design a character named X"), (4) establishing HeyGen identity before making videos — the correct FIRST step when no avatar exists yet. Chain signal: when the user says both an identity/avatar action AND a video action in the same request ("create an avatar AND make a video", "set up identity THEN create a video", "design a presenter AND immediately record"), run heygen-avatar first, then heygen-video. Returns avatar_id + voice_id — pass directly to heygen-video to create HeyGen videos. NOT for: generating videos (use heygen-video), translating videos, or TTS-only tasks.
Why this skill is useful
Adds specific commands and workflows for creating and managing HeyGen avatars that the AI wouldn't reliably generate on its own.
What it needs
Requires heygen account access. About 12k tokens when loaded. Last updated 2026-07-14. 382 stars on the source repository.
What this skill does
HeyGen Avatar Designer Create and manage HeyGen avatars for anyone: the agent, the user, or named characters. Handles identity extraction, avatar generation, voice selection, and saves everything to AVATAR-<NAME>.md for consistent reuse. Files & Paths This skill reads and writes the following. No other files are accessed without explicit user instruction. Operation Path Purpose ----------- ------ --------- Read SOUL.md, IDENTITY.md Extract identity details when creating an avatar for the agent Read AVATAR-<NAME>.md Load existing avatar identity (for variant looks, voice updates) Write AVATAR-<NAME>.md Save new avatar identity after creation Write AVATAR-AGENT.md, AVATAR-USER.md (symlinks) Role aliases, see Phase 5 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 photos uploaded to HeyGen for digital-twin creation Assets are only uploaded to HeyGen when the user explicitly provides them. Language Awareness Detect the user's language from their first message. Store as userlanguage (e.g., en, ja, es, ko, zh, fr, de, pt). 1. Communicate with the user in their language. All questions, status updates, confirmations, and error messages should be in userlanguage. 2. Voice design prompts and selection respect userlanguage. When designing or selecting a voice, specify the target language so the voice library returns matches that speak it. 3. Technical directives stay in English — enum values (Young Adult, Realistic, landscape, etc.) are API-level and not translated. UX Rules 1. Be concise. No avatar IDs, group IDs, or raw API payloads in chat. Report the result (avatar created, ready to use) not the plumbing. 2. No internal jargon. Never mention internal phase names ("Phase 0", "Phase 5 Symlink Maintenance") to the user. The user sees natural conversation: "Setting up your avatar\u2026" not "Running Phase 2 avatar creation." 3. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills heygen-com/heygen-avatar