social-heygen-avatar

Generates AI avatar videos, image animations, and multilingual dubbing via the HeyGen API.

3|3|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/joaoguirunas/team-os --skill social-heygen-avatar-joaoguirunas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: social-heygen-avatar
Source: https://github.com/joaoguirunas/team-os/tree/main/.claude/skills/social-heygen-avatar
Command: npx skills add https://github.com/joaoguirunas/team-os --skill social-heygen-avatar-joaoguirunas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Producing talking-head videos, animated images, and dubbed content for social campaigns normally requires filming, actors, and manual translation. This Skill automates that production through HeyGen, turning scripts and images into finished presenter videos without a camera or studio. ## Core Features & Use Cases - Three generation modes: prompt-to-video via the Video Agent, explicit avatar plus script rendering, and image-to-video animation for key visuals or photos. - Multilingual dubbing: translate an existing video into other languages with create_video_translation, then poll until completion for reuse across markets. - Brand consistency: list and select avatars and voices by language and tone, then persist avatar_id and voice_id in smart-memory so every campaign video keeps the same presenter. - Use Case: A social media manager needs a 9:16 vertical video of a virtual presenter reading a campaign script in Portuguese. The Skill picks the saved brand avatar and voice, generates the video, polls until completion, and hands the MP4 to the ffmpeg post-production step for mandatory subtitles. ## Quick Start Ask the agent to generate a vertical HeyGen avatar video from the current campaign script using the saved brand avatar and voice, then add subtitles and export it for social publishing.

Frequently Asked Questions about social-heygen-avatar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a talking-head AI avatar video with HeyGen?▼

Use create_video_from_avatar with an explicit avatar_id, voice_id, and script, or create_video_agent in generate mode for a one-shot prompt-to-video flow. Poll get_video or get_video_agent_session until the status is completed before downloading the MP4.

How to animate a still image into a video with HeyGen?▼

Call create_video_from_image with the image plus a script or audio track. This brings key visuals or photos to life as speaking or moving video content without filming.

Can HeyGen dub a video into other languages?▼

Yes. List supported languages with list_video_translation_languages, then run create_video_translation with the video and target language, polling get_video_translation until done. Always review names, CTAs, and slang before publishing.

What happens if the HeyGen MCP connection is unavailable?▼

The Skill falls back to the HEYGEN_API_KEY environment variable for headless API access, which consumes API credits at roughly six per minute. If neither transport is available, it stops and notifies the lead instead of retrying in a loop.

Why is my HeyGen video agent session stuck waiting?▼

The session is likely in chat mode, which waits for interactive input and never completes. Use mode generate for one-shot rendering, and share the video-agent session link with the lead for visibility.

How do I keep the same avatar and voice across campaign videos?▼

Save the avatar_id and voice_id in smart-memory after the first creation and reuse them for every subsequent video. Consistency of presenter and voice per brand takes priority over generating new avatars.