Communitygithub.com

Avatar-Video

Erstelle KI-Avatar-Videos mit präziser Kontrolle über Avatare, Stimmen, Skripte, Szenen und Hintergründe mittels HeyGens v2 API.

Was ist Avatar-Video?

Dieses Skill ermöglicht es dir, KI-generierte Avatar-Videos mit vollständiger Kontrolle zu erstellen. Du kannst bestimmte Avatare und Stimmen auswählen, exakte Skripte schreiben, mehrere Szenen mit unterschiedlichen Hintergründen bauen und transparente WebM-Videos für Compositing erzeugen. Es unterstützt die Integration von HeyGen mit Remotion, Batch-Videogenerierung mit genauen Spezifikationen und die Erstellung markenkonsistenter Produktionsvideos. Das Skill verwendet HeyGens /v2/video/generate API und bietet einen klaren Workflow: Avatare auflisten, Stimmen wählen, Skripte strukturieren, Video generieren und Status abfragen. Es ist ideal, wenn du präzise Kontrolle über jeden Aspekt deines Videos benötigst – im Gegensatz zum einfacheren Create-Video-Skill, das lediglich eine Videoidee beschreibt.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Zuhair-01/claude-skills-and-systems/tree/HEAD/skills/avatar-video

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Avatar-Video?

Erstelle KI-Avatar-Videos mit vollständiger Kontrolle über Avatare, Stimmen, Skripte, Szenen und Hintergründe. Erstelle Einzel- oder Mehrszenenvideos mit genauer Konfiguration über HeyGens /v2/video/generate API.

Authentifizierung

Alle Anfragen benötigen den X-Api-Key-Header. Setze die Umgebungsvariable HEYGEN_API_KEY.

curl -X GET "https://api.heygen.com/v2/avatars" \
  -H "X-Api-Key: $HEYGEN_API_KEY"

Tool-Auswahl

Falls HeyGen MCP-Tools verfügbar sind (mcp__heygen__*), bevorzuge sie gegenüber direkten HTTP-API-Aufrufen – sie übernehmen Authentifizierung und Anfrageformatierung automatisch.

AufgabeMCP-ToolFallback (Direkte API)
Videostatus prüfen / URL abrufenmcp__heygen__get_videoGET /v2/videos/{video_id}
Konto-Videos auflistenmcp__heygen__list_videosGET /v2/videos
Ein Video löschenmcp__heygen__delete_videoDELETE /v2/videos/{video_id}

Die Videogenerierung (POST /v2/video/generate) und das Auflisten von Avataren/Stimmen erfolgen über direkte API-Aufrufe – siehe die Referenzdateien unten.

Standard-Workflow

  1. Avatare auflisten — GET /v2/avatars → Avatar auswählen, Vorschau anzeigen, avatar_id und default_voice_id notieren. Siehe avatars.md
  2. Stimmen auflisten (falls nötig) — GET /v2/voices → Stimme auswählen, die zum Geschlecht/Sprache des Avatars passt. Siehe voices.md
  3. Skript schreiben — Szenen mit jeweils einem Konzept strukturieren. Siehe scripts.md
  4. Video generieren — POST /v2/video/generate mit Avatar, Stimme, Skript und Hintergrund pro Szene. Siehe video-generation.md
  5. Auf Fertigstellung warten — GET /v2/videos/{video_id} bis Status completed ist. Siehe video-status.md

Kurzreferenz

AufgabeLesen
Avatare auflisten und Vorschau anzeigenavatars.md
Stimmen auflisten und auswählenvoices.md
Skripte schreiben und strukturierenscripts.md
Video generieren (Einzel- oder Mehrszenen)video-generation.md
Benutzerdefinierte Hintergründe hinzufügenbackgrounds.md
Bildunterschriften / Untertitel hinzufügencaptions.md
Textüberlagerungen hinzufügentext-overlays.md
Transparentes WebM-Video erstellenvideo-generation.md (WebM-Abschnitt)
Vorlagen verwendentemplates.md
Avatar aus Foto erstellenphoto-avatars.md
Videostatus prüfen / herunterladenvideo-status.md
Assets hochladen (Bilder, Audio)assets.md
Mit Remotion verwendenremotion-integration.md
Webhooks einrichtenwebhooks.md

