Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →Automate AI video generation, avatar browsing, template-based video creation, and video status tracking through HeyGen's platform via Composio
.claude/skills/composiohq-heygen-automation/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-03 | ✗→✓ | ▲ Improved | 34% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 29% | 0% |
| case-07 | ✗→✓ | ▲ Improved | 121% | 0% |
| case-11 | ✗→✓ | ▲ Improved | 60% | 0% |
| case-12 | ✗→✓ | ▲ Improved | 226% | 0% |
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
https://rube.app/mcpHEYGEN_* tools become available for executionRetrieve 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.
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.
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.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.
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.
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.
| 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 |
| 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
| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 5,181 | 17,409 | +236% | 1 | 1 | 0% | 981 | 1,338 | +36% | 0 | 0 | — |
case-02 | fail→fail | 11,613 | 2,857 | -75% | 1 | 1 | 0% | 2,030 | 1,271 | -37% | 0 | 0 | — |
case-03 | fail→pass | 7,424 | 4,379 | -41% | 1 | 1 | 0% | 1,469 | 1,968 | +34% | 0 | 0 | — |
case-04 | pass→pass | 5,698 | 2,726 | -52% | 1 | 1 | 0% | 1,112 | 1,578 | +42% | 0 | 0 | — |
case-05 | fail→pass | 7,783 | 4,549 | -42% | 1 | 1 | 0% | 1,459 | 1,884 | +29% | 0 | 0 | — |
case-06 | pass→pass | 7,327 | 2,763 | -62% | 1 | 1 | 0% | 1,321 | 1,545 | +17% | 0 | 0 | — |
case-07 | fail→pass | 4,214 | 3,507 | -17% | 1 | 1 | 0% | 758 | 1,673 | +121% | 0 | 0 | — |
case-08 | pass→pass | 6,620 | 4,997 | -25% | 1 | 1 | 0% | 1,184 | 2,029 | +71% | 0 | 0 | — |
case-09 | pass→pass | 11,011 | 6,406 | -42% | 1 | 1 | 0% | 1,998 | 2,285 | +14% | 0 | 0 | — |
case-10 | pass→fail | 9,769 | 6,800 | -30% | 1 | 1 | 0% | 1,957 | 2,484 | +27% | 0 | 0 | — |
case-11 | fail→pass | 4,356 | 1,877 | -57% | 1 | 1 | 0% | 883 | 1,410 | +60% | 0 | 0 | — |
case-12 | fail→pass | 2,513 | 2,071 | -18% | 1 | 1 | 0% | 458 | 1,492 | +226% | 0 | 0 | — |
case-13 | fail→pass | 5,604 | 2,512 | -55% | 1 | 1 | 0% | 1,018 | 1,496 | +47% | 0 | 0 | — |
case-14 | fail→pass | 5,087 | 2,455 | -52% | 1 | 1 | 0% | 923 | 1,377 | +49% | 0 | 0 | — |
case-15 | fail→pass | 9,078 | 2,991 | -67% | 1 | 1 | 0% | 1,652 | 1,592 | -4% | 0 | 0 | — |
case-16 | pass→pass | 2,543 | 1,654 | -35% | 1 | 1 | 0% | 366 | 1,324 | +262% | 0 | 0 | — |
case-17 | pass→pass | 2,035 | 1,571 | -23% | 1 | 1 | 0% | 339 | 1,300 | +283% | 0 | 0 | — |
case-18 | pass→pass | 2,205 | 1,704 | -23% | 1 | 1 | 0% | 302 | 1,296 | +329% | 0 | 0 | — |
case-19 | pass→pass | 4,983 | 1,383 | -72% | 1 | 1 | 0% | 802 | 1,319 | +64% | 0 | 0 | — |
case-20 | fail→pass | 5,138 | 1,760 | -66% | 1 | 1 | 0% | 976 | 1,423 | +46% | 0 | 0 | — |
case-21 | fail→pass | 7,913 | 2,051 | -74% | 1 | 1 | 0% | 1,536 | 1,370 | -11% | 0 | 0 | — |
case-22 | fail→pass | 6,183 | 3,709 | -40% | 1 | 1 | 0% | 1,192 | 1,779 | +49% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted. The headline lift of +45 percentage points is the difference between those two pass rates over the 22 comparable cases. 1 case got worse with the skill loaded, and it is included in that figure.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
Other measured skills in the registry, with their headline benchmark lift.