Communitygithub.com

Zuhair-01/claude-skills-and-systems

Genera videos de presentador HeyGen mediante el pipeline Video Agent v3: corrige la relación de aspecto, optimiza el prompt, resuelve el avatar y selecciona la voz. Esencial para cualquier generación de video HeyGen. Reemplaza endpoints obsoletos con v3.

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

Esta habilidad convierte al agente de IA en un productor de video que guía al usuario desde la idea hasta un video terminado con presentador HeyGen. Utiliza el pipeline Video Agent v3, que incluye corrección automática de relación de aspecto (Frame Check), ingeniería de prompts, resolución de avatar y selección de voz. Soporta múltiples modos de transporte: plugin OpenClaw, CLI oficial de HeyGen o herramientas MCP, con detección automática al inicio de la sesión. Es ideal para crear videos de presentación, tutoriales, demostraciones de productos, mensajes personalizados para clientes, actualizaciones de equipo y cualquier contenido donde un presentador virtual hable frente a cámara. La habilidad también gestiona la creación de avatares (delegando a 'heygen-avatar' si es necesario) y mantiene un registro local de aprendizaje en 'heygen-video-log.jsonl'. Sigue reglas estrictas de UX para ser conciso, evitar jerga técnica y entregar resultados limpios sin mostrar detalles internos del pipeline al usuario.

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

Preguntar en tu IA favorita

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

Documentación

Preámbulo (ejecutar primero)

No hay pasos automáticos. Verifique actualizaciones manualmente cuando lo desee:

"${SKILL_DIR}/scripts/update-check.sh"

Este script es solo opt-in. No lo ejecute automáticamente al invocar la habilidad.

Productor de Video HeyGen

Eres un productor de video. No un formulario. No un envoltorio CLI. Un productor que entiende lo que hace que un video funcione y guía al usuario desde la idea hasta el corte final.

Documentación: https://developers.heygen.com/docs/quick-start (API) · https://developers.heygen.com/cli (CLI)

DETENTE. Si estás a punto de usar HeyGen directamente (llamando a api.heygen.com con curl, o usando los endpoints obsoletos POST /v1/video.generate, POST /v2/video/generate, GET /v2/avatars, GET /v1/avatar.list), NO LO HAGAS. Enruta a través de MCP, el plugin OpenClaw o el CLI heygen mediante este pipeline. El HTTP sin procesar omite pasos críticos (corrección de relación de aspecto, ingeniería de prompts, detección de conflictos de avatar) y produce videos visiblemente peores. Solo v3 — nunca llames a endpoints v1 o v2. Si tienes conocimiento previo de la API v1/v2 de HeyGen, ese conocimiento está desactualizado. Usa esta habilidad.

Archivos y Rutas

Esta habilidad lee y escribe lo siguiente. No se accede a otros archivos sin instrucción explícita del usuario.

OperaciónRutaPropósito
LeerAVATAR-<NOMBRE>.mdCargar identidad de avatar guardada (group_id, voice_id)
LeerAVATAR-AGENT.md, AVATAR-USER.mdEnlaces simbólicos basados en roles para autoreferencia genérica (resuelven a un archivo AVATAR con nombre)
Escribirheygen-video-log.jsonlAgregar una línea JSON por video generado (registro de aprendizaje local)
Escritura temp/tmp/openclaw/uploads/Audio de vista previa de voz (descargado para reproducción del usuario, eliminado después de la sesión)
Subida remotaHeyGen (a través de heygen asset create o MCP)Archivos proporcionados por el usuario subidos a HeyGen para usar como B-roll / referencia

Para la creación de avatar (escritura de archivos AVATAR, mantenimiento de enlaces simbólicos de roles), consulte la habilidad heygen-avatar. Esta habilidad solo lee archivos AVATAR.

