Communitygithub.com

jakerains/elevenagents-harness

Esta referencia concisa está redactada para el harness. La guía completa del producto se encuentra en la aplicación de escritorio instalada y en la documentación oficial de HyperFrames.

¿Qué es elevenagents-harness?

Este skill proporciona un entorno de integración (harness) para crear composiciones multimedia interactivas y animadas dentro de HyperFrames, con un enfoque específico en la generación de audio mediante ElevenLabs. Permite definir composiciones HTML con animaciones GSAP controladas, gestionar pistas de clips multimedia (audio y vídeo) y ejecutar flujos de trabajo de verificación (lint, check, timeline, inspect). Es especialmente útil para desarrolladores que desean crear prototipos o contenido interactivo con sincronización precisa de audio generado por IA, como narraciones o efectos de sonido. Compatible con herramientas de línea de comandos y se integra con el agente Claude Code, Cursor o Codex para facilitar la edición guiada por IA. El skill se ejecuta localmente en el escritorio y se comunica con la API de ElevenLabs usando la clave del usuario, lo que permite generar archivos MP3 reales que se incorporan directamente a la composición.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jakerains/elevenagents-harness/tree/HEAD/references/hyperframes-core

Preguntar en tu IA favorita

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

Documentación

Referencia de creación de HyperFrames para este puente

Esta referencia concisa está redactada para el harness. La guía completa del producto se encuentra en la aplicación de escritorio instalada y en la documentación oficial de HyperFrames.

Composición

Un archivo index.html independiente tiene una raíz de composición directamente en el body. Usa data-composition-id, data-width, data-height y un data-duration finito. El CSS width/height de la raíz son 100%; las dimensiones del canvas pertenecen a sus atributos data. Una subcomposición usa una plantilla con sus estilos/scripts en su interior.

Asigna a los clips la clase clip, con data-start/data-duration intencionados y data-track-index. Una pista es un carril de Studio, no una restricción de tiempo ni un z-index. La duración raíz debe incluir el final de todos los clips previstos. Conserva la temporización, los identificadores y los medios no relacionados al editar.

Registra una línea de tiempo de GSAP pausada en window.__timelines[compositionId], usando el mismo ID que la raíz. Anima los elementos internos; el framework controla la visibilidad del clip y la búsqueda de medios. No animes clip display, visibility o autoAlpha. Evita conflictos entre CSS-transform y GSAP, relojes, temporizadores, aleatoriedad no inicializada y estados de animación dependientes de red.

Usa medios locales reproducibles. Cada elemento de audio necesita un ID único y una temporización intencionada. Evita crossorigin en medios y ancestros temporizados anidados alrededor de un vídeo con data-start. Las rutas de archivo deben coincidir con los activos reales del proyecto.

Flujo de trabajo

Lee los archivos relevantes y la guía requerida de la aplicación antes de editar. Ajusta el alcance de la solicitud del usuario. No afirmes ejecutar herramientas MCP no disponibles o comandos de shell. El puente expone comandos con nombre: lint, check, timeline e inspect.

Ejecuta verificaciones con nombre significativas, informa su estado de salida real y los hallazgos, y conserva el trabajo no relacionado. Un error de lint puede impedir que se ejecuten las auditorías de runtime/layout/contraste; cero muestras no establecen una validación visual exitosa. Pasar el lint no es prueba de calidad visual.

Renderiza solo cuando el usuario solicita una exportación y app_rules lo permiten. Consulta render_status hasta un estado terminal; nunca afirmes que una exportación no finalizada fue exitosa. La aplicación de escritorio puede gestionar la exportación por sí misma, en cuyo caso sigue sus app_rules.

Activos de audio

Cuando esté habilitado localmente y se solicite, list_voices devuelve los IDs de voz disponibles del usuario. create_speech y create_sound_effect devuelven archivos MP3 reales relativos al proyecto. Usa la ruta devuelta en la composición con un ID de audio único y una temporización adecuada. Si la generación falla, informa del fallo y no inventes un activo ni lo reintentes automáticamente.

El habla y los efectos de sonido son llamadas a la API del producto realizadas con la propia clave del usuario. Los scripts/descripciones se envían a ElevenLabs y la generación puede consumir créditos. El chat permanece solo texto. La generación de música e imagen/vídeo no están expuestas en esta versión.

Skills relacionados