Heygen Best Practices
Best practices for HeyGen - AI avatar video creation API
npx claude-code-templates@latest --skill development/heygen-best-practices Scanned by NVIDIA SkillSpector
Automated static analysis (no LLM) · v2.12.0 · 2026-10-17
Partial analysis: some checks could not run on this component.
SkillSpector looks for patterns such as shell commands, credential access, network calls or unpinned dependencies. An observation is something worth reading in the files before you install, not a confirmed vulnerability. Components that run code locally, like hooks, MCP servers and security tooling, naturally show more of them.
- YARA rule 'agent_skill_credential_exfiltration_webhook': AI agent skill credential harvesting followed by webhook or external exfiltration [agent_skills]YARA Match · rules/webhooks.md:188
- Incomplete referenced artifact analysis ×9analysis-evasion · SKILL.md:17
- External Transmission ×9Data Exfiltration · rules/assets.md:77
- External Transmission ×18Data Exfiltration · rules/streaming-avatars.md:99
- External Transmission ×10Data Exfiltration · rules/templates.md:225
Showing 47 of 149 observations. Learn more about NVIDIA SkillSpector.
Content
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 avatar_id 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