skill-avatar-heygen-factory

Generates talking-photo avatar videos via HeyGen API with ElevenLabs voiceover and lane routing.

Updated Jun 20, 2026
One-click install
npx skills add https://github.com/Noetfield-Systems/SourceA --skill skill-avatar-heygen-factory-noetfield-systems
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-avatar-heygen-factory
Source: https://github.com/Noetfield-Systems/SourceA/tree/main/.cursor/skills/skill-avatar-heygen-factory
Command: npx skills add https://github.com/Noetfield-Systems/SourceA --skill skill-avatar-heygen-factory-noetfield-systems

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Producing founder digital-twin videos for LinkedIn and social channels requires coordinating a master headshot, ElevenLabs voiceover, and the HeyGen talking-photo API, plus enforcing rules about which marketing lanes may use synthetic faces. This Skill automates that pipeline and prevents avatar content from being routed to blocked lanes like the WitnessBC tier A hero slot. ## Core Features & Use Cases - Automated HeyGen v3 pipeline: Uploads the master image and ElevenLabs MP3, creates a cached photo avatar, renders a 1080p lipsync video, and downloads the result. - Lane-based routing: Supports linkedin, trustfield_social, noetfield_social, and fitness_social lanes with per-lane scripts, output filenames, and avatar policies, while blocking witnessbc_hero. - Manual fallback: When no HeyGen API key is present or the API fails, it produces a manual pack (voice.mp3, script.txt, README) for HeyGen/D-ID studio export, then muxes the export with cached VO. - Use Case: A founder needs a 40-second LinkedIn anchor video; run the linkedin lane to generate ElevenLabs VO, render the HeyGen talking photo, and output Founder-LinkedIn-Anchor.mp4 to the Desktop. ## Quick Start Ask the assistant to run the avatar pipeline for the LinkedIn lane to generate the founder anchor video with ElevenLabs voiceover and HeyGen talking photo.

Frequently Asked Questions about skill-avatar-heygen-factory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a HeyGen talking photo video from a headshot?

Provide a 1024x1024 forward-facing master image and an ElevenLabs-generated MP3. The pipeline uploads both to HeyGen v3 assets, creates a cached photo avatar, renders a 1080p lipsync video via audio_asset_id, and downloads the MP4.

How do I generate a LinkedIn founder anchor video with AI avatar?

Run bash avatar-pipeline.sh linkedin from the project root. It produces a roughly 40-second video using the linkedin_anchor_v1 script, ElevenLabs VO, and HeyGen image-to-video, saved as Founder-LinkedIn-Anchor.mp4 on the Desktop.

What happens if the HeyGen API key is missing or the API fails?

The pipeline falls back to manual mode: it writes voice.mp3, script.txt, and a README manual pack to the work directory. You export from HeyGen or D-ID studio, then mux with --avatar-video pointing to the downloaded MP4.

Can I use HeyGen avatar videos on the WitnessBC hero page?

No. The witnessbc_hero lane is explicitly blocked in the routing configuration because a synthetic face on a trust product's tier A hero slot violates the founder_lock Path A policy. Avatar output is restricted to tier C social lanes.

What image quality does HeyGen photo avatar require?

Use a master image of at least 1024x1024 pixels with a neutral background, even lighting, and a forward-facing pose. The pipeline checks for the master image first and writes a manual README instead of failing silently if it is missing.