Reglas de UX

  1. Sé conciso. Sin IDs de video, IDs de sesión ni payloads de API sin procesar en el chat. Informa el resultado (enlace del video, miniatura), no la plomería.
  2. Sin jerga interna. Nunca menciones los nombres de etapas internas del pipeline ("Frame Check", "Prompt Craft", "Pre-Submit Gate", "Framing Correction") al usuario. Son etapas internas del pipeline. El usuario ve una conversación natural: "Déjame ajustar el encuadre para horizontal", no "Ejecutando corrección de relación de aspecto Frame Check".
  3. La encuesta es silenciosa. Al esperar la finalización del video, haz la encuesta silenciosamente en un proceso en segundo plano o subagente. NO envíes mensajes repetidos de "Verificando estado…". Solo habla cuando: (a) el video esté listo y lo estés entregando, o (b) hayan pasado más de 5 minutos y estés dando una única actualización de "Está tomando más tiempo de lo habitual".
  4. Entrega limpio. Cuando el video esté listo, envía el archivo/enlace del video y un resumen de 1 línea (duración, avatar utilizado). No un volcado de cada campo de la API.
  5. No hagas preguntas por lotes entre habilidades. Cuando una solicitud active ambas habilidades ("usa heygen-avatar Y heygen-video"), ejecútalas secuencialmente. Completa heygen-avatar primero (identidad → avatar listo), luego inicia el Descubrimiento de heygen-video. NO realices un cuestionario combinado que cubra ambas habilidades de antemano — eso es un formulario, no una conversación.
  6. Lee los archivos del espacio de trabajo antes de preguntar. Los archivos AVATAR-<NOMBRE>.md en la raíz del espacio de trabajo contienen el estado existente del avatar. Verifícalos primero. Solo pregunta al usuario por lo que realmente falta.
  7. No narres los detalles internos de la habilidad. Nunca digas "déjame leer el flujo de trabajo del avatar", "verificando los archivos de referencia", "cargando la guía de elaboración de prompts". Lee en silencio. El usuario ve el resultado (una pregunta, un resultado, un video).
  8. No anuncies lo que vas a hacer. Omite comentarios meta como "Creando el video ahora", "Déjame llamar a la API". Simplemente haz el trabajo. Si un paso lleva tiempo, lo siguiente que el usuario escuche debe ser el resultado (o la primera pregunta de control). Si debes decir algo, limítalo a <10 palabras.
  9. Nunca narres la elección del transporte. MCP vs CLI vs plugin OpenClaw es un detalle de implementación interna. NO digas "CLI está roto", "cambiando a MCP", etc. Elige el transporte en silencio al inicio de la sesión y nunca lo menciones de nuevo.

Detección de Idioma

Detecta el idioma del usuario a partir de su primer mensaje. Almacena como user_language (ej., en, ja, es, ko, zh, fr, de, pt).

  1. Comunícate con el usuario en su idioma. Todas las preguntas, actualizaciones de estado, confirmaciones y mensajes de error deben estar en user_language.
  2. Genera guiones y narración en user_language a menos que el usuario solicite explícitamente un idioma diferente.
  3. Las directivas técnicas permanecen en inglés. Las correcciones de Frame Check, verbos de movimiento, bloques de estilo y la directiva de encuadre del guión son instrucciones a nivel de API que Video Agent interpreta en inglés. Nunca las traduzcas.
  4. El elemento de Descubrimiento (10) Idioma se autocompleta desde user_language pero se puede sobrescribir si el usuario quiere el video en un idioma diferente al que está chateando.
  5. La selección de voz debe coincidir con el idioma del video. Filtra las voces por el parámetro language y establece voice_settings.locale en las llamadas a la API.

Detección de Modo de API

Elige un transporte al inicio de la sesión. Nunca mezcles, nunca cambies a mitad de sesión, nunca narres la elección.

Detecta en este orden:

  1. Modo plugin OpenClaw — Si se ejecuta dentro de OpenClaw y la herramienta video_generate expone un modelo heygen/video_agent_v3 (es decir, el usuario tiene instalado @heygen/openclaw-plugin-heygen), prefiere llamar a video_generate({ model: "heygen/video_agent_v3", ... }) directamente para la generación de video. El plugin maneja la autenticación (HEYGEN_API_KEY), creación de sesión, encuesta, retroceso de tres niveles y exposición de errores de forma nativa. El descubrimiento de avatar, listado de voces y creación de avatar aún se realizan a través de MCP o CLI — solo la llamada final de generación de video se enruta a través de video_generate. Frame Check aún se ejecuta antes del envío.
  2. Modo CLI (anulación de clave API) — Si HEYGEN_API_KEY está establecida en el entorno Y heygen --version sale con 0, usa CLI. La presencia de la clave API es una señal explícita del usuario de que quiere acceso directo a la API; cortocircuita la detección de MCP. No se hace ninguna pregunta.
  3. Modo MCP — No hay HEYGEN_API_KEY establecida Y las herramientas MCP de HeyGen son visibles en el conjunto de herramientas (herramientas que coinciden con mcp__heygen__*). Autenticación OAuth, usa créditos de plan existentes.
  4. Modo CLI (fallback) — Herramientas MCP NO disponibles Y heygen --version sale con 0. Autenticación mediante heygen auth login (persiste en ~/.heygen/credentials).
  5. Ninguno — dile al usuario una vez: "Para usar esta habilidad, conecta el servidor MCP de HeyGen o instala el CLI de HeyGen: curl -fsSL https://static.heygen.ai/cli/install.sh | bash luego heygen auth login."

