Communitygithub.com

BintzGavin/helios-skills

Flujo de trabajo guiado de principio a fin para crear un video de prueba social o testimonio. Extrae la identidad de marca del repositorio, genera una banda sonora cálida y produce una composición motion.dev que fomenta la confianza, renderizada mediante Helios CLI. Úsalo para crear videos de testimonios de clientes, destacar reseñas o videos de prueba social.

¿Qué es helios-skills?

Este skill proporciona un pipeline completo para la creación de videos de prueba social o testimonios. Está diseñado para agentes de IA que operan en el contexto de la marca (ya sea analizando su repositorio o investigando una URL proporcionada). El proceso abarca nueve pasos: desde la recopilación de contexto y la instalación de dependencias, hasta la extracción de inteligencia de marca, generación de música original con ElevenLabs, sincronización con latidos mediante ffmpeg, especificación creativa con motion.dev, implementación DOM en un archivo `composition.html`, y renderizado final con Helios CLI. El resultado es un video MP4 de alta calidad que alinea citas, atribuciones y elementos visuales con una banda sonora cálida y ascendente. Soporta cualquier proyecto que utilice motion.dev, Helios, y requiere opcionalmente una clave `ELEVEN_LABS_API_KEY`. Es ideal para desarrolladores y creadores de contenido que buscan una solución automatizada y profesional para videos de prueba social que refuercen la confianza y la credibilidad de la marca.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/guided/testimonial-video

Preguntar en tu IA favorita

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

Documentación

Puede que estés operando dentro del repositorio de la marca, o trabajando desde un contexto externo.

No adivines la identidad de la marca. Analiza el código base o investiga la URL proporcionada.


PIPELINE DE EJECUCIÓN

PASO 1 — Recopilar Contexto

⛔ DETENTE. Pregunta al usuario estas dos preguntas:

  1. "¿Estamos dentro del repositorio de tu marca, o prefieres proporcionar una URL (por ejemplo, tu sitio de marketing) para que pueda investigar tu marca en línea?"

  2. "¿Te gustaría tener música de fondo generada? Si es así, necesitarás una ELEVEN_LABS_API_KEY en tu entorno. Puedes obtener una en https://elevenlabs.io → Perfil → API Keys."

Espera a que el usuario responda ambas preguntas.

No intentes leer archivos .env ni verificar las llaves por ti mismo. Confía en las respuestas del usuario.

Si el usuario proporciona una URL, úsala para la investigación de marca en el PASO 3 en lugar de analizar el código base. Si el usuario rechaza la música, salta el PASO 4 y el PASO 5.


PASO 2 — Asegurar las Dependencias del Runtime de Helios

Instalar los paquetes necesarios:

npm install @helios-project/core @helios-project/renderer @helios-project/cli

Renderizarás usando el modo DOM.


PASO 3 — Extraer Inteligencia de Marca del Repositorio

Si el usuario proporcionó una URL en lugar de un repositorio, obtén esa URL y extrae las mismas señales de marca del sitio en vivo. Omite los elementos específicos del código base (configuración de Tailwind, tokens de diseño, etc.) y concéntrate en los elementos visibles de la marca.

Analiza:

• Configuración de Tailwind o variables CSS • Hojas de estilo globales • Tokens de diseño • Activos de logotipo • Favicon • Secciones o componentes de testimonios • Visualizaciones de reseñas/calificaciones • Logotipos de clientes o secciones de socios • Insignias de confianza o marcas de certificación • Patrones de prueba social (contadores, estadísticas, logotipos) • Copia de marketing y propuestas de valor • Estructura de CTA

Construye un perfil de marca interno:

• Propuesta de valor central • Audiencia objetivo • Tono de voz (cálido, auténtico, digno de confianza) • Densidad visual • Paleta primaria • Paleta de acentos (tonos cálidos para generar confianza) • Carácter tipográfico • Estrategia de prueba social (citas, estadísticas, logotipos o combinación)

Todas las decisiones creativas deben alinearse con esto.


PASO 4 — Generar Música Original (Saltar si no hay música)

Usa ElevenLabs con la ELEVEN_LABS_API_KEY existente.

Genera una pista instrumental que coincida con:

• Tono cálido y edificante • Suave construcción hasta un clímax emocional • Inspiradora pero no agresiva • Duración objetivo

Guarda el audio localmente.


PASO 5 — Analizar el Audio con ffmpeg (Saltar si no hay música)

Extraer:

• BPM • Marcas de tiempo de los beats • Tiempos fuertes • Picos de energía

Crear un mapa de sincronización de beats.

Las revelaciones de citas deben caer en los tiempos fuertes. Las revelaciones de nombre/título deben alinearse con los beats.


PASO 6 — Leer las Reglas de Diseño de Movimiento

Antes de producir la especificación creativa, lee e interioriza:

skills/guided/motion-design-rules

Cada regla de ese skill es obligatoria para esta composición.


PASO 7 — Producir la Especificación Creativa

Eres un director creativo senior y arquitecto de confianza de marca que diseña para Helios usando motion.dev.

Ejemplo de entrada: haz un video testimonial de 30 segundos