Wann dieses Skill im Vergleich zu Create Video verwenden

Dieses Skill ist für präzise Kontrolle gedacht – du wählst den Avatar, schreibst das exakte Skript, konfigurierst jede Szene.

Wenn der Nutzer einfach nur eine Videoidee beschreiben möchte und der Rest (Skript, Avatar, Visuals) von der KI erledigt werden soll, verwende stattdessen das create-video-Skill.

Nutzer sagtCreate Video SkillDieses Skill
„Erstelle mir ein Video über X“✓
„Erstelle eine Produktdemo“✓
„Ich will, dass Avatar Y genau Z sagt“✓
„Mehrszenenvideo mit verschiedenen Hintergründen“✓
„Transparentes WebM für Compositing“✓
„Verwende diese spezifische Stimme für mein Skript“✓
„Generiere Videos in Serie mit exakten Spezifikationen“✓

Referenzdateien

Kern-Videocreation

Videoanpassung

Erweiterte Funktionen

Integration

Grundlagen

Best Practices

  1. Avatare vor dem Generieren in der Vorschau anzeigen — Lade preview_image_url herunter, damit der Nutzer den Avatar vor der Beauftragung sehen kann
  2. Standardstimme des Avatars verwenden — Die meisten Avatare haben eine vorgegebene default_voice_id, die für natürliche Ergebnisse optimiert ist
  3. Fallback: Geschlecht manuell abgleichen — Falls keine Standardstimme vorhanden ist, stelle sicher, dass Avatar- und Stimmgeschlecht übereinstimmen
  4. Testmodus für die Entwicklung verwenden — Setze test: true, um keine Credits zu verbrauchen (Ausgabe wird mit Wasserzeichen versehen)
  5. Großzügige Timeouts setzen — Die Videogenerierung dauert oft 5-15 Minuten, manchmal länger
  6. Eingaben validieren — Überprüfe, ob Avatar- und Stimm-IDs existieren, bevor die Generierung startet

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

Zuhair-01/claude-skills-and-systems

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Zuhair-01/claude-skills-and-systems

Edit existing videos using AI — remix style, upscale, remove background, and add audio via fal.ai's hosted video models.

Zuhair-01/claude-skills-and-systems

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Zuhair-01/claude-skills-and-systems

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Zuhair-01/claude-skills-and-systems

Read-only queue dashboard for workspace-aware ship. (gstack)

Zuhair-01/claude-skills-and-systems

Generate HeyGen presenter videos via the v3 Video Agent pipeline — handles Frame Check (aspect ratio correction), prompt engineering, avatar resolution, and voice selection. Required for any HeyGen video generation. Replaces deprecated endpoints with v3. Use when: (1) generating any HeyGen video (via API or otherwise), (2) sending a personalized video message (outreach, update, announcement, pitch, knowledge), (3) creating a HeyGen presenter-led explainer, tutorial, or product demo with a human face, (4) "make a video of me saying...", "send a video to my leads", "record an update for my team", "create a video pitch", "make a loom-style message", "I want to appear in this video", "generate a HeyGen video", "make a talking head video". Accepts avatar_id from heygen-avatar for identity-first HeyGen videos, or uses a stock presenter. Returns video share URL + HeyGen session URL for iteration. Chain signal: when the user wants to create/design an avatar AND make a video in the same request, run heygen-avatar f...

Zuhair-01/claude-skills-and-systems

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Zuhair-01/claude-skills-and-systems

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Zuhair-01/claude-skills-and-systems

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Verwandte Skills