Creator · calesthio
Last updated · Sep 1, 2026
Create 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
Creator · calesthio
Last updated · Sep 1, 2026
Create 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
Creator · calesthio
Last updated · Sep 1, 2026
Create 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
Creator · calesthio
Last updated · Sep 1, 2026
Create 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
Sandbox only
Install targets
Codex install prompt
Install the "avatar-video" agent skill from https://github.com/calesthio/OpenMontage/tree/main/.agents/skills/avatar-video. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Create 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 different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"calesthio-avatar-video","task":"Install avatar-video","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add calesthio/OpenMontage --skill avatar-video
Maintenance
fresh
13d since push
Risk
Needs review
Dependency or permission surface needs review
GitHub quality
55K
94/100 Quality · 81/100 Trust
Coverage tags
Review notes
Dependency or permission surface needs review · Permission surface may require sandboxing
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
ExcellentHigh-confidence pick with strong adoption and healthy maintenance signals.
Trust
Sandbox onlyUseful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
Audit
Needs reviewA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Run only in a sandbox and compare close alternatives before using it for real work.
Stars
55K GitHub stars
Repo activity
55K stars, 6.9K forks
Maintenance
13d since push
License
AGPL-3.0
Install
npx skills add calesthio/OpenMontage --skill avatar-video
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add calesthio/OpenMontage --skill avatar-videoDo not use when
Alternative
1.9K Stars
npx skills add yanliudesign/mono-color-skill --skill mono-color
Alternative
61.0K Stars
npx skills add mvanhorn/last30days-skill -g
Alternative
38.4K Stars
npx skills add Imbad0202/academic-research-skills
Alternative
28.0K Stars
npx skills add assafelovic/gpt-researcher
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
high
Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/calesthio-avatar-video/install
Agent should check
Copy prompt
Task: Use avatar-video in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/calesthio-avatar-video/install
Install command: npx skills add calesthio/OpenMontage --skill avatar-video
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/calesthio-avatar-video/install
LLM text format
/api/skills/calesthio-avatar-video/install?format=text
Find alternatives
/api/skills/search?q=avatar-video&limit=3
Agent prompt
Use avatar-video for this task. Review https://www.openagentskill.com/api/skills/calesthio-avatar-video/install, then install with: npx skills add calesthio/OpenMontage --skill avatar-videoRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/calesthio-avatar-video
LLM text
/api/registry/manifest/calesthio-avatar-video?format=text
Install alias
/api/registry/install/calesthio-avatar-video
Recommend
/api/registry/recommend?task=Use%20avatar-video%20in%20an%20agent%20workflow&limit=3
Agent fit
Workflow automation
Use-case tags
Platforms
Claude Code
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
Workflow automation
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
GitHub adoption
PASS55K GitHub stars
Stars/forks activity
PASS55K stars, 6.9K forks; issue activity unavailable in current metadata
Recent maintenance
PASS13d since push
License clarity
PASSAGPL-3.0
Good signals
Review before install
Recommended action
Run only in a sandbox and compare close alternatives before using it for real work.
Quality profile
High-confidence pick with strong adoption and healthy maintenance signals.
Workflow fit
Automate repeated work
I need my agent to automate a repeated workflow across tools and files.
Process rich media
I need my agent to process images, video, or audio and extract useful information.
Plan, generate, and review video
I need my agent to turn a topic or product into a short video, generate B-roll, write video prompts, and prepare a publish-ready cut.
Workflow fit
Operate and verify web apps
A workflow for agents that navigate products, fill forms, take screenshots, and verify real user flows across web applications.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Brief to publish-ready creative
A practical workflow for agents that shape a video brief, create strong multimodal prompts, generate supporting B-roll, and prepare a reviewable short-form or explainer video.
Alternative shortlist
Similar skills that may fit this task.
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Run autonomous deep research over web and local sources
--- name: avatar-video description: | Create 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 different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control. homepage: https://docs.heygen.com/reference/create-a-video allowed-tools: mcp__heygen__* metadata: openclaw: requires: env: - HEYGEN_API_KEY primaryEnv: HEYGEN_API_KEY ---
# Avatar Video
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.
## Authentication
All requests require the `X-Api-Key` header. Set the `HEYGEN_API_KEY` environment variable.
```bash curl -X GET "https://api.heygen.com/v2/avatars" \ -H "X-Api-Key: $HEYGEN_API_KEY" ```
## Tool Selection
If HeyGen MCP tools are available (`mcp__heygen__*`), **prefer them** over direct HTTP API calls — they handle authentication and request formatting automatically.
| Task | MCP Tool | Fallback (Direct API) | |------|----------|----------------------| | Check video status / get URL | `mcp__heygen__get_video` | `GET /v2/videos/{video_id}` | | List account videos | `mcp__heygen__list_videos` | `GET /v2/videos` | | Delete a video | `mcp__heygen__delete_video` | `DELETE /v2/videos/{video_id}` |
Video generation (`POST /v2/video/generate`) and avatar/voice listing are done via direct API calls — see reference files below.
## Default Workflow
1. **List avatars** — `GET /v2/avatars` → pick an avatar, preview it, note `avatar_id` and `default_voice_id`. See [avatars.md](references/avatars.md) 2. **List voices** (if needed) — `GET /v2/voices` → pick a voice matching the avatar's gender/language. See [voices.md](references/voices.md) 3. **Write the script** — Structure scenes with one concept each. See [scripts.md](references/scripts.md) 4. **Generate the video** — `POST /v2/video/generate` with avatar, voice, script, and background per scene. See [video-generation.md](references/video-generation.md) 5. **Poll for completion** — `GET /v2/videos/{video_id}` until status is `completed`. See [video-status.md](references/video-status.md)
## Quick Reference
| Task | Read | |------|------| | List and preview avatars | [avatars.md](references/avatars.md) | | List and select voices | [voices.md](references/voices.md) | | Write and structure scripts | [scripts.md](references/scripts.md) | | Generate video (single or multi-scene) | [video-generation.md](references/video-generation.md) | | Add custom backgrounds | [backgrounds.md](references/backgrounds.md) | | Add captions / subtitles | [captions.md](references/captions.md) | | Add text overlays | [text-overlays.md](references/text-overlays.md) | | Create transparent WebM video | [video-generation.md](references/video-generation.md) (WebM section) | | Use templates | [templates.md](references/templates.md) | | Create avatar from photo | [photo-avatars.md](references/photo-avatars.md) | | Check video status / download | [video-status.md](references/video-status.md) | | Upload assets (images, audio) | [assets.md](references/assets.md) | | Use with Remotion | [remotion-integration.md](references/remotion-integration.md) | | Set up webhooks | [webhooks.md](references/webhooks.md) |
## When to Use This Skill vs Create Video
This skill is for **precise control** — you choose the avatar, write the exact script, configure each scene.
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.
| User Says | Create Video Skill | This Skill | |-----------|:------------------:|:----------:| | "Make me a video about X" | ✓ | | | "Create a product demo" | ✓ | | | "I want avatar Y to say exactly Z" | | ✓ | | "Multi-scene video with different backgrounds" | | ✓ | | "Transparent WebM for compositing" | | ✓ | | "Use this specific voice for my script" | | ✓ | | "Batch generate videos with exact specs" | | ✓ |
## Reference Files
### Core Video Creation - [references/avatars.md](references/avatars.md) - Listing avatars, styles, avatar_id selection - [references/voices.md](references/voices.md) - Listing voices, locales, speed/pitch - [references/scripts.md](references/scripts.md) - Writing scripts, pauses, pacing - [references/video-generation.md](references/video-generation.md) - POST /v2/video/generate and multi-scene videos
### Video Customization - [references/backgrounds.md](references/backgrounds.md) - Solid colors, images, video backgrounds - [references/text-overlays.md](references/text-overlays.md) - Adding text with fonts and positioning - [references/captions.md](references/captions.md) - Auto-generated captions and subtitles
### Advanced Features - [references/templates.md](references/templates.md) - Template listing and variable replacement - [references/photo-avatars.md](references/photo-avatars.md) - Creating avatars from photos - [references/webhooks.md](references/webhooks.md) - Webhook endpoints and events
### Integration - [references/remotion-integration.md](references/remotion-integration.md) - Using HeyGen in Remotion compositions
### Foundation - [references/video-status.md](references/video-status.md) - Polling patterns and download URLs - [references/assets.md](references/assets.md) - Uploading images, videos, audio - [references/dimensions.md](references/dimensions.md) - Resolution and aspect ratios - [references/quota.md](references/quota.md) - Credit system and usage limits
## Best Practices
1. **Preview avatars before generating** — Download `preview_image_url` so the user can see the avatar before committing 2. **Use avatar's default voice** — Most avatars have a `default_voice_id` pre-matched for natural results 3. **Fallback: match gender manually** — If no default voice, ensure avatar and voice genders match 4. **Use test mode for development** — Set `test: true` to avoid consuming credits (output will be watermarked) 5. **Set generous timeouts** — Video generation often takes 5-15 minutes, sometimes longer 6. **Validate inputs** — Check avatar and voice IDs exist before generating
Source provenance
Decision snapshot
55,322 GitHub stars
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for avatar-video, ready for a manual X post.
avatar-video: Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backg... 55.3K stars https://www.openagentskill.com/skills/calesthio-avatar-video?ref=x
Listing + install path for avatar-video: https://www.openagentskill.com/skills/calesthio-avatar-video?ref=x Install: npx skills add calesthio/OpenMontage --skill avatar-video
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to calesthio but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/calesthio-avatar-video/audit)
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)calesthio
@calesthio
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Sandbox only
mono-color
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
1.9K StarsLast30days Skill
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
61.0K StarsAcademic Research Skills
Academic Research Skills for Claude Code: research → write → review → revise → finalize
38.4K StarsGPT Researcher
Run autonomous deep research over web and local sources
28.0K StarsSandbox only
Install targets
Codex install prompt
Install the "avatar-video" agent skill from https://github.com/calesthio/OpenMontage/tree/main/.agents/skills/avatar-video. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Create 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 different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"calesthio-avatar-video","task":"Install avatar-video","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add calesthio/OpenMontage --skill avatar-video
Maintenance
fresh
13d since push
Risk
Needs review
Dependency or permission surface needs review
GitHub quality
55K
94/100 Quality · 81/100 Trust
Coverage tags
Review notes
Dependency or permission surface needs review · Permission surface may require sandboxing
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
ExcellentHigh-confidence pick with strong adoption and healthy maintenance signals.
Trust
Sandbox onlyUseful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
Audit
Needs reviewA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Run only in a sandbox and compare close alternatives before using it for real work.
Stars
55K GitHub stars
Repo activity
55K stars, 6.9K forks
Maintenance
13d since push
License
AGPL-3.0
Install
npx skills add calesthio/OpenMontage --skill avatar-video
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add calesthio/OpenMontage --skill avatar-videoDo not use when
Alternative
1.9K Stars
npx skills add yanliudesign/mono-color-skill --skill mono-color
Alternative
61.0K Stars
npx skills add mvanhorn/last30days-skill -g
Alternative
38.4K Stars
npx skills add Imbad0202/academic-research-skills
Alternative
28.0K Stars
npx skills add assafelovic/gpt-researcher
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
high
Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/calesthio-avatar-video/install
Agent should check
Copy prompt
Task: Use avatar-video in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/calesthio-avatar-video/install
Install command: npx skills add calesthio/OpenMontage --skill avatar-video
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/calesthio-avatar-video/install
LLM text format
/api/skills/calesthio-avatar-video/install?format=text
Find alternatives
/api/skills/search?q=avatar-video&limit=3
Agent prompt
Use avatar-video for this task. Review https://www.openagentskill.com/api/skills/calesthio-avatar-video/install, then install with: npx skills add calesthio/OpenMontage --skill avatar-videoRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/calesthio-avatar-video
LLM text
/api/registry/manifest/calesthio-avatar-video?format=text
Install alias
/api/registry/install/calesthio-avatar-video
Recommend
/api/registry/recommend?task=Use%20avatar-video%20in%20an%20agent%20workflow&limit=3
Agent fit
Workflow automation
Use-case tags
Platforms
Claude Code
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
Workflow automation
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
GitHub adoption
PASS55K GitHub stars
Stars/forks activity
PASS55K stars, 6.9K forks; issue activity unavailable in current metadata
Recent maintenance
PASS13d since push
License clarity
PASSAGPL-3.0
Good signals
Review before install
Recommended action
Run only in a sandbox and compare close alternatives before using it for real work.
Quality profile
High-confidence pick with strong adoption and healthy maintenance signals.
Workflow fit
Automate repeated work
I need my agent to automate a repeated workflow across tools and files.
Process rich media
I need my agent to process images, video, or audio and extract useful information.
Plan, generate, and review video
I need my agent to turn a topic or product into a short video, generate B-roll, write video prompts, and prepare a publish-ready cut.
Workflow fit
Operate and verify web apps
A workflow for agents that navigate products, fill forms, take screenshots, and verify real user flows across web applications.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Brief to publish-ready creative
A practical workflow for agents that shape a video brief, create strong multimodal prompts, generate supporting B-roll, and prepare a reviewable short-form or explainer video.
Alternative shortlist
Similar skills that may fit this task.
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Run autonomous deep research over web and local sources
--- name: avatar-video description: | Create 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 different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control. homepage: https://docs.heygen.com/reference/create-a-video allowed-tools: mcp__heygen__* metadata: openclaw: requires: env: - HEYGEN_API_KEY primaryEnv: HEYGEN_API_KEY ---
# Avatar Video
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.
## Authentication
All requests require the `X-Api-Key` header. Set the `HEYGEN_API_KEY` environment variable.
```bash curl -X GET "https://api.heygen.com/v2/avatars" \ -H "X-Api-Key: $HEYGEN_API_KEY" ```
## Tool Selection
If HeyGen MCP tools are available (`mcp__heygen__*`), **prefer them** over direct HTTP API calls — they handle authentication and request formatting automatically.
| Task | MCP Tool | Fallback (Direct API) | |------|----------|----------------------| | Check video status / get URL | `mcp__heygen__get_video` | `GET /v2/videos/{video_id}` | | List account videos | `mcp__heygen__list_videos` | `GET /v2/videos` | | Delete a video | `mcp__heygen__delete_video` | `DELETE /v2/videos/{video_id}` |
Video generation (`POST /v2/video/generate`) and avatar/voice listing are done via direct API calls — see reference files below.
## Default Workflow
1. **List avatars** — `GET /v2/avatars` → pick an avatar, preview it, note `avatar_id` and `default_voice_id`. See [avatars.md](references/avatars.md) 2. **List voices** (if needed) — `GET /v2/voices` → pick a voice matching the avatar's gender/language. See [voices.md](references/voices.md) 3. **Write the script** — Structure scenes with one concept each. See [scripts.md](references/scripts.md) 4. **Generate the video** — `POST /v2/video/generate` with avatar, voice, script, and background per scene. See [video-generation.md](references/video-generation.md) 5. **Poll for completion** — `GET /v2/videos/{video_id}` until status is `completed`. See [video-status.md](references/video-status.md)
## Quick Reference
| Task | Read | |------|------| | List and preview avatars | [avatars.md](references/avatars.md) | | List and select voices | [voices.md](references/voices.md) | | Write and structure scripts | [scripts.md](references/scripts.md) | | Generate video (single or multi-scene) | [video-generation.md](references/video-generation.md) | | Add custom backgrounds | [backgrounds.md](references/backgrounds.md) | | Add captions / subtitles | [captions.md](references/captions.md) | | Add text overlays | [text-overlays.md](references/text-overlays.md) | | Create transparent WebM video | [video-generation.md](references/video-generation.md) (WebM section) | | Use templates | [templates.md](references/templates.md) | | Create avatar from photo | [photo-avatars.md](references/photo-avatars.md) | | Check video status / download | [video-status.md](references/video-status.md) | | Upload assets (images, audio) | [assets.md](references/assets.md) | | Use with Remotion | [remotion-integration.md](references/remotion-integration.md) | | Set up webhooks | [webhooks.md](references/webhooks.md) |
## When to Use This Skill vs Create Video
This skill is for **precise control** — you choose the avatar, write the exact script, configure each scene.
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.
| User Says | Create Video Skill | This Skill | |-----------|:------------------:|:----------:| | "Make me a video about X" | ✓ | | | "Create a product demo" | ✓ | | | "I want avatar Y to say exactly Z" | | ✓ | | "Multi-scene video with different backgrounds" | | ✓ | | "Transparent WebM for compositing" | | ✓ | | "Use this specific voice for my script" | | ✓ | | "Batch generate videos with exact specs" | | ✓ |
## Reference Files
### Core Video Creation - [references/avatars.md](references/avatars.md) - Listing avatars, styles, avatar_id selection - [references/voices.md](references/voices.md) - Listing voices, locales, speed/pitch - [references/scripts.md](references/scripts.md) - Writing scripts, pauses, pacing - [references/video-generation.md](references/video-generation.md) - POST /v2/video/generate and multi-scene videos
### Video Customization - [references/backgrounds.md](references/backgrounds.md) - Solid colors, images, video backgrounds - [references/text-overlays.md](references/text-overlays.md) - Adding text with fonts and positioning - [references/captions.md](references/captions.md) - Auto-generated captions and subtitles
### Advanced Features - [references/templates.md](references/templates.md) - Template listing and variable replacement - [references/photo-avatars.md](references/photo-avatars.md) - Creating avatars from photos - [references/webhooks.md](references/webhooks.md) - Webhook endpoints and events
### Integration - [references/remotion-integration.md](references/remotion-integration.md) - Using HeyGen in Remotion compositions
### Foundation - [references/video-status.md](references/video-status.md) - Polling patterns and download URLs - [references/assets.md](references/assets.md) - Uploading images, videos, audio - [references/dimensions.md](references/dimensions.md) - Resolution and aspect ratios - [references/quota.md](references/quota.md) - Credit system and usage limits
## Best Practices
1. **Preview avatars before generating** — Download `preview_image_url` so the user can see the avatar before committing 2. **Use avatar's default voice** — Most avatars have a `default_voice_id` pre-matched for natural results 3. **Fallback: match gender manually** — If no default voice, ensure avatar and voice genders match 4. **Use test mode for development** — Set `test: true` to avoid consuming credits (output will be watermarked) 5. **Set generous timeouts** — Video generation often takes 5-15 minutes, sometimes longer 6. **Validate inputs** — Check avatar and voice IDs exist before generating
Source provenance
Decision snapshot
55,322 GitHub stars
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for avatar-video, ready for a manual X post.
avatar-video: Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backg... 55.3K stars https://www.openagentskill.com/skills/calesthio-avatar-video?ref=x
Listing + install path for avatar-video: https://www.openagentskill.com/skills/calesthio-avatar-video?ref=x Install: npx skills add calesthio/OpenMontage --skill avatar-video
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to calesthio but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/calesthio-avatar-video/audit)
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)calesthio
@calesthio
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Sandbox only
mono-color
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
1.9K StarsLast30days Skill
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
61.0K StarsAcademic Research Skills
Academic Research Skills for Claude Code: research → write → review → revise → finalize
38.4K StarsGPT Researcher
Run autonomous deep research over web and local sources
28.0K StarsSandbox only
Install targets
Codex install prompt
Install the "avatar-video" agent skill from https://github.com/calesthio/OpenMontage/tree/main/.agents/skills/avatar-video. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Create 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 different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"calesthio-avatar-video","task":"Install avatar-video","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add calesthio/OpenMontage --skill avatar-video
Maintenance
fresh
13d since push
Risk
Needs review
Dependency or permission surface needs review
GitHub quality
55K
94/100 Quality · 81/100 Trust
Coverage tags
Review notes
Dependency or permission surface needs review · Permission surface may require sandboxing
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
ExcellentHigh-confidence pick with strong adoption and healthy maintenance signals.
Trust
Sandbox onlyUseful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
Audit
Needs reviewA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Run only in a sandbox and compare close alternatives before using it for real work.
Stars
55K GitHub stars
Repo activity
55K stars, 6.9K forks
Maintenance
13d since push
License
AGPL-3.0
Install
npx skills add calesthio/OpenMontage --skill avatar-video
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add calesthio/OpenMontage --skill avatar-videoDo not use when
Alternative
1.9K Stars
npx skills add yanliudesign/mono-color-skill --skill mono-color
Alternative
61.0K Stars
npx skills add mvanhorn/last30days-skill -g
Alternative
38.4K Stars
npx skills add Imbad0202/academic-research-skills
Alternative
28.0K Stars
npx skills add assafelovic/gpt-researcher
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
high
Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/calesthio-avatar-video/install
Agent should check
Copy prompt
Task: Use avatar-video in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/calesthio-avatar-video/install
Install command: npx skills add calesthio/OpenMontage --skill avatar-video
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/calesthio-avatar-video/install
LLM text format
/api/skills/calesthio-avatar-video/install?format=text
Find alternatives
/api/skills/search?q=avatar-video&limit=3
Agent prompt
Use avatar-video for this task. Review https://www.openagentskill.com/api/skills/calesthio-avatar-video/install, then install with: npx skills add calesthio/OpenMontage --skill avatar-videoRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/calesthio-avatar-video
LLM text
/api/registry/manifest/calesthio-avatar-video?format=text
Install alias
/api/registry/install/calesthio-avatar-video
Recommend
/api/registry/recommend?task=Use%20avatar-video%20in%20an%20agent%20workflow&limit=3
Agent fit
Workflow automation
Use-case tags
Platforms
Claude Code
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
Workflow automation
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
GitHub adoption
PASS55K GitHub stars
Stars/forks activity
PASS55K stars, 6.9K forks; issue activity unavailable in current metadata
Recent maintenance
PASS13d since push
License clarity
PASSAGPL-3.0
Good signals
Review before install
Recommended action
Run only in a sandbox and compare close alternatives before using it for real work.
Quality profile
High-confidence pick with strong adoption and healthy maintenance signals.
Workflow fit
Automate repeated work
I need my agent to automate a repeated workflow across tools and files.
Process rich media
I need my agent to process images, video, or audio and extract useful information.
Plan, generate, and review video
I need my agent to turn a topic or product into a short video, generate B-roll, write video prompts, and prepare a publish-ready cut.
Workflow fit
Operate and verify web apps
A workflow for agents that navigate products, fill forms, take screenshots, and verify real user flows across web applications.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Brief to publish-ready creative
A practical workflow for agents that shape a video brief, create strong multimodal prompts, generate supporting B-roll, and prepare a reviewable short-form or explainer video.
Alternative shortlist
Similar skills that may fit this task.
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Run autonomous deep research over web and local sources
--- name: avatar-video description: | Create 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 different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control. homepage: https://docs.heygen.com/reference/create-a-video allowed-tools: mcp__heygen__* metadata: openclaw: requires: env: - HEYGEN_API_KEY primaryEnv: HEYGEN_API_KEY ---
# Avatar Video
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.
## Authentication
All requests require the `X-Api-Key` header. Set the `HEYGEN_API_KEY` environment variable.
```bash curl -X GET "https://api.heygen.com/v2/avatars" \ -H "X-Api-Key: $HEYGEN_API_KEY" ```
## Tool Selection
If HeyGen MCP tools are available (`mcp__heygen__*`), **prefer them** over direct HTTP API calls — they handle authentication and request formatting automatically.
| Task | MCP Tool | Fallback (Direct API) | |------|----------|----------------------| | Check video status / get URL | `mcp__heygen__get_video` | `GET /v2/videos/{video_id}` | | List account videos | `mcp__heygen__list_videos` | `GET /v2/videos` | | Delete a video | `mcp__heygen__delete_video` | `DELETE /v2/videos/{video_id}` |
Video generation (`POST /v2/video/generate`) and avatar/voice listing are done via direct API calls — see reference files below.
## Default Workflow
1. **List avatars** — `GET /v2/avatars` → pick an avatar, preview it, note `avatar_id` and `default_voice_id`. See [avatars.md](references/avatars.md) 2. **List voices** (if needed) — `GET /v2/voices` → pick a voice matching the avatar's gender/language. See [voices.md](references/voices.md) 3. **Write the script** — Structure scenes with one concept each. See [scripts.md](references/scripts.md) 4. **Generate the video** — `POST /v2/video/generate` with avatar, voice, script, and background per scene. See [video-generation.md](references/video-generation.md) 5. **Poll for completion** — `GET /v2/videos/{video_id}` until status is `completed`. See [video-status.md](references/video-status.md)
## Quick Reference
| Task | Read | |------|------| | List and preview avatars | [avatars.md](references/avatars.md) | | List and select voices | [voices.md](references/voices.md) | | Write and structure scripts | [scripts.md](references/scripts.md) | | Generate video (single or multi-scene) | [video-generation.md](references/video-generation.md) | | Add custom backgrounds | [backgrounds.md](references/backgrounds.md) | | Add captions / subtitles | [captions.md](references/captions.md) | | Add text overlays | [text-overlays.md](references/text-overlays.md) | | Create transparent WebM video | [video-generation.md](references/video-generation.md) (WebM section) | | Use templates | [templates.md](references/templates.md) | | Create avatar from photo | [photo-avatars.md](references/photo-avatars.md) | | Check video status / download | [video-status.md](references/video-status.md) | | Upload assets (images, audio) | [assets.md](references/assets.md) | | Use with Remotion | [remotion-integration.md](references/remotion-integration.md) | | Set up webhooks | [webhooks.md](references/webhooks.md) |
## When to Use This Skill vs Create Video
This skill is for **precise control** — you choose the avatar, write the exact script, configure each scene.
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.
| User Says | Create Video Skill | This Skill | |-----------|:------------------:|:----------:| | "Make me a video about X" | ✓ | | | "Create a product demo" | ✓ | | | "I want avatar Y to say exactly Z" | | ✓ | | "Multi-scene video with different backgrounds" | | ✓ | | "Transparent WebM for compositing" | | ✓ | | "Use this specific voice for my script" | | ✓ | | "Batch generate videos with exact specs" | | ✓ |
## Reference Files
### Core Video Creation - [references/avatars.md](references/avatars.md) - Listing avatars, styles, avatar_id selection - [references/voices.md](references/voices.md) - Listing voices, locales, speed/pitch - [references/scripts.md](references/scripts.md) - Writing scripts, pauses, pacing - [references/video-generation.md](references/video-generation.md) - POST /v2/video/generate and multi-scene videos
### Video Customization - [references/backgrounds.md](references/backgrounds.md) - Solid colors, images, video backgrounds - [references/text-overlays.md](references/text-overlays.md) - Adding text with fonts and positioning - [references/captions.md](references/captions.md) - Auto-generated captions and subtitles
### Advanced Features - [references/templates.md](references/templates.md) - Template listing and variable replacement - [references/photo-avatars.md](references/photo-avatars.md) - Creating avatars from photos - [references/webhooks.md](references/webhooks.md) - Webhook endpoints and events
### Integration - [references/remotion-integration.md](references/remotion-integration.md) - Using HeyGen in Remotion compositions
### Foundation - [references/video-status.md](references/video-status.md) - Polling patterns and download URLs - [references/assets.md](references/assets.md) - Uploading images, videos, audio - [references/dimensions.md](references/dimensions.md) - Resolution and aspect ratios - [references/quota.md](references/quota.md) - Credit system and usage limits
## Best Practices
1. **Preview avatars before generating** — Download `preview_image_url` so the user can see the avatar before committing 2. **Use avatar's default voice** — Most avatars have a `default_voice_id` pre-matched for natural results 3. **Fallback: match gender manually** — If no default voice, ensure avatar and voice genders match 4. **Use test mode for development** — Set `test: true` to avoid consuming credits (output will be watermarked) 5. **Set generous timeouts** — Video generation often takes 5-15 minutes, sometimes longer 6. **Validate inputs** — Check avatar and voice IDs exist before generating
Source provenance
Decision snapshot
55,322 GitHub stars
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for avatar-video, ready for a manual X post.
avatar-video: Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backg... 55.3K stars https://www.openagentskill.com/skills/calesthio-avatar-video?ref=x
Listing + install path for avatar-video: https://www.openagentskill.com/skills/calesthio-avatar-video?ref=x Install: npx skills add calesthio/OpenMontage --skill avatar-video
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to calesthio but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/calesthio-avatar-video/audit)
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)calesthio
@calesthio
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Sandbox only
mono-color
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
1.9K StarsLast30days Skill
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
61.0K StarsAcademic Research Skills
Academic Research Skills for Claude Code: research → write → review → revise → finalize
38.4K StarsGPT Researcher
Run autonomous deep research over web and local sources
28.0K StarsSandbox only
Install targets
Codex install prompt
Install the "avatar-video" agent skill from https://github.com/calesthio/OpenMontage/tree/main/.agents/skills/avatar-video. Read its SKILL.md or equivalent instructions first, install only the files needed for this workspace, and summarize any required setup before using it. Skill purpose: Create 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 different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control. After the install attempt, report the result to https://www.openagentskill.com/api/agent/outcome with POST JSON {"event_id":"install_<unique-id>","skill_slug":"calesthio-avatar-video","task":"Install avatar-video","agent":"codex","outcome":"success","install_used":true}. Replace event_id with a unique value and outcome with success or failed. Report success only after the skill is installed and a minimal verification passes.Supply asset profile
Deep research, source comparison, literature review, RAG, knowledge search, and reports.
Scenario
Research agents
I need my agent to research a topic, compare sources, and produce a concise report.
Agent fit
Claude Code + CLI + Codex
Codex, Claude Code, Cursor, CLI, or custom agents.
Install
Ready
npx skills add calesthio/OpenMontage --skill avatar-video
Maintenance
fresh
13d since push
Risk
Needs review
Dependency or permission surface needs review
GitHub quality
55K
94/100 Quality · 81/100 Trust
Coverage tags
Review notes
Dependency or permission surface needs review · Permission surface may require sandboxing
Agent adoption scorecard
These scores combine public repository metadata, OpenAgentSkill review signals, maintenance freshness, and install readiness. They are a shortlist signal, not a replacement for human review.
Quality
ExcellentHigh-confidence pick with strong adoption and healthy maintenance signals.
Trust
Sandbox onlyUseful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
Audit
Needs reviewA machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
OpenAgentSkill Trust Score v5
Run only in a sandbox and compare close alternatives before using it for real work.
Stars
55K GitHub stars
Repo activity
55K stars, 6.9K forks
Maintenance
13d since push
License
AGPL-3.0
Install
npx skills add calesthio/OpenMontage --skill avatar-video
Install safety
Agent-readable metadata
Use this block or the embedded JSON to decide whether an agent should install this skill, choose an alternative, or ask for human review first.
Suited tasks
Suited agents
Install decision
Trust and risk
Outcome loop
Install command
npx skills add calesthio/OpenMontage --skill avatar-videoDo not use when
Alternative
1.9K Stars
npx skills add yanliudesign/mono-color-skill --skill mono-color
Alternative
61.0K Stars
npx skills add mvanhorn/last30days-skill -g
Alternative
38.4K Stars
npx skills add Imbad0202/academic-research-skills
Alternative
28.0K Stars
npx skills add assafelovic/gpt-researcher
Agent safety v2
Sparse or mixed signals. Useful for discovery, but not for autonomous installation.
Test manually in an isolated workspace and compare against safer alternatives.
high
Skill metadata references terminal, CLI, shell, subprocess, or command execution workflows.
medium
Skill likely fetches remote pages, APIs, repositories, or external services.
medium
Skill may read or write project files, documents, generated artifacts, or local workspace state.
high
Skill metadata references credentials, tokens, environment variables, or secret-bearing workflows.
Agent resolve plan
The Resolve API returns the selected skill, alternatives, safety policy, audit notes, install target, and copy-paste prompt an agent can follow without scraping this page.
Open JSON
/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Resolve text
/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium&format=text
Install handoff
/api/skills/calesthio-avatar-video/install
Agent should check
Copy prompt
Task: Use avatar-video in this workspace.
Resolve first: https://www.openagentskill.com/api/agent/resolve?task=Use%20avatar-video%20for%20an%20agent%20workflow&agent=codex&max_risk=medium
Review install handoff: https://www.openagentskill.com/api/skills/calesthio-avatar-video/install
Install command: npx skills add calesthio/OpenMontage --skill avatar-video
Before running it, summarize audit warnings, required permissions, and the fallback skill if install is risky.Agent handoff
Use the public install endpoint to fetch the command, safety checklist, target prompts, and canonical links for this skill.
Install handoff
/api/skills/calesthio-avatar-video/install
LLM text format
/api/skills/calesthio-avatar-video/install?format=text
Find alternatives
/api/skills/search?q=avatar-video&limit=3
Agent prompt
Use avatar-video for this task. Review https://www.openagentskill.com/api/skills/calesthio-avatar-video/install, then install with: npx skills add calesthio/OpenMontage --skill avatar-videoRegistry metadata
This page exposes the same decision, trust, audit, use-case, and install signals through the Registry API, so agents can rank this skill without scraping the UI.
Manifest
/api/registry/manifest/calesthio-avatar-video
LLM text
/api/registry/manifest/calesthio-avatar-video?format=text
Install alias
/api/registry/install/calesthio-avatar-video
Recommend
/api/registry/recommend?task=Use%20avatar-video%20in%20an%20agent%20workflow&limit=3
Agent fit
Workflow automation
Use-case tags
Platforms
Claude Code
Audit report
A machine-readable review of install readiness, security metadata, maintenance, and adoption risk.
Agent decision cockpit
Use this as a leading candidate, then validate the README and install path in your own agent stack.
Role in stack
Primary pick
Primary fit
Workflow automation
Trust label
Production-ready
Install path
Command ready
Use when
Evidence
review first
Implementation path
Trust profile
Useful candidate with missing or mixed trust signals. Keep it in an isolated workspace until the outcome loop proves task fit.
GitHub adoption
PASS55K GitHub stars
Stars/forks activity
PASS55K stars, 6.9K forks; issue activity unavailable in current metadata
Recent maintenance
PASS13d since push
License clarity
PASSAGPL-3.0
Good signals
Review before install
Recommended action
Run only in a sandbox and compare close alternatives before using it for real work.
Quality profile
High-confidence pick with strong adoption and healthy maintenance signals.
Workflow fit
Automate repeated work
I need my agent to automate a repeated workflow across tools and files.
Process rich media
I need my agent to process images, video, or audio and extract useful information.
Plan, generate, and review video
I need my agent to turn a topic or product into a short video, generate B-roll, write video prompts, and prepare a publish-ready cut.
Workflow fit
Operate and verify web apps
A workflow for agents that navigate products, fill forms, take screenshots, and verify real user flows across web applications.
Turn skills into distribution
A workflow for turning newly indexed skills into SEO briefs, social drafts, comparison pages, and reusable publishing workflows.
Brief to publish-ready creative
A practical workflow for agents that shape a video brief, create strong multimodal prompts, generate supporting B-roll, and prepare a reviewable short-form or explainer video.
Alternative shortlist
Similar skills that may fit this task.
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
Academic Research Skills for Claude Code: research → write → review → revise → finalize
Run autonomous deep research over web and local sources
--- name: avatar-video description: | Create 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 different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control. homepage: https://docs.heygen.com/reference/create-a-video allowed-tools: mcp__heygen__* metadata: openclaw: requires: env: - HEYGEN_API_KEY primaryEnv: HEYGEN_API_KEY ---
# Avatar Video
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.
## Authentication
All requests require the `X-Api-Key` header. Set the `HEYGEN_API_KEY` environment variable.
```bash curl -X GET "https://api.heygen.com/v2/avatars" \ -H "X-Api-Key: $HEYGEN_API_KEY" ```
## Tool Selection
If HeyGen MCP tools are available (`mcp__heygen__*`), **prefer them** over direct HTTP API calls — they handle authentication and request formatting automatically.
| Task | MCP Tool | Fallback (Direct API) | |------|----------|----------------------| | Check video status / get URL | `mcp__heygen__get_video` | `GET /v2/videos/{video_id}` | | List account videos | `mcp__heygen__list_videos` | `GET /v2/videos` | | Delete a video | `mcp__heygen__delete_video` | `DELETE /v2/videos/{video_id}` |
Video generation (`POST /v2/video/generate`) and avatar/voice listing are done via direct API calls — see reference files below.
## Default Workflow
1. **List avatars** — `GET /v2/avatars` → pick an avatar, preview it, note `avatar_id` and `default_voice_id`. See [avatars.md](references/avatars.md) 2. **List voices** (if needed) — `GET /v2/voices` → pick a voice matching the avatar's gender/language. See [voices.md](references/voices.md) 3. **Write the script** — Structure scenes with one concept each. See [scripts.md](references/scripts.md) 4. **Generate the video** — `POST /v2/video/generate` with avatar, voice, script, and background per scene. See [video-generation.md](references/video-generation.md) 5. **Poll for completion** — `GET /v2/videos/{video_id}` until status is `completed`. See [video-status.md](references/video-status.md)
## Quick Reference
| Task | Read | |------|------| | List and preview avatars | [avatars.md](references/avatars.md) | | List and select voices | [voices.md](references/voices.md) | | Write and structure scripts | [scripts.md](references/scripts.md) | | Generate video (single or multi-scene) | [video-generation.md](references/video-generation.md) | | Add custom backgrounds | [backgrounds.md](references/backgrounds.md) | | Add captions / subtitles | [captions.md](references/captions.md) | | Add text overlays | [text-overlays.md](references/text-overlays.md) | | Create transparent WebM video | [video-generation.md](references/video-generation.md) (WebM section) | | Use templates | [templates.md](references/templates.md) | | Create avatar from photo | [photo-avatars.md](references/photo-avatars.md) | | Check video status / download | [video-status.md](references/video-status.md) | | Upload assets (images, audio) | [assets.md](references/assets.md) | | Use with Remotion | [remotion-integration.md](references/remotion-integration.md) | | Set up webhooks | [webhooks.md](references/webhooks.md) |
## When to Use This Skill vs Create Video
This skill is for **precise control** — you choose the avatar, write the exact script, configure each scene.
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.
| User Says | Create Video Skill | This Skill | |-----------|:------------------:|:----------:| | "Make me a video about X" | ✓ | | | "Create a product demo" | ✓ | | | "I want avatar Y to say exactly Z" | | ✓ | | "Multi-scene video with different backgrounds" | | ✓ | | "Transparent WebM for compositing" | | ✓ | | "Use this specific voice for my script" | | ✓ | | "Batch generate videos with exact specs" | | ✓ |
## Reference Files
### Core Video Creation - [references/avatars.md](references/avatars.md) - Listing avatars, styles, avatar_id selection - [references/voices.md](references/voices.md) - Listing voices, locales, speed/pitch - [references/scripts.md](references/scripts.md) - Writing scripts, pauses, pacing - [references/video-generation.md](references/video-generation.md) - POST /v2/video/generate and multi-scene videos
### Video Customization - [references/backgrounds.md](references/backgrounds.md) - Solid colors, images, video backgrounds - [references/text-overlays.md](references/text-overlays.md) - Adding text with fonts and positioning - [references/captions.md](references/captions.md) - Auto-generated captions and subtitles
### Advanced Features - [references/templates.md](references/templates.md) - Template listing and variable replacement - [references/photo-avatars.md](references/photo-avatars.md) - Creating avatars from photos - [references/webhooks.md](references/webhooks.md) - Webhook endpoints and events
### Integration - [references/remotion-integration.md](references/remotion-integration.md) - Using HeyGen in Remotion compositions
### Foundation - [references/video-status.md](references/video-status.md) - Polling patterns and download URLs - [references/assets.md](references/assets.md) - Uploading images, videos, audio - [references/dimensions.md](references/dimensions.md) - Resolution and aspect ratios - [references/quota.md](references/quota.md) - Credit system and usage limits
## Best Practices
1. **Preview avatars before generating** — Download `preview_image_url` so the user can see the avatar before committing 2. **Use avatar's default voice** — Most avatars have a `default_voice_id` pre-matched for natural results 3. **Fallback: match gender manually** — If no default voice, ensure avatar and voice genders match 4. **Use test mode for development** — Set `test: true` to avoid consuming credits (output will be watermarked) 5. **Set generous timeouts** — Video generation often takes 5-15 minutes, sometimes longer 6. **Validate inputs** — Check avatar and voice IDs exist before generating
Source provenance
Decision snapshot
55,322 GitHub stars
Audit
Install and adoption review
Agent-proven evidence
Outcome reports after resolve, review, install, and one narrow run.
No agent outcome data yet. The first agent run can report success, setup needs, risk blocks, failure, or not-relevant through /api/agent/outcome.
Install
Free and open source. Review the report before installing into production agents.
Growth loop
Scenario-led draft for avatar-video, ready for a manual X post.
avatar-video: Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backg... 55.3K stars https://www.openagentskill.com/skills/calesthio-avatar-video?ref=x
Listing + install path for avatar-video: https://www.openagentskill.com/skills/calesthio-avatar-video?ref=x Install: npx skills add calesthio/OpenMontage --skill avatar-video
Listing source
This listing was indexed from public sources and is not marked official until a maintainer claim is approved.
Attribution links to the public repository or creator profile. Creators can claim the listing to update ownership signals.
Claim this skillOwner claim
This Registry indexed listing is attributed to calesthio but is not marked official yet. Claim it to add a verified owner signal and make future launch, install, and audit updates easier to trust.
Creator backlink kit
Show the canonical listing, current trust and audit signals, and real Agent-Proven evidence where developers evaluate the repository.
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)
[](https://www.openagentskill.com/skills/calesthio-avatar-video/audit)
[](https://www.openagentskill.com/skills/calesthio-avatar-video?ref=github&utm_source=github&utm_medium=referral&utm_campaign=creator_badge)calesthio
@calesthio
Share whether this skill looks useful for your agent workflow. Aggregated feedback improves rankings over time.
Sandbox only
mono-color
Generate original one-ink or controlled two-ink editorial images from any theme, sentence, article idea, object, or reference photo. Always use this skill when the user asks for 单色海报、双色印刷、单色调视觉、蓝色/绿色孔版印刷、risograph、网点照片、复古或当代编辑排版、zine poster, monochrome editorial poster, duotone print, or asks to use the mono-color style. It uses an adaptive white, gray, or pale-beige substrate, no more than two printing inks, active negative space, terse human language, and strong serif/grotesk/mono typography without making retro styling the default or copying a source composition, wording, logo, or artwork. Produce both the final generation prompt and the generated raster image unless the user explicitly asks for prompt only.
1.9K StarsLast30days Skill
Research the last 30 days across Reddit, X, YouTube, Hacker News, Polymarket, GitHub, and the web, then synthesize a grounded brief for an AI agent.
61.0K StarsAcademic Research Skills
Academic Research Skills for Claude Code: research → write → review → revise → finalize
38.4K StarsGPT Researcher
Run autonomous deep research over web and local sources
28.0K StarsPermission surface
secrets or environment access, shell or command execution
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness
Permission surface
secrets or environment access, shell or command execution
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness
Permission surface
secrets or environment access, shell or command execution
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness
Permission surface
secrets or environment access, shell or command execution
Agent outcomes
No agent outcome data yet
Docs
Strong README/SKILL.md context
Risk summary
Install readiness