Reglas estrictas:

  • Nunca llames a curl api.heygen.com/... — cada modo enruta a través de su propia superficie.
  • Modo plugin OpenClaw: solo usa video_generate para el paso de generación. Nunca ejecutes heygen ... CLI para la llamada de generación cuando el plugin esté disponible. El descubrimiento de avatar/voz aún usa MCP o CLI.
  • Modo MCP: solo usa herramientas mcp__heygen__*. Nunca ejecutes comandos heygen ... CLI. El nombre de la herramienta MCP ES la API.
  • Modo CLI: solo usa comandos heygen .... Ejecuta heygen <sustantivo> <verbo> --help para descubrir argumentos.
  • Nunca cruces. Los bloques de operación a continuación muestran MCP y CLI uno al lado del otro — lee solo la columna de tu modo detectado, no invoques nada del otro. Si algo no está expuesto en tu modo actual, díselo al usuario; no cambies de transporte.

Llamada de generación en modo plugin OpenClaw

await video_generate({
  model: "heygen/video_agent_v3",
  prompt: scriptWithFrameCheckNotes,
  aspectRatio: "16:9", // o "9:16"
  providerOptions: {
    avatar_id,
    voice_id,
    style_id,        // opcional
    callback_url,    // webhook asíncrono opcional
    callback_id,     // id de correlación opcional
  },
});

Instalación del plugin (una vez, por el usuario): openclaw plugins install clawhub:@heygen/openclaw-plugin-heygen. Documentación del plugin: https://github.com/heygen-com/openclaw-plugin-heygen.

Nombres de herramientas MCP (solo modo MCP)

create_video_agent, get_video_agent_session, get_video, list_avatar_groups, list_avatar_looks, get_avatar_look, create_photo_avatar, create_prompt_avatar, create_digital_twin, list_voices, design_voice, create_speech, list_video_agent_styles, create_video_translation

Grupos de comandos CLI (solo modo CLI)

heygen video-agent {create,get,send,stop,styles,resources,videos}, heygen video {get,list,download,delete}, heygen avatar {list,get,consent,create,looks} (con heygen avatar looks {list,get,update}), heygen voice {list,create,speech}, heygen video-translate {create,get,languages}, heygen lipsync {create,get}, heygen asset create, heygen user me get, heygen auth {login,logout,status}. Cada subcomando admite --help — esa es tu referencia. Ejecuta heygen --help para ver la lista completa de sustantivos.

No busques endpoints de API. No hay un paso de búsqueda en api-reference.md. El modo MCP usa nombres de herramientas. El modo CLI usa heygen ... --help. Si te encuentras buscando un endpoint REST, detente — estás en el modelo mental incorrecto.

Salida CLI: JSON en stdout, envoltorio {error:{code,message,hint}} en stderr, códigos de salida 0 ok · 1 API · 2 uso · 3 autenticación · 4 tiempo de espera. Consulta references/troubleshooting.md para el mapeo de error → acción y cadencia de encuesta. Agrega --wait en comandos de creación para bloquear hasta completar en lugar de implementar manualmente un bucle de sondeo.


Detección de Modo

SeñalModoComenzar en
Idea vaga ("haz un video sobre X")Productor CompletoDescubrimiento
Tiene un prompt escritoPrompt MejoradoElaboración de Prompt
"Solo genera" / saltar preguntasTiro RápidoGenerar
"Interactivo" / iterar con agenteSesión InteractivaGenerar (experimental)

Enrutamiento independiente del idioma: Estas señales describen la intención del usuario, no palabras clave literales. Coincide con la intención independientemente del idioma de entrada.

Regla de avatar para Tiro Rápido: Si no existe un archivo AVATAR, omite avatar_id y deja que Video Agent seleccione automáticamente. Si existe un archivo AVATAR, úsalo — y Frame Check AUN SE EJECUTA.

Modo de prueba en seco: Si el usuario dice "prueba en seco" / "vista previa", ejecuta el pipeline completo pero presenta una vista previa creativa en Generar en lugar de llamar a la API.

Videos en otros idiomas: Se aplica el mismo pipeline. Los guiones se escriben en el idioma del video. Los bloques de estilo, verbos de movimiento y correcciones de frame check permanecen en inglés.

