HeyGen Automation
Helps your agent automatically create videos using avatars and templates. Allows tracking the status of created videos.
What it does
This tool lets you create AI-powered videos using pre-made templates. You can browse templates and avatars, generate personalized videos, and track their creation status.
When to use it
- ✓When you need to create a quick marketing video.
- ✓To generate training videos with avatars.
- ✓To test different video templates without coding.
Example of what to ask your AI
“I want to create a video using the 'Product Launch' template and the 'Ana' avatar, with the text 'Discover our new product!'”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
First, you connect your HeyGen account. Then, the tool finds available templates and avatars. You choose a template, provide the necessary details (like text and avatar), and the tool generates the video for you.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add ComposioHQ/awesome-claude-skills --skill HeyGen AutomationOr download just the file:
curl -L https://raw.githubusercontent.com/ComposioHQ/awesome-claude-skills/master/composio-skills/heygen-automation/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
HeyGen Automation
Automate AI-powered video creation workflows -- browse avatars and templates, generate personalized videos from templates, track processing status, and retrieve shareable URLs -- all orchestrated through the Composio MCP integration.
Toolkit docs: composio.dev/toolkits/heygen
Setup
- Connect your HeyGen account through the Composio MCP server at
https://rube.app/mcp - The agent will prompt you with an authentication link if no active connection exists
- Once connected, all
HEYGEN_*tools become available for execution
Core Workflows
1. Browse Available Templates
Retrieve pre-designed avatar templates from the HeyGen library for video creation.
Tool: HEYGEN_V2_TEMPLATES
No parameters required -- returns template IDs, names, preview images, and customization options.
Use this to discover templates before generating videos. Each template has a unique ID needed for generation.
2. Inspect Template Details & Variables
Retrieve the full structure of a template including all variables, scene mappings, and customization options.
Tool: HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3
| Parameter | Type | Required | Description |
|---|---|---|---|
template_id |
string | Yes | Template ID from HEYGEN_V2_TEMPLATES or the HeyGen dashboard |
This is a required prerequisite before generating videos -- it tells you exactly which variables must be populated.
3. Browse Available Avatars
List all realistic avatars available for video creation, useful for mapping characters to scenes.
Tool: HEYGEN_V2_AVATARS
No parameters required -- returns avatar identifiers, names, and preview images.
The list may be paginated; additional calls might be needed for the full set.
4. Generate Video from Template
Create a customized video by populating a template with your variables and content.
Tool: HEYGEN_V2_TEMPLATE_GENERATE
Provide a video title and all template variables discovered via HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3. Every required variable must be supplied with exact names and types.
5. Check Video Processing Status
Poll the processing status and retrieve metadata for a video being generated.
Tool: HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS
| Parameter | Type | Required | Description |
|---|---|---|---|
video_id |
string | Yes | Video ID returned from the generation API |
Returned URLs expire after 7 days but can be regenerated by calling this endpoint again.
6. Get Shareable Video URL
Generate a public, shareable link that allows anyone to view the video without authentication.
Tool: HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL
Provide the video_id to receive a public URL for distribution.
Known Pitfalls
| Pitfall | Details |
|---|---|
| All template variables required | HEYGEN_V2_TEMPLATE_GENERATE demands every variable from HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 with exact names and types -- missing or misnamed fields break scenes or fail generation |
| Always inspect templates first | Never skip HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 before generation -- multi-scene templates have complex variable structures |
| Video URLs expire | URLs from HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS expire after 7 days; regenerate by calling the endpoint again |
| Paginated avatar lists | HEYGEN_V2_AVATARS may return paginated results -- additional calls may be needed for the full library |
| Processing time varies | Video generation is asynchronous; poll HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS until status is complete before using output URLs |
Quick Reference
| Tool Slug | Purpose |
|---|---|
HEYGEN_V2_TEMPLATES |
List available video templates |
HEYGEN_RETRIEVE_TEMPLATE_DETAILS_V3 |
Get template variables and scene structure |
HEYGEN_V2_AVATARS |
Browse available AI avatars |
HEYGEN_V2_TEMPLATE_GENERATE |
Generate video from a template |
HEYGEN_RETRIEVE_VIDEO_STATUS_DETAILS |
Check video processing status and get URLs |
HEYGEN_RETRIEVE_SHARABLE_VIDEO_URL |
Get a public shareable video link |
Powered by Composio
FAQ
How do I connect my HeyGen account?
You connect your HeyGen account through the Composio MCP server at the provided setup link.
Do I need to know what information to use to create the video?
Yes, before creating the video, you need to check the details of the chosen template to know what information (variables) it requires.
Do the generated video links last forever?
No, the links to watch the videos expire after 7 days. You can generate a new link if needed.
Details
Original description by the author
Automate AI video generation, avatar browsing, template-based video creation, and video status tracking through HeyGen's platform via Composio
Popularity
- GitHub stars
- 77k
- Ranking position
- #1241
- License
- —
- Updated
- 9/18/2026
Comments
- …
More skills from this repository
artifacts-builder
Helps your agent build complex user interfaces. It uses modern technologies to create rich, interactive web pages.
ComposioHQ/awesome-claude-skills
brand-guidelines
Helps your agent apply official brand colors and fonts to materials. It's useful for maintaining visual identity in any piece that needs to look like the company's.
ComposioHQ/awesome-claude-skills
canvas-design
Lets your agent create original visual art in .png and .pdf. Use it when the user asks to create a poster, art, or other static design.
ComposioHQ/awesome-claude-skills
changelog-generator
Helps your agent create user-facing release notes from code commits. It transforms technical information into easy-to-understand text.
ComposioHQ/awesome-claude-skills
Similar skills
blender-motion-state-inspection
Allows inspection of details in 3D animations. It's useful for checking poses, movements, and character alignment in animations.
affaan-m/ECC
manim-video
Lets your agent create animated explainer videos. It uses Manim to generate clear graphs and diagrams for technical concepts.
affaan-m/ECC
remotion-video-creation
Guides your agent in creating videos using React with the Remotion library. It covers best practices for animations, audio, captions, and other visual elements.
affaan-m/ECC