calesthio/openmontage

heygen

[DEPRECATED] Use create-video for prompt-based video generation or avatar-video for precise avatar/scene control.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/calesthio/openmontage --skill heygen

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

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 (durationsec, orientation, avatarid)
  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

Related by task

from this repository

More skills

All skills
calesthio
Community

hyperframes-cli

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (hyperframes lambda deploy / render / progress / destroy / policies).

1h installs
2
GitHub stars
77.7K
Updated
Nov 3
calesthio
Community

pose-library-design

Design reusable 2D character pose libraries, action cycles, and expression states for data-driven animation.

1h installs
2
GitHub stars
77.7K
Updated
Nov 3
calesthio
Community

create-video

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

1h installs
2
GitHub stars
75.9K
Updated
Nov 3
calesthio
Community

ffmpeg

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

1h installs
2
GitHub stars
75.9K
Updated
Nov 3