Overview

A knowledge base of best practices and API documentation for working with the HeyGen AI avatar video creation API, designed for use with Claude Code.

This skills package provides Claude Code with domain-specific knowledge about the HeyGen API, enabling it to:

  • Generate AI avatar videos with precise control (v2 API)
  • Create videos from simple prompts using Video Agent
  • Optimize prompts for better Video Agent results
  • Work with avatars, voices, and backgrounds
  • Handle video translation and dubbing
  • Manage streaming avatars for real-time interaction
  • Create photo avatars (talking photos)
  • Integrate with Remotion for programmatic video composition
  • Configure webhooks and callbacks

Installation

Option 1: Using add-skill CLI (Recommended)

Install using the add-skill CLI:

# Install to Claude Code globally
npx skills add heygen-com/skills -a claude-code -g

# Or install to current project only
npx skills add heygen-com/skills -a claude-code

# List available skills first
npx skills add heygen-com/skills --list

This works with Claude Code, Cursor, Codex, and 13 other agents.

Option 2: Manual Installation

Clone and symlink to your Claude skills directory:

# Clone the repository
git clone https://github.com/heygen-com/skills.git

# Symlink to personal skills (available in all projects)
ln -s $(pwd)/skills/skills/heygen ~/.claude/skills/heygen

# OR symlink to project skills (available in current project only)
mkdir -p .claude/skills
ln -s $(pwd)/skills/skills/heygen .claude/skills/heygen

Option 3: Direct Copy

Copy the skill directly to your project:

git clone https://github.com/heygen-com/skills.git
mkdir -p .claude/skills
cp -r skills/skills/heygen .claude/skills/

Verify Installation

The skill should appear when Claude Code loads. You can verify by asking Claude about HeyGen APIs.

Requirements

Related Resources

License

MIT