# Heygen Best Practices > Best practices for HeyGen - AI avatar video creation API Use when this capability is needed. - Skill: `tomevault-io/heygen-best-practices` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/heygen-best-practices` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/heygen-best-practices/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Integrations & APIs - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/heygen-best-practices --- ## 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 --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/davila7) — claim your Tome and manage your conversions.