About heygen-best-practices
heygen-best-practices is a skill for working with HeyGen API code. It organizes guidance and examples for avatar video creation, customization, translation, streaming, and service integration.
Key features
- 01Configure API authentication and quota checks
- 02Create videos with avatars, voices, and scripts
- 03Customize backgrounds, text, and captions
- 04Use templates and video translation
- 05Handle streaming avatars and webhooks
- 06Integrate HeyGen videos with Remotion
Use cases
- 01Implement HeyGen API authentication and usage checks
- 02Build multi-scene avatar video generation
- 03Customize video captions and backgrounds
- 04Add HeyGen avatar videos to Remotion compositions
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/heygen-best-practicesin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
rules/assets.mdauthentication.mdavatars.mdbackgrounds.mdcaptions.mddimensions.mdphoto-avatars.mdquota.mdremotion-integration.mdscripts.mdstreaming-avatars.mdtemplates.mdtext-overlays.mdvideo-agent.mdvideo-generation.mdvideo-status.mdvideo-translation.mdvoices.mdwebhooks.mdDetails
From the project READMEWhen 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
Comments
Markdown supported