Communitygithub.com

Zuhair-01/claude-skills-and-systems

Crea videos con avatares de IA con control preciso sobre avatares, voces, guiones, escenas y fondos usando la API v2 de HeyGen.

¿Qué es claude-skills-and-systems?

Esta habilidad permite generar videos profesionales con avatares de IA, ofreciendo control completo sobre cada aspecto: desde la selección del avatar y la voz, hasta la escritura exacta del guion, la configuración de múltiples escenas con fondos personalizados y la creación de videos WebM transparentes para composición. Es ideal para producciones que requieren consistencia de marca, integración con Remotion, o generación por lotes con especificaciones exactas. Funciona a través de la API v2 de HeyGen (`/v2/video/generate`), autenticada mediante `X-Api-Key`, y recomienda el uso de las herramientas MCP de HeyGen (`mcp__heygen__*`) en lugar de llamadas HTTP directas cuando estén disponibles. Incluye guías detalladas para avatares, voces, guiones, fondos, subtítulos, superposiciones de texto, plantillas, avatares a partir de fotos, y más.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Video con Avatar

Crea videos con avatares de IA con control total sobre avatares, voces, guiones, escenas y fondos. Construye videos de una o múltiples escenas con configuración exacta usando la API /v2/video/generate de HeyGen.

Autenticación

Todas las solicitudes requieren el encabezado X-Api-Key. Configura la variable de entorno HEYGEN_API_KEY.

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

Selección de Herramientas

Si las herramientas MCP de HeyGen están disponibles (mcp__heygen__*), prefiérelas sobre las llamadas HTTP directas a la API — gestionan la autenticación y el formato de las solicitudes automáticamente.

TareaHerramienta MCPAlternativa (API Directa)
Verificar estado del video / obtener URLmcp__heygen__get_videoGET /v2/videos/{video_id}
Listar videos de la cuentamcp__heygen__list_videosGET /v2/videos
Eliminar un videomcp__heygen__delete_videoDELETE /v2/videos/{video_id}

La generación de video (POST /v2/video/generate) y el listado de avatares/voces se realizan mediante llamadas directas a la API — consulta los archivos de referencia a continuación.

Flujo de Trabajo Predeterminado

  1. Listar avatares — GET /v2/avatars → elige un avatar, previsualízalo, anota avatar_id y default_voice_id. Consulta avatars.md
  2. Listar voces (si es necesario) — GET /v2/voices → elige una voz que coincida con el género/idioma del avatar. Consulta voices.md
  3. Escribir el guion — Estructura las escenas con un concepto cada una. Consulta scripts.md
  4. Generar el video — POST /v2/video/generate con avatar, voz, guion y fondo por escena. Consulta video-generation.md
  5. Consultar hasta completar — GET /v2/videos/{video_id} hasta que el estado sea completed. Consulta video-status.md

Referencia Rápida

TareaLeer
Listar y previsualizar avataresavatars.md
Listar y seleccionar vocesvoices.md
Escribir y estructurar guionesscripts.md
Generar video (una o varias escenas)video-generation.md
Añadir fondos personalizadosbackgrounds.md
Añadir subtítuloscaptions.md
Añadir superposiciones de textotext-overlays.md
Crear video WebM transparentevideo-generation.md (sección WebM)
Usar plantillastemplates.md
Crear avatar a partir de una fotophoto-avatars.md
Verificar estado del video / descargarvideo-status.md
Subir recursos (imágenes, audio)assets.md
Usar con Remotionremotion-integration.md
Configurar webhookswebhooks.md

Cuándo Usar Esta Habilidad vs. Crear Video

Esta habilidad es para control preciso — tú eliges el avatar, escribes el guion exacto, configuras cada escena.

Si el usuario solo quiere describir una idea de video y dejar que la IA se encargue del resto (guion, avatar, visuales), usa la habilidad crear-video en su lugar.

El Usuario DiceHabilidad Crear VideoEsta Habilidad
"Hazme un video sobre X"✓
"Crea una demostración de producto"✓
"Quiero que el avatar Y diga exactamente Z"✓
"Video de múltiples escenas con diferentes fondos"✓
"WebM transparente para composición"✓
"Usa esta voz específica para mi guion"✓
"Genera lotes de videos con especificaciones exactas"✓

Archivos de Referencia

Creación de Video Principal

Personalización de Video

Funcionalidades Avanzadas

Integración

Fundamentos

Mejores Prácticas

  1. Previsualizar avatares antes de generar — Descarga preview_image_url para que el usuario pueda ver el avatar antes de comprometerse
  2. Usar la voz predeterminada del avatar — La mayoría de los avatares tienen un default_voice_id pre-asociado para resultados naturales
  3. Alternativa: igualar género manualmente — Si no hay voz predeterminada, asegúrate de que los géneros del avatar y la voz coincidan
  4. Usar modo de prueba para desarrollo — Configura test: true para evitar consumir créditos (el resultado tendrá marca de agua)
  5. Establecer tiempos de espera generosos — La generación de video suele tardar entre 5 y 15 minutos, a veces más
  6. Validar entradas — Verifica que los IDs de avatar y voz existan antes de generar

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.

Skills relacionados