This repository provides AI agent skills for creating personalized avatar videos, enabling users to generate digital twins with custom faces and voices for video production. It targets AI coding agents, offering a streamlined pipeline to bring user identities to life for creating introductory videos and other content, thereby enhancing digital communication and content creation workflows.

How It Works

The project comprises three distinct skills: heygen-avatar for creating persistent digital twins from photos, heygen-video for generating videos using these avatars based on prompts, and heygen-translate for localizing videos with voice cloning and lip-sync across over 175 languages. These skills integrate seamlessly with AI coding agents, communicating state through human-readable and machine-readable .md files (e.g., AVATAR-NAME.md), which store avatar identities and configurations for reuse. This approach allows for a modular and extensible video production pipeline directly within agent environments.

Quick Start & Requirements

Installation can be achieved via gh skill install heygen-com/skills (requires GitHub CLI v2.90+), clawhub install heygen-skills, openclaw plugins install clawhub:@heygen/openclaw-plugin-heygen, or a standard git clone. A HeyGen account is mandatory. Authentication supports two primary modes: direct API key usage via the HeyGen CLI (export HEYGEN_API_KEY=...) or OAuth via the remote MCP server, which consumes existing HeyGen plan credits. The setup involves installing the skills, obtaining an API key or configuring MCP, and optionally installing the HeyGen CLI. Detailed instructions are available at https://raw.githubusercontent.com/heygen-com/skills/master/INSTALL_FOR_AGENTS.md.

Highlighted Details

• Offers three integrated skills: avatar creation, video generation, and multilingual video translation/dubbing.
• Enables the creation of persistent digital avatars that can be reused across multiple video projects.
• Designed for deep integration with a variety of AI coding agents, including Claude Code, OpenClaw, and Cursor.
• Supports flexible authentication via API keys (direct billing) or MCP (plan credit consumption).

Maintenance & Community

The provided README does not contain specific details regarding notable contributors, sponsorships, community channels (like Discord or Slack), or a public roadmap.

Licensing & Compatibility

The project is released under the MIT License, permitting broad use, modification, and distribution, including for commercial purposes, with minimal restrictions beyond attribution.

Limitations & Caveats

The primary dependency is an active HeyGen account, which may incur costs depending on usage and the chosen authentication method (API key vs. MCP credits). While the project boasts no runtime dependencies or build steps for ease of integration, users must manage their HeyGen API keys or MCP configurations securely. The functionality is contingent on the availability and terms of the HeyGen service.