Agent skill

HeyGen Digital Avatar Compositor

by Pluviobyte in Pluviobyte/rnskill

Generates a HeyGen digital-human video layer using a fixed avatar profile, local narration and an approved circular avatar placement.

Custom licenceAuto-check passedMedia & Creative

Install HeyGen Digital Avatar Compositor

skills CLI
$ npx skills add Pluviobyte/rnskill --skill heygen-digital-avatar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Pluviobyte/rnskill heygen-digital-avatar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Pluviobyte/rnskill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/heygen-digital-avatar .claude/skills/heygen-digital-avatar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
heygen-digital-avatar
GitHub stars
1.6k
Token cost
~2.4k tokens
SKILL.md length
1,143 words
Files
6 (incl. scripts, references)
Skills in repo
45
Repo updated
First seen
Licence
Custom licence

At a glance

Generates a HeyGen digital-human video layer using a fixed avatar profile, local narration and an approved circular avatar placement.

  • Works in 12 steps: Run env -u HEYGEN_API_KEY heygen auth… → Generate the complete narration audition… → Give the user the exact audition WAV… → …
  • Adding a digital-human avatar layer to a video in this workspace
  • SKILL.md covers Fixed profile, Workflow, Standard compositor and Credit guard, plus 1 more section
  • Runs Python and Swift scripts from its folder; calls python3; needs HEYGEN_API_KEY

What it does

A fixed, machine-readable profile is read before anything is built, and the look never gets swapped for a different one from the same avatar group. Authentication runs through HeyGen CLI OAuth with the API key stripped from the child environment so a stray shell variable cannot switch billing lanes; an unspecified digital human defaults to one avatar engine, while the named preset "数字人5" always resolves to the premium engine instead.

Narration always comes from a local text-to-speech skill using one specific calm voice, never from HeyGen's own synthesis or another fallback. The full audition audio must be generated and explicitly approved by the user before any audio is uploaded to HeyGen, and any later edit to that audio invalidates the approval. The avatar defaults to a small circular overlay in the lower-left corner unless the user explicitly asks for full screen, and it must be paired with a separate motion skill before any motion prompt or paid generation is submitted.

When your agent uses it

  • Adding a digital-human avatar layer to a video in this workspace
  • Switching between the default and premium HeyGen avatar presets
  • Generating and approving narration before a paid HeyGen render

Example prompts

  • “Add the default circular digital human avatar to this video.”
  • “Use the premium avatar preset and generate narration for my approval.”
  • “Switch this avatar to full-screen instead of the lower-left circle.”

Requirements

  • HeyGen CLI OAuth with Creator-plan credits
  • A local text-to-speech skill for narration
  • A separate avatar-motion skill for motion prompts

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. Run env -u HEYGEN_API_KEY heygen auth status. Require credential type
  2. Generate the complete narration audition with tts-skill; require the
  3. Give the user the exact audition WAV (and optionally a portable MP3) and
  4. Recompute the WAV SHA-256 immediately before upload. If it differs from the
  5. Generate production captions from the approved locked audio with
  6. Upload the approved locked WAV with
  7. Use heygen-avatar-motion to classify each semantic section, save the exact
  8. Resolve the engine from the named preset before building the request. For
  9. Download the completed master with heygen video download. Reuse that
  10. For the default layout, overlay the master with
  11. For explicit full-screen mode, use the HeyGen master as the main visual and
  12. Verify media streams, duration, representative frames, subtitle clearance,

What it can do on your machine

Read from SKILL.md and the folder at commit 83d1783. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python and Swift), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • HEYGEN_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

HeyGen Digital Avatar Compositor loads about 2.4k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 198 tokens; SKILL.md has 1,143 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~198
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,143 words (~2,443 tokens).

“Create the avatar layer for a video. Let ra-video-production-director own the whole production, captions, QC, and archive; let this skill own HeyGen auth, avatar selection, generation, and the approved avatar layout.”

