avatar-video
installsforks
How to install avatar-video?
calesthio/openmontage/avatar-video
$npx -y skills add calesthio/OpenMontage --skill avatar-videoCreate AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with differ
SKILL.md
| 1 | # Avatar Video |
| 2 | |
| 3 | Create AI avatar videos with full control over avatars, voices, scripts, scenes, and backgrounds. Build single or multi-scene videos with exact configuration using HeyGen's `/v2/video/generate` API. |
| 4 | |
| 5 | ## Authentication |
| 6 | |
| 7 | All requests require the `X-Api-Key` header. Set the `HEYGEN_API_KEY` environment variable. |
| 8 | |
| 9 | ```bash |
| 10 | curl -X GET "https://api.heygen.com/v2/avatars" \ |
| 11 | -H "X-Api-Key: $HEYGEN_API_KEY" |
| 12 | ``` |
| 13 | |
| 14 | ## Tool Selection |
| 15 | |
| 16 | If HeyGen MCP tools are available (`mcp__heygen__*`), **prefer them** over direct HTTP API calls — they handle authentication and request formatting automatically. |
| 17 | |
| 18 | | Task | MCP Tool | Fallback (Direct API) | |
| 19 | |------|----------|----------------------| |
| 20 | | Check video status / get URL | `mcp__heygen__get_video` | `GET /v2/videos/{video_id}` | |
| 21 | | List account videos | `mcp__heygen__list_videos` | `GET /v2/videos` | |
| 22 | | Delete a video | `mcp__heygen__delete_video` | `DELETE /v2/videos/{video_id}` | |
| 23 | |
| 24 | Video generation (`POST /v2/video/generate`) and avatar/voice listing are done via direct API calls — see reference files below. |
| 25 | |
| 26 | ## Default Workflow |
| 27 | |
| 28 | 1. **List avatars** — `GET /v2/avatars` → pick an avatar, preview it, note `avatar_id` and `default_voice_id`. See [avatars.md](references/avatars.md) |
| 29 | 2. **List voices** (if needed) — `GET /v2/voices` → pick a voice matching the avatar's gender/language. See [voices.md](references/voices.md) |
| 30 | 3. **Write the script** — Structure scenes with one concept each. See [scripts.md](references/scripts.md) |
| 31 | 4. **Generate the video** — `POST /v2/video/generate` with avatar, voice, script, and background per scene. See [video-generation.md](references/video-generation.md) |
| 32 | 5. **Poll for completion** — `GET /v2/videos/{video_id}` until status is `completed`. See [video-status.md](references/video-status.md) |
| 33 | |
| 34 | ## Quick Reference |
| 35 | |
| 36 | | Task | Read | |
| 37 | |------|------| |
| 38 | | List and preview avatars | [avatars.md](references/avatars.md) | |
| 39 | | List and select voices | [voices.md](references/voices.md) | |
| 40 | | Write and structure scripts | [scripts.md](references/scripts.md) | |
| 41 | | Generate video (single or multi-scene) | [video-generation.md](references/video-generation.md) | |
| 42 | | Add custom backgrounds | [backgrounds.md](references/backgrounds.md) | |
| 43 | | Add captions / subtitles | [captions.md](references/captions.md) | |
| 44 | | Add text overlays | [text-overlays.md](references/text-overlays.md) | |
| 45 | | Create transparent WebM video | [video-generation.md](references/video-generation.md) (WebM section) | |
| 46 | | Use templates | [templates.md](references/templates.md) | |
| 47 | | Create avatar from photo | [photo-avatars.md](references/photo-avatars.md) | |
| 48 | | Check video status / download | [video-status.md](references/video-status.md) | |
| 49 | | Upload assets (images, audio) | [assets.md](references/assets.md) | |
| 50 | | Use with Remotion | [remotion-integration.md](references/remotion-integration.md) | |
| 51 | | Set up webhooks | [webhooks.md](references/webhooks.md) | |
| 52 | |
| 53 | ## When to Use This Skill vs Create Video |
| 54 | |
| 55 | This skill is for **precise control** — you choose the avatar, write the exact script, configure each scene. |
| 56 | |
| 57 | If the user just wants to **describe a video idea** and let AI handle the rest (script, avatar, visuals), use the **create-video** skill instead. |
| 58 | |
| 59 | | User Says | Create Video Skill | This Skill | |
| 60 | |-----------|:------------------:|:----------:| |
| 61 | | "Make me a video about X" | ✓ | | |
| 62 | | "Create a product demo" | ✓ | | |
| 63 | | "I want avatar Y to say exactly Z" | | ✓ | |
| 64 | | "Multi-scene video with different backgrounds" | | ✓ | |
| 65 | | "Transparent WebM for compositing" | | ✓ | |
| 66 | | "Use this specific voice for my script" | | ✓ | |
| 67 | | "Batch generate videos with exact specs" | | ✓ | |
| 68 | |
| 69 | ## Reference Files |
| 70 | |
| 71 | ### Core Video Creation |
| 72 | - [references/avatars.md](references/avatars.md) - Listing avatars, styles, avatar_id selection |
| 73 | - [references/voices.md](references/voices.md) - Listing voices, locales, speed/pitch |
| 74 | - [references/scripts.md](references/scripts.md) - Writing scripts, pauses, pacing |
| 75 | - [references/video-generation.md](references/video-generation.md) - POST /v2/video/generate and multi-scene videos |
| 76 | |
| 77 | ### Video Customization |
| 78 | - [references/backgrounds.md](references/backgrounds.md) - Solid colors, images, video backgrounds |
| 79 | - [references/text-overlays.md](refere |
People who liked this also viewed
6 picksType
- ai-video-generationinference.sh Agent skills for using our API to give your agents access to hundreds of apps and other agentsSkillsJul 2026
- imagegen-frontend-webElite frontend image-direction skill for generating premium, conversion-aware website design references. CRITICAL OUTPUT RULE — generate ONE separate horizontal image FOR EVERY section. A landing pageSkillsJul 2026
- hyperframes-mediaWrite HTML. Render video. Built for agents.SkillsJul 2026
- media-useAgent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + leSkillsJul 2026
- general-videoAuthor or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, staticSkillsJul 2026
- product-launch-videoTurn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market,SkillsJul 2026