Salida:

• Una especificación creativa estructurada • Envuelta en un solo bloque de código • Sin explicación fuera de él

La especificación debe incluir:

• Duración • Relación de aspecto (16:9) • Resumen de marca • Lenguaje de movimiento (cálido, elegante, deliberado) • Desglose de escenas sincronizadas con los beats • Marcas de tiempo exactas • Voz en off (opcional — se puede usar solo texto) • Texto en pantalla (citas, atribución, estadísticas, CTA) • Composición visual (tarjetas de citas, avatares, calificaciones de estrellas, logotipos de clientes) • Comportamiento de animación explícito de motion.dev • Lógica de transiciones (fundidos suaves, deslizamientos suaves, escala sutil) • Orden de capas (textura de fondo → tarjeta de cita → avatar/foto → atribución → estadísticas) • Dirección de audio • Requisitos de activos • Jerarquía tipográfica (texto de cita grande, atribución más pequeña, estadísticas destacadas)

Usa únicamente terminología compatible con motion.dev.

Requisitos de estructura de testimonio:

• Momento de apertura de marca o contextualizador (2-3 segundos) • Cita 1: Cita completa con atribución • Cita 2: Cita completa con atribución (si la duración lo permite) • Estadísticas de prueba social (números, calificaciones, recuento de clientes) • CTA de cierre con la marca

Cada segmento de cita: • El texto de la cita aparece con animación (máquina de escribir o fundido por línea) • Breve pausa para lectura • Aparece la atribución (nombre, cargo, empresa) • Opcional: logotipo o avatar de la empresa del cliente


PASO 8 — Implementar la Composición DOM de Helios

Usando la especificación creativa:

Crea un archivo composition.html que:

• Use HTML + CSS + motion.dev • Implemente animaciones usando WAAPI / CSS / motion.dev • Alinee las revelaciones de citas con los tiempos fuertes • Use tipografía elegante de tarjetas de citas • Incluya elementos decorativos de comillas • Incluya el archivo de audio generado • Tenga la duración exacta

Expón el runtime de Helios:

import { helios } from "@helios-project/core";

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

Requisitos:

• window.helios debe estar definido • helios.bindToDocumentTimeline() debe ser llamado • autoSyncAnimations: true debe estar habilitado • Todas las animaciones CSS y WAAPI deben sincronizarse correctamente • Sin aleatoriedad • Temporización determinista • Las citas deben permanecer legibles durante un mínimo de 4 segundos cada una • Las calificaciones de estrellas deben animarse secuencialmente


PASO 9 — Renderizar Usando la CLI Oficial de Helios (Modo DOM)

Renderiza con:

npx @helios-project/cli render ./composition.html -o output.mp4

Requisitos:

• Relación de aspecto 16:9 • Duración correcta • Audio adjunto • CSS y WAAPI completamente sincronizados • Salida MP4 de alta calidad

El archivo de salida debe ser:

output.mp4


REGLAS DE EJECUCIÓN

Si la duración es ≤ 15 segundos Muestra 1 cita + 1 estadística + CTA. Prioriza la cita más fuerte.

Si no se especifica la duración Valor predeterminado: 30 segundos.

Máximo 3 citas para cualquier duración. Las citas deben ser reales o representativas — nunca inventes. Si no existen testimonios en el repositorio, usa una estructura de marcador de posición con etiquetas claras.

Nunca replantees la pregunta original. Nunca expliques el razonamiento. La especificación creativa debe imprimirse solo dentro de un único bloque de código.

Individual skills in this repo

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

BintzGavin/helios-skills

Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code. Write one HTML page that draws any frame from its time t, render it frame-exact to MP4 with Helios, check stills and contact sheets, and add a soundtrack. Use whenever the user asks for a video or an animation file.

BintzGavin/helios-skills

>- Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic or motion-driven video (Helios, Remotion, explainers, loops, UI capture, logo reveals), or when the user asks for motion direction, pacing, or visual-story structure.

BintzGavin/helios-skills

>- End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished brand films for any SaaS or consumer product—not category-specific; pair with skills/design/animated-video-philosophy for broader motion principles.

BintzGavin/helios-skills

Patterns for using Helios with Framer Motion. Use when you want to use Framer Motion's physics and transitions but need frame-perfect synchronization with Helios.

BintzGavin/helios-skills

Patterns for using Helios with GSAP (GreenSock). Use when integrating GSAP timelines with the Helios timeline for precise scrubbing and rendering.

BintzGavin/helios-skills

End-to-end guided workflow for creating an explainer or walkthrough video. Extracts brand identity from the repo, generates a measured soundtrack, and produces a narrative-driven motion.dev composition rendered via Helios CLI. Use when making how-it-works, feature walkthrough, or educational videos.

BintzGavin/helios-skills

Motion design framework for programmatic video. Defines anti-slideshow architecture, visual layering, physics-based easing, choreography rules, and quality validation. Reference this skill from any guided video skill.

BintzGavin/helios-skills

End-to-end guided workflow for creating a promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

BintzGavin/helios-skills

Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

Skills relacionados