— opening of SKILL.md by Pluviobyte, Custom licence
name
heygen-digital-avatar

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (scripts, references) in skills/heygen-digital-avatar of Pluviobyte/rnskill.

  • SKILL.md
  • agents/openai.yaml
  • references/pluviobyte-profile.json
  • scripts/build_request.py
  • scripts/compose_circle_avatar.py
  • scripts/measure_face_center.swift

Open the folder on GitHubat commit 83d1783

Compare with similar skills

HeyGen Digital Avatar Compositor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

HeyGen Digital Avatar Compositor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
HeyGen Digital Avatar Compositor this skillPluviobyte/rnskill1.6k—~2.4kAutomated safety check: PassCustom licence
Super Video MakerBomx/super-video-maker-skill310—~11kAutomated safety check: NotesNone
Video Podcast Maker NanoAgents365-ai/video-podcast-maker1.7k—~3.6kAutomated safety check: PassMIT
Content To Videoarchitectds/modeldock117—~2.4kAutomated safety check: PassApache-2.0
Hyperframes CLIOpenMinis/MinisSkills446—~3.5kAutomated safety check: PassMIT
Article Explainer Videowwwzhouhui/skills_collection283—~2.2kAutomated safety check: PassNone

Similar skills

  • Super Video Maker

    Bomx/super-video-maker-skill

    End-to-end AI video production skill for agentic frameworks.

    310 GitHub stars~11k tokensUpdated 2 mo ago
    Media & CreativeAuto-check: notes
  • Video Podcast Maker Nano

    Agents365-ai/video-podcast-maker

    Smallest personal narrated-explainer-video pipeline (spoken narration over visuals, not an audio podcast), fully tool-agnostic and autonomous by default — topic → research ∥ asset collection →…

    1.7k GitHub stars~3.6k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed
  • Content To Video

    architectds/modeldock

    Turn arbitrary source content (README, article, story, slides, deck, data/report, product description, tutorial text, audio/transcript, or a bare topic) into a finished, high-quality MP4 video.

    117 GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Hyperframes CLI

    OpenMinis/MinisSkills

    HyperFrames CLI and Minis rendering. An agent skill from OpenMinis/MinisSkills.

    446 GitHub stars~3.5k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Article Explainer Video

    wwwzhouhui/skills_collection

    把一篇技术长文/论文解读自动做成章节式解说视频(1080p, 5-8 分钟)。双主题:warm(奶油底+珊瑚红+cozy-handdrawn 透明插图,亲和感)和 midnight(深蓝黑底+琥珀金+宋体标题+executive-tech 插图,AI 科技感),storyboard 一个 theme 字段切换。每章三种 layout 混排:illustration(左文右图+Ken…

    283 GitHub stars~2.2k tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Hyperframes Ad Director

    OneWave-AI/claude-skills

    Turn a marketing brief or product offer into a finished short-form video ad built in HyperFrames — hook, script, shot-by-shot storyboard, scene-by-scene HTML composition, captions, and voiceover.

    336 GitHub stars~988 tokensUpdated 9 days ago
    Media & CreativeAuto-check passed

More from Pluviobyte/rnskill

All 45 skills in this repo
  • Motion Replica Builder

    Pluviobyte/rnskill

    Analyzes a reference video's layout, motion and timing over a chosen time range, then builds an original animated replica with new copy and assets plus a final video QC.

    1.6k GitHub stars~1.7k tokensUpdated 20 days ago
    Auto-check passed
  • Niulai Style Image Transfer

    Pluviobyte/rnskill

    Restyles photos, film stills or new scene descriptions in the rough low-budget 3D look observed in the 2026 animated film Niulai, with an iterative scoring loop.

    1.6k GitHub stars~1.3k tokensUpdated 20 days ago
    Auto-check passed
  • Skill Captions

    Pluviobyte/rnskill

    Renders, previews, validates and burns in production subtitles from QC-passed caption timing, with fixed dark or light caption styles scaled to the video size.

    1.6k GitHub stars~1.3k tokensUpdated 20 days ago
    Auto-check passed
  • Creates Chinese social-media video covers in 3:4 and 4:3 from registered styles and shared presenter assets, or swaps the person in a reference cover for a digital-human frame.

    1.6k GitHub stars~1.2k tokensUpdated 20 days ago
    Auto-check passed
  • Generates SRT, VTT and caption JSON for final narration audio or a merged video using Volcengine Doubao ASR word timestamps, with a quality gate before delivery.

    1.6k GitHub stars~1.1k tokensUpdated 20 days ago
    Auto-check: notes
  • Produces a local rough cut of a talking-head or narrated screen recording, with transcript correction, an approval gate, pause compression and loudness normalization.

    1.6k GitHub stars~1.8k tokensUpdated 20 days ago
    Auto-check passed

Works with

Questions about HeyGen Digital Avatar Compositor

What does HeyGen Digital Avatar Compositor do?

Generates a HeyGen digital-human video layer using a fixed avatar profile, local narration and an approved circular avatar placement. A fixed, machine-readable profile is read before anything is built, and the look never gets swapped for a different one from the same avatar group. Authentication runs through HeyGen CLI OAuth with the API key stripped from the child environment so a stray shell variable cannot switch billing lanes; an unspecified digital human defaults to one avatar engine, while the named preset "数字人5" always resolves to the premium engine instead.

When should I use HeyGen Digital Avatar Compositor?

HeyGen Digital Avatar Compositor fits situations like: adding a digital-human avatar layer to a video in this workspace; switching between the default and premium HeyGen avatar presets; generating and approving narration before a paid HeyGen render.

How do I install HeyGen Digital Avatar Compositor in Claude Code?

Run `npx skills add Pluviobyte/rnskill --skill heygen-digital-avatar -a claude-code`. Or copy the skill folder (skills/heygen-digital-avatar in Pluviobyte/rnskill) into .claude/skills/heygen-digital-avatar in your project. Claude Code loads it when a task matches its description.

How do I install HeyGen Digital Avatar Compositor in Codex?

Run `npx skills add Pluviobyte/rnskill --skill heygen-digital-avatar -a codex`. Or copy the skill folder (skills/heygen-digital-avatar in Pluviobyte/rnskill) into .agents/skills/heygen-digital-avatar in your project. Codex loads it when a task matches its description.

Can I use HeyGen Digital Avatar Compositor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Pluviobyte/rnskill --skill heygen-digital-avatar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/heygen-digital-avatar, .gemini/skills/heygen-digital-avatar, .github/skills/heygen-digital-avatar and .opencode/skills/heygen-digital-avatar in your project.

What does HeyGen Digital Avatar Compositor need to run?

Going by SKILL.md and its folder, HeyGen Digital Avatar Compositor needs Python and Swift for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named HEYGEN_API_KEY. Our summary lists: HeyGen CLI OAuth with Creator-plan credits; A local text-to-speech skill for narration; A separate avatar-motion skill for motion prompts.

Does HeyGen Digital Avatar Compositor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is HeyGen Digital Avatar Compositor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does HeyGen Digital Avatar Compositor use?

HeyGen Digital Avatar Compositor has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does HeyGen Digital Avatar Compositor use?

About 2.4k tokens (SKILL.md is roughly 9.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 281 tokens, read only when the agent opens those files.

What are the alternatives to HeyGen Digital Avatar Compositor?

Skills that share tags, products or a category with HeyGen Digital Avatar Compositor: Super Video Maker (Bomx/super-video-maker-skill, 310 stars), Video Podcast Maker Nano (Agents365-ai/video-podcast-maker, 1.7k stars), Content To Video (architectds/modeldock, 117 stars) and Hyperframes CLI (OpenMinis/MinisSkills, 446 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains HeyGen Digital Avatar Compositor?

Pluviobyte (a GitHub user) maintains it in Pluviobyte/rnskill, which has 1,639 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on September 21, 2026.

Source: Pluviobyte/rnskill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.