Agent Skills › calesthio/OpenMontage › heygen

heygen

GitHub

HeyGen AI视频生成技能，用于创建数字人讲解视频和演示文稿。支持基于提示词自动生成或精确控制头像、声音及场景。优先使用MCP工具处理认证与请求格式，提供从生成到状态查询的完整工作流。

.agents/skills/heygen/SKILL.md calesthio/OpenMontage

Trigger Scenarios

需要生成AI数字人视频创建带有特定头像和配音的讲解视频

Install

npx skills add calesthio/OpenMontage --skill heygen -g -y

More Options

Non-standard path

npx skills add https://github.com/calesthio/OpenMontage/tree/main/.agents/skills/heygen -g -y

Use without installing

npx skills use calesthio/OpenMontage@heygen

指定 Agent (Claude Code)

npx skills add calesthio/OpenMontage --skill heygen -a claude-code -g -y

安装 repo 全部 skill

npx skills add calesthio/OpenMontage --all -g -y

预览 repo 内 skill

npx skills add calesthio/OpenMontage --list

SKILL.md

Frontmatter

{
    "name": "heygen",
    "homepage": "https:\/\/docs.heygen.com\/reference\/generate-video-agent",
    "metadata": {
        "openclaw": {
            "requires": {
                "env": [
                    "HEYGEN_API_KEY"
                ]
            },
            "primaryEnv": "HEYGEN_API_KEY"
        }
    },
    "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.\n",
    "allowed-tools": "mcp__heygen__*"
}

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:

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

Without MCP tools (direct API):

Write an optimized prompt using prompt-optimizer.md → visual-styles.md
POST /v1/video_agent/generate — see video-agent.md
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

references/authentication.md - API key setup and X-Api-Key header
references/quota.md - Credit system and usage limits
references/video-status.md - Polling patterns and download URLs
references/assets.md - Uploading images, videos, audio

Core Video Creation

references/avatars.md - Listing avatars, styles, avatar_id selection
references/voices.md - Listing voices, locales, speed/pitch
references/scripts.md - Writing scripts, pauses, pacing
references/video-generation.md - POST /v2/video/generate and multi-scene videos
references/video-agent.md - One-shot prompt video generation
references/prompt-optimizer.md - Writing effective Video Agent prompts (core workflow + rules)
references/visual-styles.md - 20 named visual styles with full specs
references/prompt-examples.md - Full production prompt example + ready-to-use templates
references/dimensions.md - Resolution and aspect ratios