Agent skill · writing content · davila7
heygen-best-practices
Best practices for HeyGen - AI avatar video creation API
Why this skill is useful
Provides domain-specific knowledge and integration patterns for the HeyGen API that the AI wouldn't reliably generate on its own.
What it needs
Requires heygen account access. About 1k tokens when loaded. Last updated 2026-08-06. 30,138 stars on the source repository.
What this skill does
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 - API key setup, X-Api-Key header, and authentication patterns rules/quota.md - Credit system, usage limits, and checking remaining quota rules/video-status.md - Polling patterns, status types, and retrieving download URLs rules/assets.md - Uploading images, videos, and audio for use in video generation Core Video Creation rules/avatars.md - Listing avatars, avatar styles, and avatarid selection rules/voices.md - Listing voices, locales, speed/pitch configuration rules/scripts.md - Writing scripts, pauses/breaks, pacing, and structure templates rules/video-generation.md - POST /v2/video/generate workflow and multi-scene videos rules/video-agent.md - One-shot prompt video generation with Video Agent API rules/dimensions.md - Resolution options (720p/1080p) and aspect ratios Video Customization rules/backgrounds.md - Solid colors, images, and video backgrounds rules/text-overlays.md - Adding text with fonts and positioning rules/captions.md - Auto-generated captions and subtitle options Advanced Features rules/templates.md - Template listing and variable replacement rules/video-translation.md - Translating videos, quality/fast modes, and dubbing rules/streaming-avatars.md - Real-time interactive avatar sessions rules/photo-avatars.md - Creating avatars from photos (talking photos) rules/webhooks.md - Registering webhook endpoints and event types Integration rules/remotion-integration.md - Using HeyGen avatar videos in Remotion compositions
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills davila7/heygen-best-practices