Skip to content
cccskills
FreePublished on GitHub

heygen

Generate HeyGen videos from text prompts or specify avatars, voices, scripts, and scenes for controlled production. This deprecated skill covers explainers and presentations; its replacement skills separate prompt-based generation from detailed avatar video creation.

OriginalShow the original description

[DEPRECATED] Use `create-video` for prompt-based video generation or `avatar-video` for precise avatar/scene control. This legacy skill combines both workflows — the newer focused skills provide clearer guidance.

See how to install

Good for

  • Generating explainer videos from text prompts
  • Creating avatar presentations with an exact script
  • Specifying avatars and backgrounds for each scene
  • Checking video generation status and download links

Files included (21)

  • SKILL.md5.7 KB
  • references/assets.md8.6 KB
  • references/authentication.md4.7 KB
  • references/avatars.md14.5 KB
  • references/backgrounds.md6.5 KB
  • references/captions.md5.5 KB
  • references/dimensions.md6.8 KB
  • references/photo-avatars.md23.9 KB
  • references/prompt-examples.md7.9 KB
  • references/prompt-optimizer.md12.1 KB
  • references/quota.md4.7 KB
  • references/remotion-integration.md18.1 KB
  • references/scripts.md9.9 KB
  • references/templates.md9.8 KB
  • references/text-overlays.md6.8 KB
  • references/video-agent.md9.6 KB
  • references/video-generation.md21.6 KB
  • references/video-status.md13.5 KB
  • references/visual-styles.md14.6 KB
  • references/voices.md11.6 KB
  • references/webhooks.md9.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

HeyGen API (Deprecated)

This skill is deprecated. Use the focused skills instead:

  • create-video — Generate videos from a text prompt (Video Agent API)
  • avatar-video — Build videos with specific avatars, voices, scripts, and scenes (v2 API)

This skill remains for backward compatibility but will be removed in a future release.


AI avatar video creation API for generating talking-head videos, explainers, and presentations.

Tool Selection

If HeyGen MCP tools are available (mcp__heygen__*), prefer them over direct HTTP API calls — they handle authentication and request formatting automatically.

TaskMCP ToolFallback (Direct API)
Generate video from promptmcp__heygen__generate_video_agentPOST /v1/video_agent/generate
Check video status / get URLmcp__heygen__get_videoGET /v2/videos/{video_id}
List account videosmcp__heygen__list_videosGET /v2/videos
Delete a videomcp__heygen__delete_videoDELETE /v2/videos/{video_id}

If no HeyGen MCP tools are available, use direct HTTP API calls with X-Api-Key: $HEYGEN_API_KEY header as documented in the reference files.

Default Workflow

Prefer Video Agent for most video requests. Always use prompt-optimizer.md guidelines to structure prompts with scenes, timing, and visual styles.

With MCP tools:

  1. Write an optimized prompt using prompt-optimizer.md → visual-styles.md
  2. Call mcp__heygen__generate_video_agent with prompt and config (duration_sec, orientation, avatar_id)
  3. Call mcp__heygen__get_video with the returned video_id to poll status and get the download URL

Without MCP tools (direct API):

  1. Write an optimized prompt using prompt-optimizer.md → visual-styles.md
  2. POST /v1/video_agent/generate — see video-agent.md
  3. GET /v2/videos/<id> — see video-status.md

Only use v2/video/generate when user explicitly needs:

  • Exact script without AI modification
  • Specific voice_id selection
  • Different avatars/backgrounds per scene
  • Precise per-scene timing control
  • Programmatic/batch generation with exact specs

Quick Reference

TaskMCP ToolRead
Generate video from prompt (easy)mcp__heygen__generate_video_agentprompt-optimizer.md → visual-styles.md → video-agent.md
Generate video with precise control—video-generation.md, avatars.md, voices.md
Check video status / get download URLmcp__heygen__get_videovideo-status.md
Add captions or text overlays—captions.md, text-overlays.md
Transparent video for compositing—video-generation.md (WebM section)
Use with Remotion—remotion-integration.md

Reference Files

Foundation

Core Video Creation

Video Customization

Advanced Features

Integration

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Create 3D objects from text or images, choose catalog assets for repeated scenery, and inspect the results in Blender. The workflow checks geometry, materials, scale, and ground contact while recording asset sources and generation costs.

  • Create a unique 3D object from a text description
  • Reconstruct a 3D object from a concept image
  • Populate scenery with catalog vegetation and rocks
calesthio/OpenMontage70.9KUpdated Oct 17, 2026

acestep

FreeSummary

Generate background music and songs with lyrics using ACE-Step 1.5, with controls for duration, tempo, and musical key. You can also restyle reference audio and separate vocals or individual instruments from mixed tracks.

  • Generate background music to match a video scene
  • Create a short jingle with supplied lyrics
  • Make a jazz arrangement of reference audio
calesthio/OpenMontage70.9KUpdated Oct 17, 2026

agents

FreeSummary

Build voice assistants and conversational characters with ElevenLabs. Configure voices, language models, and external tools, then connect conversations to a website widget or use Twilio integration for outbound phone calls.

  • Creating a voice bot for customer support
  • Embedding a voice assistant on a website
  • Building an interactive voice character
calesthio/OpenMontage70.9KUpdated Oct 17, 2026

ai-video-gen

FreeSummary

Create AI video clips from text or reference images, choosing among providers to match the task and budget. Supports vertical social videos, product photo animation, and conversational editing of existing clips with Gemini Omni Flash.

  • Create vertical video clips for social media
  • Animate product photos
  • Choose a video provider for a budget and visual style
calesthio/OpenMontage70.9KUpdated Oct 17, 2026

ai-video-gen

FreeSummary

Generate video clips from text descriptions or reference images through multiple API services. Compare available providers by cost and task needs, choose aspect ratios, track generation progress, and refine existing clips through conversational editing with Gemini Omni.

  • Generating clips from written scene descriptions
  • Animating a product photo
  • Creating vertical videos for social media
calesthio/OpenMontage70.9KUpdated Oct 17, 2026

atlas-cloud

FreeSummary

Generate and edit images and videos through Atlas Cloud using one API key across multiple model families. Choose supported models for each task, download the results, and retain details about the model, inputs, and estimated cost.

  • Generate images and videos through one service
  • Edit product images using reference materials
  • Create videos from images, video, or audio references
calesthio/OpenMontage70.9KUpdated Oct 17, 2026

See all skills by calesthio

Report a problem with this skill