Skip to content

davila7/claude-code-templates / cli-tool/components/skills/development/heygen-best-practices

heygen-best-practices

Unverified

Best practices for HeyGen - AI avatar video creation API

FileKindSize
SKILL.mdskill md2.5 KB
rules/assets.mdmarkdown8.1 KB
rules/authentication.mdmarkdown4.7 KB
rules/avatars.mdmarkdown18.3 KB
rules/backgrounds.mdmarkdown6.6 KB
rules/captions.mdmarkdown6.0 KB
rules/dimensions.mdmarkdown6.9 KB
rules/photo-avatars.mdmarkdown15.1 KB
rules/quota.mdmarkdown4.7 KB
rules/remotion-integration.mdmarkdown18.2 KB
rules/scripts.mdmarkdown10.0 KB
rules/streaming-avatars.mdmarkdown10.9 KB
rules/templates.mdmarkdown9.8 KB
rules/text-overlays.mdmarkdown6.9 KB
rules/video-agent.mdmarkdown8.9 KB
rules/video-generation.mdmarkdown20.9 KB
rules/video-status.mdmarkdown12.6 KB
rules/video-translation.mdmarkdown10.9 KB
rules/voices.mdmarkdown11.7 KB
rules/webhooks.mdmarkdown9.1 KB
---
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
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall