Index of every page on this site: llms.txt
All skills
openmontageinc avatar

/heygen

@2e003e6
by openmontageincopenmontageinc/openmontage82k stars
11,135
Run it yourself

[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.

Use this Skill: https://skilld.dev/gh/openmontageinc/openmontage/heygen

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈56 tokens for metadata: the name and description. ≈1.4k when used: this file. ≈56k more on demand in 20 files.

Description uses 2.8% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈221 characters, or 2.8%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.

Task MCP Tool Fallback (Direct API)
Generate video from prompt mcp__heygen__generate_video_agent POST /v1/video_agent/generate
Check video status / get URL mcp__heygen__get_video GET /v2/videos/{video_id}
List account videos mcp__heygen__list_videos GET /v2/videos
Delete a video mcp__heygen__delete_video DELETE /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

Task MCP Tool Read
Generate video from prompt (easy) mcp__heygen__generate_video_agent prompt-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 URL mcp__heygen__get_video video-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

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alerts12d3 checks · Risk SAFE
  • Gen Agent Trust Hub12d

    This skill provides documentation and implementation guides for the HeyGen AI video generation API, including legacy workflows. It facilitates the creation of avatar-based videos from text prompts and the uploading of local binary assets. While it follows secure practices for API key management, the instructions for file-based asset uploads and prompt processing create surfaces for potential data exfiltration and indirect prompt injection if the agent is subjected to adversarial input.

  • Socket12d

    No alerts

  • Snyk12d

    Risk: LOW · No issues

Signed by skilld at 2e003e6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 4 days ago.

Activeupdated 8 months ago
MCP servers
heygen
homepage
https://docs.heygen.com/reference/generate-video-agent
All 1 allowed tools
mcp__heygen__*
Other metadata
metadata
{
  "openclaw": {
    "requires": {
      "env": [
        "HEYGEN_API_KEY"
      ]
    },
    "primaryEnv": "HEYGEN_API_KEY"
  }
}

README badge

README badge for openmontageinc/openmontage/heygen