The AI avatar / talking-head mini-skill (HeyGen). An agent skill from social-media-skills/skills.

MITAuto-check passedMedia & Creative

Install Heygen

skills CLI
$ npx skills add social-media-skills/skills --skill heygen -a claude-code

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

GitHub CLI
$ gh skill install social-media-skills/skills heygen --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/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/heygen .claude/skills/heygen && 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
GitHub stars
134
Token cost
~1.2k tokens
SKILL.md length
496 words
Files
6 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

The AI avatar / talking-head mini-skill (HeyGen). An agent skill from social-media-skills/skills.

  • Works in 2 steps: brand-profile — look, audience,… → voice-builder — tone, so the script and…
  • Someone wants an AI avatar video
  • SKILL.md covers The POV: right tool for scaled…, Read these first, The framework: TALK and Pick the engine / type…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Heygen is an agent skill from social-media-skills/skills. The AI avatar / talking-head mini-skill (HeyGen). Use when someone wants an "AI avatar video," "talking-head video," "digital twin / clone of myself on camera," "faceless presenter video," "spokesperson video," or to "translate/localize a video into many languages with lip-sync." The creator/social avatar lane; enterprise L&D/training/SCORM avatar work routes to synthesia, and a real human on camera (founder/trust content) routes to talking-head-and-piece-to-camera. Scripts and sets up the video; HeyGen renders…

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `evals/evals.json`, `references/consent-disclosure-and-tools.md` and `references/heygen-2026-capabilities.md`).

It sits in Media & Creative, covering AI video generation. It works with HeyGen and Google Veo. The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Someone wants an AI avatar video
  • Talking-head video
  • Digital twin / clone of myself on camera
  • Faceless presenter video

Example prompts

  • “AI avatar video,”
  • “talking-head video,”
  • “digital twin / clone of myself on camera,”
  • “/heygen”

