Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions .agent/configs/skill-sources.json
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,17 @@
"last_checked": "2026-01-21T05:12:00Z",
"merge_strategy": "added",
"notes": "Includes 60 product reference directories in .agent/services/hosting/cloudflare-platform/references/"
},
{
"name": "heygen",
"upstream_url": "https://github.com/heygen-com/skills",
"upstream_commit": "f11988dc81a6deed557f3d547b24f73627b59ebc",
"local_path": ".agent/tools/video/heygen-skill.md",
"format_detected": "skill-md-nested",
"imported_at": "2026-01-24T12:00:00Z",
"last_checked": "2026-01-24T12:00:00Z",
"merge_strategy": "added",
"notes": "Includes 18 rule files in .agent/tools/video/heygen-skill/rules/"
}
]
}
46 changes: 46 additions & 0 deletions .agent/tools/video/heygen-skill.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
---
description: "Best practices for HeyGen - AI avatar video creation API"
mode: subagent
imported_from: https://github.com/heygen-com/skills
---

# HeyGen Skill

Best practices for HeyGen - AI avatar video creation API.

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

Check notice on line 19 in .agent/tools/video/heygen-skill.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.agent/tools/video/heygen-skill.md#L19

Expected: 1; Actual: 0; Below
- [heygen-skill/rules/authentication.md](heygen-skill/rules/authentication.md) - API key setup, X-Api-Key header, and authentication patterns
- [heygen-skill/rules/quota.md](heygen-skill/rules/quota.md) - Credit system, usage limits, and checking remaining quota
- [heygen-skill/rules/video-status.md](heygen-skill/rules/video-status.md) - Polling patterns, status types, and retrieving download URLs
- [heygen-skill/rules/assets.md](heygen-skill/rules/assets.md) - Uploading images, videos, and audio for use in video generation

### Core Video Creation

Check notice on line 25 in .agent/tools/video/heygen-skill.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.agent/tools/video/heygen-skill.md#L25

Expected: 1; Actual: 0; Below
- [heygen-skill/rules/avatars.md](heygen-skill/rules/avatars.md) - Listing avatars, avatar styles, and avatar_id selection
- [heygen-skill/rules/voices.md](heygen-skill/rules/voices.md) - Listing voices, locales, speed/pitch configuration
- [heygen-skill/rules/scripts.md](heygen-skill/rules/scripts.md) - Writing scripts, pauses/breaks, pacing, and structure templates
- [heygen-skill/rules/video-generation.md](heygen-skill/rules/video-generation.md) - POST /v2/video/generate workflow and multi-scene videos
- [heygen-skill/rules/video-agent.md](heygen-skill/rules/video-agent.md) - One-shot prompt video generation with Video Agent API
- [heygen-skill/rules/dimensions.md](heygen-skill/rules/dimensions.md) - Resolution options (720p/1080p) and aspect ratios

### Video Customization

Check notice on line 33 in .agent/tools/video/heygen-skill.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.agent/tools/video/heygen-skill.md#L33

Expected: 1; Actual: 0; Below
- [heygen-skill/rules/backgrounds.md](heygen-skill/rules/backgrounds.md) - Solid colors, images, and video backgrounds
- [heygen-skill/rules/text-overlays.md](heygen-skill/rules/text-overlays.md) - Adding text with fonts and positioning
- [heygen-skill/rules/captions.md](heygen-skill/rules/captions.md) - Auto-generated captions and subtitle options

### Advanced Features

Check notice on line 38 in .agent/tools/video/heygen-skill.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.agent/tools/video/heygen-skill.md#L38

Expected: 1; Actual: 0; Below
- [heygen-skill/rules/templates.md](heygen-skill/rules/templates.md) - Template listing and variable replacement
- [heygen-skill/rules/video-translation.md](heygen-skill/rules/video-translation.md) - Translating videos, quality/fast modes, and dubbing
- [heygen-skill/rules/streaming-avatars.md](heygen-skill/rules/streaming-avatars.md) - Real-time interactive avatar sessions
- [heygen-skill/rules/photo-avatars.md](heygen-skill/rules/photo-avatars.md) - Creating avatars from photos (talking photos)
- [heygen-skill/rules/webhooks.md](heygen-skill/rules/webhooks.md) - Registering webhook endpoints and event types

### Integration

Check notice on line 45 in .agent/tools/video/heygen-skill.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

.agent/tools/video/heygen-skill.md#L45

Expected: 1; Actual: 0; Below
Comment on lines +19 to +45
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Add blank lines around section headings (MD022).

Static analysis flags missing blank lines before/after the section headings (“Foundation”, “Core Video Creation”, “Video Customization”, “Advanced Features”, “Integration”). Please insert a blank line above and below each heading to satisfy markdownlint.

🧰 Tools
🪛 GitHub Check: Codacy Static Code Analysis

[notice] 19-19: .agent/tools/video/heygen-skill.md#L19
Expected: 1; Actual: 0; Below


[notice] 25-25: .agent/tools/video/heygen-skill.md#L25
Expected: 1; Actual: 0; Below


[notice] 33-33: .agent/tools/video/heygen-skill.md#L33
Expected: 1; Actual: 0; Below


[notice] 38-38: .agent/tools/video/heygen-skill.md#L38
Expected: 1; Actual: 0; Below


[notice] 45-45: .agent/tools/video/heygen-skill.md#L45
Expected: 1; Actual: 0; Below

🪛 markdownlint-cli2 (0.18.1)

19-19: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below

(MD022, blanks-around-headings)


25-25: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below

(MD022, blanks-around-headings)


33-33: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below

(MD022, blanks-around-headings)


38-38: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below

(MD022, blanks-around-headings)


45-45: Headings should be surrounded by blank lines
Expected: 1; Actual: 0; Below

(MD022, blanks-around-headings)

🤖 Prompt for AI Agents
In @.agent/tools/video/heygen-skill.md around lines 19 - 45, The markdown
headings (Foundation, Core Video Creation, Video Customization, Advanced
Features, Integration) lack blank lines before and after them causing MD022
failures; update the .agent/tools/video/heygen-skill.md file to ensure there is
an empty line above and below each of those section headings (e.g., add a blank
line before "### Foundation" and one after it, and do the same for "### Core
Video Creation", "### Video Customization", "### Advanced Features", and "###
Integration") so each heading is separated by a single blank line from
surrounding content.

- [heygen-skill/rules/remotion-integration.md](heygen-skill/rules/remotion-integration.md) - Using HeyGen avatar videos in Remotion compositions
Loading