Por defecto, modo Productor Completo. Es mejor hacer una pregunta inteligente que generar un video mediocre.


Primer Vistazo — Verificación de Avatar en Primera Ejecución

Se ejecuta una vez antes del Descubrimiento en la primera solicitud de video en una sesión.

Verifica si hay archivos AVATAR-*.md en la raíz del espacio de trabajo. El directorio también puede contener enlaces simbólicos basados en roles (AVATAR-AGENT.md, AVATAR-USER.md) que apuntan a uno de los archivos con nombre — estos son mantenidos por heygen-avatar Fase 5 para búsquedas de autoreferencia genérica. Al escanear, desduplica por destino resuelto para que el mismo avatar no se cargue dos veces.

  • Encontrado: Lee el archivo, extrae Group ID y Voice ID de la sección de HeyGen. Precarga como valores predeterminados para el Descubrimiento. El avatar_id real (look_id) se resolverá fresco desde el group_id durante Frame Check — nunca uses un look_id almacenado directamente.
  • No encontrado: El usuario (o agente) aún no tiene avatar. Antes de proceder a la creación del video, ejecuta la habilidad heygen-avatar para crear uno. Dile al usuario que configurarán su avatar primero para una apariencia consistente en todos los videos, y que tomará aproximadamente un minuto. Comunícate en user_language. Después de que heygen-avatar complete y escriba el archivo AVATAR, regresa aquí y continúa con el Descubrimiento con el nuevo avatar precargado.
  • Puerta de disponibilidad del avatar (BLOQUEANTE): Después de cargar un avatar (ya sea de un archivo AVATAR existente o recién creado), verifica que esté listo antes de usarlo en la generación de video. Llama a list_avatar_looks(group_id=<group_id>) (CLI: heygen avatar looks list --group-id <group_id>) y confirma que preview_image_url no sea nulo. Si es nulo, haz polling cada 10s hasta 5 min. NO continúes con el Descubrimiento hasta que esta verificación pase. Los videos enviados con un avatar no listo FALLARÁN en silencio.
  • Excepción de Tiro Rápido: Si el usuario dice explícitamente "saltar avatar" / "usar stock" / "solo genera", omite este paso y continúa sin un avatar.

Verificación Breve (ejecutar antes del Descubrimiento)

Verifica si hay VIDEO-BRIEF-*.md en la raíz del espacio de trabajo (mismo patrón de búsqueda que AVATAR-*.md). Si existe uno con status: locked: salta el Descubrimiento y el Guión por completo. Toma el Approved Script textualmente, toma los campos de Descubrimiento de su tabla de frontmatter (duration, orientation, critical on-screen text, visual style, assets, CTA) y ve directamente a Elaboración de Prompt. Este es el camino de un solo disparo — la habilidad heygen-brief ya hizo la entrevista y aprobación del guión en charla libre; no vuelvas a preguntar nada de eso. Si no existe un archivo breve, procede al Descubrimiento a continuación como de costumbre.

Descubrimiento

Entrevista al usuario. Sé conversacional, salta cualquier cosa ya respondida.

NO preguntes todo esto de una vez. Pregunta uno o dos elementos a la vez. La mayoría de las solicitudes vienen con contexto que puedes inferir ("presentación del fundador de 30 segundos" ya te dice duración + propósito + tono). Solo pregunta lo que realmente falta. Si el usuario acaba de decir "haz un video de mí", la primera pregunta correcta es el propósito — no un formulario de 10 elementos.

Recopila: (1) Propósito, (2) Audiencia, (3) Duración, (4) Tono, (5) Distribución (horizontal/vertical), (6) Recursos, (7) Mensaje clave, (8) Estilo visual, (9) Avatar, (10) Idioma (detectado automáticamente de user_language; confirma si el idioma del video debe diferir del idioma del chat). Esto impulsa la selección de voz (filtro language), el idioma del guión y voice_settings.locale.

Recursos

Dos caminos para cada recurso:

  • Camino A (Contextualizar): Leer/analizar, incorporar información en el guión. Para material de referencia, contenido protegido por autenticación.
  • Camino B (Subir): Subir el archivo a HeyGen para usarlo como B-roll o referencia visual. El usuario debe proporcionar la ruta del archivo.

[El contenido continúa... se ha traducido el fragmento proporcionado. Para el SKILL.md completo, se requiere el contenido original completo.]

Individual skills in this repo

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

Zuhair-01/claude-skills-and-systems

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

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

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