Best practices for HeyGen - AI avatar video creation API
Install with the open skills CLI (global, non-interactive — available in every Claude Code session):
npx skills add davila7/claude-code-templates --skill "heygen-best-practices" -g -a claude-code -yOr manually — clone and copy the skill directory (SKILL.md + companion files):
git clone --depth 1 https://github.com/davila7/claude-code-templates /tmp/claude-code-templates && cp -r /tmp/claude-code-templates/cli-tool/components/skills/development/heygen-best-practices ~/.claude/skills/heygen-best-practicesThis skill is a directory: SKILL.md is the entry point; the files below ship with it.
---
name: heygen-best-practices
description: Best practices for HeyGen - AI avatar video creation API
metadata:
tags: heygen, video, avatar, ai, api, text-to-video
---
## When to use
Use this skill whenever you are dealing with HeyGen API code to obtain domain-specific knowledge for creating AI avatar videos, managing avatars, handling video generation workflows, and integrating with HeyGen's services.
## How to use
Read individual rule files for detailed explanations and code examples:
### Foundation
- [rules/authentication.md](rules/authentication.md) - API key setup, X-Api-Key header, and authentication patterns
- [rules/quota.md](rules/quota.md) - Credit system, usage limits, and checking remaining quota
- [rules/video-status.md](rules/video-status.md) - Polling patterns, status types, and retrieving download URLs
- [rules/assets.md](rules/assets.md) - Uploading images, videos, and audio for use in video generation
### Core Video Creation
- [rules/avatars.md](rules/avatars.md) - Listing avatars, avatar styles, and avatar_id selection
- [rules/voices.md](rules/voices.md) - Listing voices, locales, speed/pitch configuration
- [rules/scripts.md](rules/scripts.md) - Writing scripts, pauses/breaks, pacing, and structure templates
- [rules/video-generation.md](rules/video-generation.md) - POST /v2/video/generate workflow and multi-scene videos
- [rules/video-agent.md](rules/video-agent.md) - One-shot prompt video generation with Video Agent API
- [rules/dimensions.md](rules/dimensions.md) - Resolution options (720p/1080p) and aspect ratios
### Video Customization
- [rules/backgrounds.md](rules/backgrounds.md) - Solid colors, images, and video backgrounds
- [rules/text-overlays.md](rules/text-overlays.md) - Adding text with fonts and positioning
- [rules/captions.md](rules/captions.md) - Auto-generated captions and subtitle options
### Advanced Features
- [rules/templates.md](rules/templates.md) - Template listing and variable replacement
- [rules/video-translation.md](rules/video-translation.md) - Translating videos, quality/fast modes, and dubbing
- [rules/streaming-avatars.md](rules/streaming-avatars.md) - Real-time interactive avatar sessions
- [rules/photo-avatars.md](rules/photo-avatars.md) - Creating avatars from photos (talking photos)
- [rules/webhooks.md](rules/webhooks.md) - Registering webhook endpoints and event types
### Integration
- [rules/remotion-integration.md](rules/remotion-integration.md) - Using HeyGen avatar videos in Remotion compositions
Use when you have a spec or requirements for a multi-step task, before touching code
Use when creating new skills, editing existing skills, or verifying skills work before deployment
Give the agent its own dedicated email inbox via AgentMail. Send, receive, and manage email autonomously using agent-owned email addresses (e.g. hermes-agent@agentmail.to).