{
  "markdown": "# HeyGen Skills\n\nAI agent skills for creating avatar videos. Your agent gets a face, a voice, and the ability to send video like a message.\n\nWorks with Claude Code, OpenClaw, Codex, Cursor, and other AI coding agents.\n\n```\n\"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.\"\n→ 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\n```\n\n## Install\n\n**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.\n\n```\nRead https://raw.githubusercontent.com/heygen-com/skills/master/INSTALL_FOR_AGENTS.md and follow it.\nAsk me for any API keys you need.\n```\n\nThat'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.\n\nWant to install manually instead? Follow the steps below.\n\n### Step 1 — Install the skills\n\nThe repo ships three skills: `heygen-avatar`, `heygen-video`, and `heygen-translate`. Pick the install path that matches your tooling.\n\n**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)):\n\n```bash\ngh skill install heygen-com/skills heygen-avatar\ngh skill install heygen-com/skills heygen-video\ngh skill install heygen-com/skills heygen-translate\n```\n\nRequires GitHub CLI v2.90+. The CLI writes to the right directory for your agent automatically.\n\n**Option B: ClawHub:**\n\n```bash\nclawhub install heygen-skills\n```\n\n**Option C: OpenClaw plugin** (bundles MCP support):\n\n```bash\nopenclaw plugins install clawhub:@heygen/openclaw-plugin-heygen\n```\n\n**Option D: Git clone** (legacy path):\n\n| Agent | Install path |\n|-------|-------------|\n| **Claude Code** | `~/.claude/skills/heygen-skills` |\n| **OpenClaw** | `~/.openclaw/workspace/skills/heygen-skills` |\n| **Other** | Clone anywhere your agent loads skills from |\n\n```bash\ngit clone --single-branch --depth 1 https://github.com/heygen-com/skills.git <install-path>/heygen-skills\n```\n\nAfter cloning, the three skills are auto-discovered at `heygen-avatar/SKILL.md`, `heygen-video/SKILL.md`, and `heygen-translate/SKILL.md`.\n\n### Step 2 — Get your HeyGen API key\n\n1. Go to **[app.heygen.com/api](https://app.heygen.com/api)** (Settings → API)\n2. Generate a new API key\n3. Save it somewhere safe — you can't view it again after the modal closes\n\n### Step 3 — Install the HeyGen CLI\n\nOne-line install (macOS / Linux):\n\n```bash\ncurl -fsSL https://static.heygen.ai/cli/install.sh | bash\n```\n\nThen set your API key:\n\n```bash\nexport HEYGEN_API_KEY=<your-key>\n```\n\nThat's ephemeral (current shell only). To persist across sessions, add `export HEYGEN_API_KEY=<your-key>` to your shell profile (`~/.zshrc`, `~/.bashrc`, or equivalent).\n\nVerify:\n\n```bash\nheygen --version\nheygen auth status\n```\n\nThe [HeyGen CLI](https://github.com/heygen-com/heygen-cli) is a single static binary. No runtime deps.\n\n### Alternative: MCP (OAuth, no API key)\n\nIf 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.\n\nClaude Code:\n```bash\nclaude mcp add --transport http heygen https://mcp.heygen.com/mcp/v1/\n```\n\nOpenClaw: add to `~/.openclaw/openclaw.json`:\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"heygen\": { \"url\": \"https://mcp.heygen.com/mcp/v1/\" }\n    }\n  }\n}\n```\n\nThe first call triggers an OAuth consent flow in your browser.\n\n> **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.\n\n### Step 4 — Create your avatar\n\nAsk the user for a photo (URL or file), then use the **heygen-avatar** skill:\n\n> Create my HeyGen avatar from this photo: [user's photo]\n\nThe skill uploads the photo, creates a persistent digital twin with a voice, and saves an `AVATAR-<NAME>.md` file for future use.\n\n### Step 5 — Make your first video\n\nUse the **heygen-video** skill to generate an intro video with the avatar you just created:\n\n> Make a 30-60 second video of me introducing myself, casual tone.\n\nThe skill picks up the avatar automatically, writes a script, generates the video, and returns a share link.\n\n**That's it. You're set up.** The avatar persists — every future video reuses it automatically.\n\n---\n\n## What's Included\n\nThree skills that work standalone or chain together:\n\n| Skill | What it does | Invoke |\n|-------|-------------|--------|\n| **heygen-avatar** | Photo → persistent digital twin (face + voice). Reusable across every video. | `/heygen-avatar` |\n| **heygen-video** | Idea → script → prompt-engineered video with your avatar delivering the message. | `/heygen-video` |\n| **heygen-translate** | Existing video → translated and dubbed version with voice cloning and lip-sync. 175+ languages. | `/heygen-translate` |\n\n**heygen-avatar** creates the identity. **heygen-video** uses it. **heygen-translate** localizes finished videos.\n\n## How It Works\n\n```\nPhoto / Description          Avatar File              Finished Video\n       ↓                        ↓                        ↓\n  heygen-avatar    →    AVATAR-NAME.md       →    heygen-video\n  (identity + voice)    (reusable state)          (script + video)\n```\n\nSkills communicate through `AVATAR-<NAME>.md` files. heygen-avatar writes them, heygen-video reads them. Human-readable and machine-readable.\n\n## Authentication\n\nThe skills support two auth modes with explicit priority:\n\n| Priority | Mode | Trigger | Billing | Best for |\n|----------|------|---------|---------|----------|\n| 1 | **CLI (API key)** | `HEYGEN_API_KEY` is set | Direct API usage ($, separately billed) | Agents, CI, scripts |\n| 2 | **MCP (OAuth)** | MCP tools visible AND no API key | HeyGen plan credits (no extra billing) | Users on a HeyGen plan |\n| 3 | **CLI (fallback)** | `heygen auth login` session | Direct API usage ($) | Interactive CLI users |\n\n**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.\n\n### CLI with API key (recommended for agents)\n\nGet a key at **[app.heygen.com/api](https://app.heygen.com/api)**, then:\n\n```bash\nexport HEYGEN_API_KEY=your-key-here\n```\n\nIf `HEYGEN_API_KEY` is set, the skills use the CLI directly. No MCP probing. This is the most predictable setup for agent workflows.\n\nThe [HeyGen CLI](https://github.com/heygen-com/heygen-cli) pattern is `heygen <noun> <verb>`. Output is JSON on stdout with stable exit codes.\n\n- **Verify**: `heygen auth status`\n- **Alternative login**: `heygen auth login` — interactive browser flow, persists to `~/.heygen/credentials`\n\n### MCP (OAuth, no API key)\n\nIf 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.\n\n- Endpoint: `https://mcp.heygen.com/mcp/v1/`\n- Tool namespace: `mcp__heygen__*`\n- [MCP docs](https://developers.heygen.com/docs/mcp-remote)\n\nYou can have both configured — if `HEYGEN_API_KEY` is set, CLI wins.\n\n## Things to Try\n\nAfter setup, try these prompts with your agent:\n\n| Prompt | What happens |\n|--------|-------------|\n| \"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. |\n| \"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.) |\n| \"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 |\n| \"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 |\n| \"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. |\n| \"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 |\n| \"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 |\n| \"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 |\n\n## Requirements\n\n- A HeyGen account — sign in via MCP (OAuth) or with an [API key](https://app.heygen.com/api) if you use the CLI fallback\n- An AI agent that supports skills (Claude Code, OpenClaw, Codex, Cursor, or similar)\n- No runtime dependencies. No packages. No build step.\n\n## Security\n\nOne optional shell script:\n\n- **`scripts/update-check.sh`** — compares your local `VERSION` against the latest on GitHub. Read-only, opt-in, no data transmitted.\n\nData only leaves your machine through MCP / the `heygen` CLI (video generation) and optionally `raw.githubusercontent.com` (version check).\n\n## Looking for the v1 skills?\n\nThe 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).\n\n## Links\n\n- [HeyGen API Docs](https://developers.heygen.com/docs/quick-start)\n- [Repository](https://github.com/heygen-com/skills)\n- [Contributing](CONTRIBUTING.md)\n- [Changelog](CHANGELOG.md)\n\n## License\n\nMIT\n",
  "bytes": 10100,
  "sha": "2c9a369ac22e9f94c050db66f9a93bcd95ba6f983e6c52057620245d57c293f9",
  "repo_slug": "heygen-com/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_heygen_com_skills_ai_video_gen_a84e58d3/readme"
}