Create Video

What it does

When your agent uses it

• Creating a video from a description
• Generating explainer
• Marketing videos from a prompt
• Making a video without specifying exact avatars

Example prompts

• “make me a video”
• “create a video about X”
• “/create-video”

Requirements

• A credential in HEYGEN_API_KEY
• Pre-approved tools (allowed-tools): mcp__heygen__*

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

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

What it can do on your machine

Read from SKILL.md and the folder at commit 9327439. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • mcp__heygen__*

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • curl

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Hosts in commands or code, which the agent is likely to contact:

  • api.heygen.com

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • HEYGEN_API_KEY

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Create Video loads about 1.3k tokens when it runs, and up to ~24k if it reads all its reference files. Until then it costs about 103 tokens; SKILL.md has 425 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~103

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~24k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from calesthio/OpenMontage at commit 9327439, republished under its AGPL-3.0 licence (© calesthio). 425 words, ~1,331 tokens.

name

create-video

description

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

allowed-tools

mcp__heygen__*

homepage

https://docs.heygen.com/reference/generate-video-agent

curl -X POST "https://api.heygen.com/v1/video_agent/generate" \
  -H "X-Api-Key: $HEYGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a 60-second product demo video."}'

© calesthio, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 9 other files (references) in .agents/skills/create-video of calesthio/OpenMontage.

• SKILL.md
• references/assets.md
• references/dimensions.md
• references/prompt-examples.md
• references/prompt-optimizer.md
• references/quota.md
• references/video-agent.md
• references/video-status.md
• references/visual-styles.md
• references/webhooks.md

Open the folder on GitHubat commit 9327439