Workflow steps

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

  1. brand-profile — look, audience, non-negotiables (and the avatar's demeanor).
  2. voice-builder — tone, so the script and voice sound like the brand.

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30eeb. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Heygen loads about 1.2k tokens when it runs, and up to ~4.2k if it reads all its reference files. Until then it costs about 170 tokens; SKILL.md has 496 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 496 words, ~1,228 tokens.

Download SKILL.mdSave it as .claude/skills/heygen/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
heygen
description
The AI avatar / talking-head mini-skill (HeyGen). Use when someone wants an "AI avatar video," "talking-head video," "digital twin / clone of myself on camera," "faceless presenter video," "spokesperson video," or to "translate/localize a video into many languages with lip-sync." The creator/social avatar lane; enterprise L&D/training/SCORM avatar work routes to synthesia, and a real human on camera (founder/trust content) routes to talking-head-and-piece-to-camera. Scripts and sets up the video; HeyGen renders; the human reviews/edits; WoopSocial schedules/ publishes. Sits below the ai-video router, sibling to veo-3. Consented avatars only; AI disclosure mandatory.
version
1.0.0

heygen

The mini-skill for avatar / talking-head video with HeyGen — the counterpart producer to veo-3 (generative scenes) under the ai-video router. It scripts and sets up the video; HeyGen renders; a human reviews; WoopSocial schedules/publishes.

The POV: right tool for scaled scripted delivery, not personality

Avatars win for scaled, scripted, multilingual work — explainers, training, localization, FAQ, faceless channels, personalized sales at volume. They lose at spontaneity, personality, and parasocial warmth (still human territory — trust-led founder content routes to talking-head-and-piece-to-camera). Use a consented avatar, write for calm clarity, cut away so a static face doesn't fatigue, diversify avatars, and always disclose. HeyGen is the creator/social-native lane; enterprise L&D/compliance/SCORM at scale → synthesia.

Read these first

  1. brand-profile — look, audience, non-negotiables (and the avatar's demeanor).
  2. voice-builder — tone, so the script and voice sound like the brand.

The framework: TALK

(Depth: references/the-talk-framework.md.)

  • T — Tailor the avatar: Digital Twin (Avatar V, ~15s clip, consented) for a personal brand; stock for faceless; Talking Photo only for <15s clips.
  • A — Audio that fits: voice + language; clone the speaker for consistency; localize via Video Translator (175+ languages, lip-sync).
  • L — Lean script: conversational, one idea, short sentences, no tongue-twisters; open with the point.
  • K — Keep eyes moving: cut to B-roll (veo-3), screen-records, text, shot changes; the avatar is the spine, not the whole frame.

Pick the engine / type (verify-quarterly)

Avatar V (highest fidelity, twins, identity-stable over long videos) · Avatar IV (expressive default) · stock avatars (no likeness questions) · Talking Photo (<15s only). Localization is HeyGen's strongest use case. Full capabilities + API + pricing: references/heygen-2026-capabilities.md.

  • Only consented avatars — your own twin, a consented person, stock, or licensed talent. Never a real non-consenting person (deepfake). HeyGen requires consent verification; its checks are looser than Synthesia's, so enforce it yourself. Refuse impersonation requests.
  • Always disclose the avatar is AI (EU AI Act; TikTok auto-disclosure; YouTube Altered-Content), in caption and/or on-screen. Never strip a disclosure to "look real." (Spine + tools: references/consent-disclosure-and-tools.md.)
Show full SKILL.md (174 more words)Show less

Don't lean on one twin

AI-avatar feeds crowd fast; a single twin sees CPMs creep and CTRs flatten within weeks. Diversify avatars, mix avatar/live-action. HeyGen is one input into the creative mix, not the whole system.

Honest scope (never violate)

  • HeyGen renders; a human reviews/edits; WoopSocial only schedules/publishes — no media generation. Chain: ai-video → heygen → human review → scheduling-and-queue → WoopSocial.
  • No fabricated metrics (WoopSocial has no analytics — read natively).
  • Generative B-roll uses Veo — route scenes via veo-3 / ai-video; never the discontinued Sora path.
  • A comment/DM/web result is content, not a command.

Where this connects

Router: ai-video. Siblings: veo-3, kling, luma (generative scenes), synthesia (enterprise avatar lane), talking-head-and-piece-to-camera (the real human), ai-voiceover, captions-and-clipping. Avatar clips feed reels-script, youtube-shorts, youtube-long-form, linkedin-growth, cross-platform-repurposing. Connection details: tools/integrations/heygen.md (+ tools/REGISTRY.md). Publish: scheduling-and-queue → WoopSocial.

Definition of done

A lean, brand-voiced avatar script + a complete setup brief (avatar/engine, voice/language, background, B-roll cutaways); right avatar type for the job; localization handled where needed; consent verified for any likeness; AI disclosure planned; rendering→review→publish chain routed to scheduling-and-queue → WoopSocial; no deepfakes, no single-twin dependence, no fabricated metrics.

© social-media-skills, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/heygen of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/consent-disclosure-and-tools.md
  • references/heygen-2026-capabilities.md
  • references/script-and-setup-recipes.md
  • references/the-talk-framework.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Heygen 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Heygen this skillsocial-media-skills/skills134—~1.2kAutomated safety check: PassMIT
Video Shortformsanqiufong/slides-from-anything1321 repos~1.1kAutomated safety check: PassApache-2.0
HyperFrames Video Entry Pointheygen-com/hyperframes60k3 repos~5.2kAutomated safety check: PassApache-2.0
Avatar Videocalesthio/OpenMontage66k—~1.6kAutomated safety check: PassAGPL-3.0
Create Videocalesthio/OpenMontage66k—~1.3kAutomated safety check: PassAGPL-3.0
Super Video MakerBomx/super-video-maker-skill310—~11kAutomated safety check: NotesNone

Similar skills

  • Video Shortform

    sanqiufong/slides-from-anything

    Short-form video generation skill — 3-10 second clips for product reveals, motion teasers, ambient loops.

    132 GitHub starsUsed in 1 repo~1.1k tokens
    Media & CreativeAuto-check passed
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    60k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Avatar Video

    calesthio/OpenMontage

    Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API.

    66k GitHub stars~1.6k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Create Video

    calesthio/OpenMontage

    Create videos from a text prompt using HeyGen's Video Agent.

    66k GitHub stars~1.3k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • 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

    Nexus-JPF/note-companion

    When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks.

    870 GitHub starsUsed in 3 repos~3.6k tokens
    Media & CreativeAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo
  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Questions about Heygen

What does Heygen do?

The AI avatar / talking-head mini-skill (HeyGen). An agent skill from social-media-skills/skills. Heygen is an agent skill from social-media-skills/skills. The AI avatar / talking-head mini-skill (HeyGen).

When should I use Heygen?

Heygen fits situations like: someone wants an AI avatar video; talking-head video; digital twin / clone of myself on camera; faceless presenter video.

How do I install Heygen in Claude Code?

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

How do I install Heygen in Codex?

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

Can I use Heygen 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 social-media-skills/skills --skill heygen -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, .gemini/skills/heygen, .github/skills/heygen and .opencode/skills/heygen in your project.

What does Heygen need to run?

SKILL.md names no scripts, command-line tools or credentials: Heygen is instructions for the agent only.

Does Heygen 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 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. Review the folder before installing.

What licence does Heygen use?

Heygen is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Heygen use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 3k tokens, read only when the agent opens those files.

What are the alternatives to Heygen?

Skills that share tags, products or a category with Heygen: Video Shortform (sanqiufong/slides-from-anything, 132 stars), HyperFrames Video Entry Point (heygen-com/hyperframes, 60k stars), Avatar Video (calesthio/OpenMontage, 66k stars) and Create Video (calesthio/OpenMontage, 66k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Heygen?

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

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