heygen-best-practices

davila7/claude-code-templates · cli-tool/components/skills/development/heygen-best-practices/SKILL.md

Best practices for HeyGen - AI avatar video creation API

Software EngineeringNo license★ 33156⑂ 3873commit 5cc17cf

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 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

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/heygen-best-practices · pinned to the source commit

# Run from your project root
git clone https://github.com/davila7/claude-code-templates.git .skillboard-tmp
git -C .skillboard-tmp checkout 5cc17cf267132cc690dee82239b80a99ec82e4f8
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/cli-tool/components/skills/development/heygen-best-practices" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/davila7/claude-code-templates.git .skillboard-tmp
git -C .skillboard-tmp checkout 5cc17cf267132cc690dee82239b80a99ec82e4f8
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/cli-tool/components/skills/development/heygen-best-practices" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/heygen-best-practices

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so heygen-best-practices is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit 5cc17cf26713. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

highCredential or secret access
References credentials, tokens or secret files that a skill should not need.
Evidence: [redacted]· fingerprint 0d20c6192eec505b

heygen-best-practices

davila7/claude-code-templates · cli-tool/components/skills/development/heygen-best-practices/SKILL.md

Best practices for HeyGen - AI avatar video creation API

Software EngineeringNo license★ 33156⑂ 3873commit 5cc17cf

Install skillView source on GitHub

What this skill does

When to use

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

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/heygen-best-practices · pinned to the source commit

# Run from your project root
git clone https://github.com/davila7/claude-code-templates.git .skillboard-tmp
git -C .skillboard-tmp checkout 5cc17cf267132cc690dee82239b80a99ec82e4f8
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/cli-tool/components/skills/development/heygen-best-practices" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# Run from your project root
git clone https://github.com/davila7/claude-code-templates.git .skillboard-tmp
git -C .skillboard-tmp checkout 5cc17cf267132cc690dee82239b80a99ec82e4f8
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/cli-tool/components/skills/development/heygen-best-practices" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/heygen-best-practices

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so heygen-best-practices is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

Scanner static-checks@0.1.0 · commit 5cc17cf26713. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.

highCredential or secret access
References credentials, tokens or secret files that a skill should not need.
Evidence: [redacted]· fingerprint 0d20c6192eec505b

heygen-best-practices

What this skill does

When to use

How to use

Foundation

Core Video Creation

Video Customization

Advanced Features

Integration

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits

heygen-best-practices

What this skill does

When to use

How to use

Foundation

Core Video Creation

Video Customization

Advanced Features

Integration

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits