Skip to content
Back to search

skills

HeyGen AI agent skills — avatar creation and video production via the v3 Video Agent pipeline

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/heygen-com--skills/badge.svg)](/listings/heygen-com--skills)

HTML

<a href="/listings/heygen-com--skills"><img src="/api/listings/heygen-com--skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**Paste this into your agent.** It does the rest — clones the repo to the right path, asks for your HeyGen API key, picks the best transport, runs a verify test, and ends with a working video.

Read https://raw.githubusercontent.com/heygen-com/skills/master/INSTALL_FOR_AGENTS.md and follow it.
Ask me for any API keys you need.

That's it. The agent fetches [INSTALL_FOR_AGENTS.md](./INSTALL_FOR_AGENTS.md) and walks the rest of the install. Same prompt forever — the install spec lives in the repo, not in your clipboard.

Want to install manually instead? Follow the steps below.

Step 1 — Install the skills

The repo ships three skills: `heygen-avatar`, `heygen-video`, and `heygen-translate`. Pick the install path that matches your tooling.

**Option A: `gh skill install`** (works across Claude Code, Cursor, Codex, Gemini CLI, Copilot, Junie, Goose, OpenHands, Amp, Cline, OpenCode, Warp, and more — [agentskills.io](https://agentskills.io)):

gh skill install heygen-com/skills heygen-avatar
gh skill install heygen-com/skills heygen-video
gh skill install heygen-com/skills heygen-translate

Requires GitHub CLI v2.90+. The CLI writes to the right directory for your agent automatically.

**Option B: ClawHub:**

clawhub install heygen-skills

**Option C: OpenClaw plugin** (bundles MCP support):

openclaw plugins install clawhub:@heygen/openclaw-plugin-heygen

**Option D: Git clone** (legacy path):

| Agent | Install path | |-------|-------------| | **Claude Code** | `~/.claude/skills/heygen-skills` | | **OpenClaw** | `~/.openclaw/workspace/skills/heygen-skills` | | **Other** | Clone anywhere your agent loads skills from |

git clone --single-branch --depth 1 https://github.com/heygen-com/skills.git <install-path>/heygen-skills

After cloning, the three skills are auto-discovered at `heygen-avatar/SKILL.md`, `heygen-video/SKILL.md`, and `heygen-translate/SKILL.md`.

Step 2 — Get your HeyGen API key

1. Go to **[app.heygen.com/api](https://app.heygen.com/api)** (Settings → API) 2. Generate a new API key 3. Save it somewhere safe — you can't view it again after the modal closes

Step 3 — Install the HeyGen CLI

One-line install (macOS / Linux):

curl -fsSL https://static.heygen.ai/cli/install.sh | bash

Then set your API key:

export HEYGEN_API_KEY=<your-key>

That's ephemeral (current shell only). To persist across sessions, add `export HEYGEN_API_KEY=<your-key>` to your shell profile (`~/.zshrc`, `~/.bashrc`, or equivalent).

Verify:

heygen --version
heygen auth status

The [HeyGen CLI](https://github.com/heygen-com/heygen-cli) is a single static binary. No runtime deps.

Alternative: MCP (OAuth, no API key)

If you prefer OAuth and already have a HeyGen plan with credits, connect the remote MCP server instead of setting an API key. The skills will auto-detect MCP when no `HEYGEN_API_KEY` is set.

Claude Code:

claude mcp add --transport http heygen https://mcp.heygen.com/mcp/v1/

OpenClaw: add to `~/.openclaw/openclaw.json`:

{
  "mcp": {
    "servers": {
      "heygen": { "url": "https://mcp.heygen.com/mcp/v1/" }
    }
  }
}

The first call triggers an OAuth consent flow in your browser.

> **Priority:** If `HEYGEN_API_KEY` is set, the skills use the CLI. Otherwise they look for MCP tools. Set the key only if you want direct API access; otherwise use MCP.

Step 4 — Create your avatar

Ask the user for a photo (URL or file), then use the **heygen-avatar** skill:

> Create my HeyGen avatar from this photo: [user's photo]

The skill uploads the photo, creates a persistent digital twin with a voice, and saves an `AVATAR-<NAME>.md` file for future use.

Step 5 — Make your first video

Use the **heygen-video** skill to generate an intro video with the avatar you just created:

> Make a 30-60 second video of me introducing myself, casual tone.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 32 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "heygen",
  3. "owner": {
  4. "name": "HeyGen",
  5. "url": "https://heygen.com"
  6. },
  7. "plugins": [
  8. {
  9. "name": "heygen",
  10. "source": "./",
  11. "description": "HeyGen skills for avatar creation, identity-first video generation, personalized video messages, and video translation / dubbing. Invoke as /heygen:avatar, /heygen:video, or /heygen:translate.",
  12. "version": "1.3.2",
  13. "skills": [
  14. {
  15. "name": "avatar",
  16. "path": "heygen-avatar",
  17. "invoke": "/heygen:avatar"
  18. },
  19. {
  20. "name": "video",
  21. "path": "heygen-video",
  22. "invoke": "/heygen:video"
  23. },
  24. {
  25. "name": "translate",
  26. "path": "heygen-translate",
  27. "invoke": "/heygen:translate"
  28. }
  29. ]
  30. }
  31. ]
  32. }
README.md · README · 242 lines · 1 finding marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # HeyGen Skills
  2. AI agent skills for creating avatar videos. Your agent gets a face, a voice, and the ability to send video like a message.
  3. Works with Claude Code, OpenClaw, Codex, Cursor, and other AI coding agents.
  4. ```
  5. "Bring yourself to life — create your own avatar and make a 30-second intro video of yourself. Use heygen-avatar and heygen-video, ask me anything before you start."
  6. → reads your agent's identity files → asks only what's missing → builds the agent's avatar → picks the best style → generates the video → delivers the share link
  7. ```
  8. ## Install
  9. **Paste this into your agent.** It does the rest — clones the repo to the right path, asks for your HeyGen API key, picks the best transport, runs a verify test, and ends with a working video.
  10. ```
  11. Read https://raw.githubusercontent.com/heygen-com/skills/master/INSTALL_FOR_AGENTS.md and follow it.
  12. Ask me for any API keys you need.
  13. ```
  14. That's it. The agent fetches [INSTALL_FOR_AGENTS.md](./INSTALL_FOR_AGENTS.md) and walks the rest of the install. Same prompt forever — the install spec lives in the repo, not in your clipboard.
  15. Want to install manually instead? Follow the steps below.
  16. ### Step 1 — Install the skills
  17. The repo ships three skills: `heygen-avatar`, `heygen-video`, and `heygen-translate`. Pick the install path that matches your tooling.
  18. **Option A: `gh skill install`** (works across Claude Code, Cursor, Codex, Gemini CLI, Copilot, Junie, Goose, OpenHands, Amp, Cline, OpenCode, Warp, and more — [agentskills.io](https://agentskills.io)):
  19. ```bash
  20. gh skill install heygen-com/skills heygen-avatar
  21. gh skill install heygen-com/skills heygen-video
  22. gh skill install heygen-com/skills heygen-translate
  23. ```
  24. Requires GitHub CLI v2.90+. The CLI writes to the right directory for your agent automatically.
  25. **Option B: ClawHub:**
  26. ```bash
  27. clawhub install heygen-skills
  28. ```
  29. **Option C: OpenClaw plugin** (bundles MCP support):
  30. ```bash
  31. openclaw plugins install clawhub:@heygen/openclaw-plugin-heygen
  32. ```
  33. **Option D: Git clone** (legacy path):
  34. | Agent | Install path |
  35. |-------|-------------|
  36. | **Claude Code** | `~/.claude/skills/heygen-skills` |
  37. | **OpenClaw** | `~/.openclaw/workspace/skills/heygen-skills` |
  38. | **Other** | Clone anywhere your agent loads skills from |
  39. ```bash
  40. git clone --single-branch --depth 1 https://github.com/heygen-com/skills.git <install-path>/heygen-skills
  41. ```
  42. After cloning, the three skills are auto-discovered at `heygen-avatar/SKILL.md`, `heygen-video/SKILL.md`, and `heygen-translate/SKILL.md`.
  43. ### Step 2 — Get your HeyGen API key
  44. 1. Go to **[app.heygen.com/api](https://app.heygen.com/api)** (Settings → API)
  45. 2. Generate a new API key
  46. 3. Save it somewhere safe — you can't view it again after the modal closes
  47. ### Step 3 — Install the HeyGen CLI
  48. One-line install (macOS / Linux):
  49. ```bash
  50. curl -fsSL https://static.heygen.ai/cli/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 76 on GitHub
  51. ```
  52. Then set your API key:
  53. ```bash
  54. export HEYGEN_API_KEY=<your-key>
  55. ```
  56. That's ephemeral (current shell only). To persist across sessions, add `export HEYGEN_API_KEY=<your-key>` to your shell profile (`~/.zshrc`, `~/.bashrc`, or equivalent).
  57. Verify:
  58. ```bash
  59. heygen --version
  60. heygen auth status
  61. ```
  62. The [HeyGen CLI](https://github.com/heygen-com/heygen-cli) is a single static binary. No runtime deps.
  63. ### Alternative: MCP (OAuth, no API key)
  64. If you prefer OAuth and already have a HeyGen plan with credits, connect the remote MCP server instead of setting an API key. The skills will auto-detect MCP when no `HEYGEN_API_KEY` is set.
  65. Claude Code:
  66. ```bash
  67. claude mcp add --transport http heygen https://mcp.heygen.com/mcp/v1/
  68. ```
  69. OpenClaw: add to `~/.openclaw/openclaw.json`:
  70. ```json
  71. {
  72. "mcp": {
  73. "servers": {
  74. "heygen": { "url": "https://mcp.heygen.com/mcp/v1/" }
  75. }
  76. }
  77. }
  78. ```
  79. The first call triggers an OAuth consent flow in your browser.
  80. > **Priority:** If `HEYGEN_API_KEY` is set, the skills use the CLI. Otherwise they look for MCP tools. Set the key only if you want direct API access; otherwise use MCP.
  81. ### Step 4 — Create your avatar
  82. Ask the user for a photo (URL or file), then use the **heygen-avatar** skill:
  83. > Create my HeyGen avatar from this photo: [user's photo]
  84. The skill uploads the photo, creates a persistent digital twin with a voice, and saves an `AVATAR-<NAME>.md` file for future use.
  85. ### Step 5 — Make your first video
  86. Use the **heygen-video** skill to generate an intro video with the avatar you just created:
  87. > Make a 30-60 second video of me introducing myself, casual tone.
  88. The skill picks up the avatar automatically, writes a script, generates the video, and returns a share link.
  89. **That's it. You're set up.** The avatar persists — every future video reuses it automatically.
  90. ---
  91. ## What's Included
  92. Three skills that work standalone or chain together:
  93. | Skill | What it does | Invoke |
  94. |-------|-------------|--------|
  95. | **heygen-avatar** | Photo → persistent digital twin (face + voice). Reusable across every video. | `/heygen-avatar` |
  96. | **heygen-video** | Idea → script → prompt-engineered video with your avatar delivering the message. | `/heygen-video` |
  97. | **heygen-translate** | Existing video → translated and dubbed version with voice cloning and lip-sync. 175+ languages. | `/heygen-translate` |
  98. **heygen-avatar** creates the identity. **heygen-video** uses it. **heygen-translate** localizes finished videos.
  99. ## How It Works
  100. ```
  101. Photo / Description Avatar File Finished Video
  102. ↓ ↓ ↓
  103. heygen-avatar → AVATAR-NAME.md → heygen-video
  104. (identity + voice) (reusable state) (script + video)
  105. ```
  106. Skills communicate through `AVATAR-<NAME>.md` files. heygen-avatar writes them, heygen-video reads them. Human-readable and machine-readable.
  107. ## Authentication
  108. The skills support two auth modes with explicit priority:
  109. | Priority | Mode | Trigger | Billing | Best for |
  110. |----------|------|---------|---------|----------|
  111. | 1 | **CLI (API key)** | `HEYGEN_API_KEY` is set | Direct API usage ($, separately billed) | Agents, CI, scripts |
  112. | 2 | **MCP (OAuth)** | MCP tools visible AND no API key | HeyGen plan credits (no extra billing) | Users on a HeyGen plan |
  113. | 3 | **CLI (fallback)** | `heygen auth login` session | Direct API usage ($) | Interactive CLI users |
  114. **Billing tradeoff:** CLI mode bills against your HeyGen API usage (separately metered). MCP mode consumes your existing HeyGen plan credits — no extra API billing. Pick the mode that matches how you want to be charged.
  115. ### CLI with API key (recommended for agents)
  116. Get a key at **[app.heygen.com/api](https://app.heygen.com/api)**, then:
  117. ```bash
  118. export HEYGEN_API_KEY=your-key-here
  119. ```
  120. If `HEYGEN_API_KEY` is set, the skills use the CLI directly. No MCP probing. This is the most predictable setup for agent workflows.
  121. The [HeyGen CLI](https://github.com/heygen-com/heygen-cli) pattern is `heygen <noun> <verb>`. Output is JSON on stdout with stable exit codes.
  122. - **Verify**: `heygen auth status`
  123. - **Alternative login**: `heygen auth login` — interactive browser flow, persists to `~/.heygen/credentials`
  124. ### MCP (OAuth, no API key)
  125. If you don't set an API key and HeyGen's remote MCP server is connected to your agent, the skills use MCP via OAuth. Calls run against your existing HeyGen plan credits.
  126. - Endpoint: `https://mcp.heygen.com/mcp/v1/`
  127. - Tool namespace: `mcp__heygen__*`
  128. - [MCP docs](https://developers.heygen.com/docs/mcp-remote)
  129. You can have both configured — if `HEYGEN_API_KEY` is set, CLI wins.
  130. ## Things to Try
  131. After setup, try these prompts with your agent:
  132. | Prompt | What happens |
  133. |--------|-------------|
  134. | "Use heygen-avatar and heygen-video to make a 30-second cinematic intro of me as a founder. Ask me what you need." | Full pipeline: avatar → style recommendation → video. The wow moment. |
  135. | "I want to make a product launch video. Use heygen-video and suggest the best style for it." | Skill recommends from 20 curated styles (A24, editorial, clean tech, etc.) |
  136. | "Use heygen-avatar — I have a headshot. What kind of look would work best for a founder intro?" | Skill asks questions, recommends setting and tone before creating |
  137. | "Use heygen-video to summarize this article as a 60-second explainer from my avatar: [URL]" | Fetches content, extracts key points, scripts and generates the video |
  138. | "Use heygen-video to turn the key points from this PDF into a video update for my team: [file]" | PDF → script → avatar video. Any content becomes a video message. |
  139. | "Use heygen-video for my team's weekly update. Ask me what shipped before writing the script." | Skill interviews you first, then writes and generates |
  140. | "Use heygen-video to make a 20-second outreach video to a potential investor. What should I include?" | Skill guides the message, you approve the script, avatar delivers it |
  141. | "Use heygen-avatar to give me a new look — ask me what vibe I'm going for." | Discovery flow: skill suggests options (outdoor, studio, casual, cinematic) before committing |
  142. ## Requirements
  143. - A HeyGen account — sign in via MCP (OAuth) or with an [API key](https://app.heygen.com/api) if you use the CLI fallback
  144. - An AI agent that supports skills (Claude Code, OpenClaw, Codex, Cursor, or similar)
  145. - No runtime dependencies. No packages. No build step.
  146. ## Security
  147. One optional shell script:
  148. - **`scripts/update-check.sh`** — compares your local `VERSION` against the latest on GitHub. Read-only, opt-in, no data transmitted.
  149. Data only leaves your machine through MCP / the `heygen` CLI (video generation) and optionally `raw.githubusercontent.com` (version check).
  150. ## Looking for the v1 skills?
  151. The previous version of this repo had individual skills for TTS, video translation, faceswap, video editing, and more. Those skills are preserved at [heygen-com/skills-legacy](https://github.com/heygen-com/skills-legacy).
  152. ## Links
  153. - [HeyGen API Docs](https://developers.heygen.com/docs/quick-start)
  154. - [Repository](https://github.com/heygen-com/skills)
  155. - [Contributing](CONTRIBUTING.md)
  156. - [Changelog](CHANGELOG.md)
  157. ## License
  158. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.