Communitygithub.com

BintzGavin/helios-skills

Flujo de trabajo para renderizar una composición de Helios a un archivo de video. Útil cuando necesitas automatizar la producción de video o exportar una animación de alta calidad.

¿Qué es helios-skills?

Esta habilidad proporciona un flujo de trabajo completo para renderizar composiciones de Helios a archivos de video (por ejemplo, MP4) utilizando el paquete `@helios-project/renderer` en un entorno Node.js. Está diseñada para desarrolladores y creadores de contenido que necesitan automatizar la producción de video, exportar animaciones de alta calidad o integrar renderizado en pipelines CI/CD. Compatible con plataformas como Claude Code, Cursor y Codex, la habilidad ofrece dos enfoques: un comando rápido `npx` para casos simples y un script programático para flujos de trabajo personalizados que requieren props de entrada, múltiples pistas de audio o callbacks de progreso. La habilidad guía al usuario a través de los prerrequisitos (URL de la composición), la creación de un script de renderizado con configuraciones detalladas como dimensiones, FPS, duración, pistas de audio y props dinámicos, y la ejecución del renderizado. También incluye una sección de solución de problemas para errores comunes como tiempos de espera, salida negra o problemas de audio, lo que la convierte en una herramienta integral y práctica para la automatización de video basada en Helios.

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

Preguntar en tu IA favorita

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

Documentación

Flujo de trabajo de renderizado de video

El renderizado es el proceso de capturar una composición fotograma por fotograma y codificarla en un archivo de video (por ejemplo, MP4). Esto se realiza con el paquete @helios-project/renderer en un entorno Node.js.

El camino rápido: un solo comando

npx -y @helios-project/cli@latest render composition.html -o output.mp4
  • La duración, FPS y tamaño provienen de window.helios de la composición. Para configurarlos tú mismo, pasa --duration, --fps, --width y --height.
  • Una página que se dibuja a sí misma con window.renderAt(t) necesita --duration.
  • --audio track.mp3 añade una banda sonora.
  • Un archivo HTML simple se renderiza directamente desde el disco. Si un bundler tiene que construir la composición, ejecuta npm run dev y pasa su URL en su lugar.

Usa el script a continuación solo cuando necesites un pipeline personalizado, como props de entrada, varias pistas de audio o callbacks de progreso.

1. Prerrequisitos

El renderizador necesita una URL para la composición:

  • Un archivo en disco: file:///path/to/composition.html
  • Un servidor de desarrollo: npm run dev, por ejemplo http://localhost:3000/composition.html
  • Cualquier otra URL accesible

2. Crear script de renderizado

Crea un archivo llamado render.js (o render.ts si usas ts-node).

import { Renderer } from '@helios-project/renderer';
import path from 'path';

async function main() {
    // 1. Configuración
    const compositionUrl = 'http://localhost:3000/composition.html';
    const outputPath = path.resolve('output.mp4');

    // 2. Inicializar Renderer
    const renderer = new Renderer({
        width: 1920,
        height: 1080,
        fps: 30,
        durationInSeconds: 10,
        // frameCount: 300, // Opcional: Sobrescribe durationInSeconds con un número exacto de fotogramas
        mode: 'canvas', // Usa 'dom' si tu animación usa elementos CSS/HTML

        // Configuración de audio
        audioTracks: [
            { path: 'background.mp3', volume: 0.5 },
            { path: 'voiceover.wav', offset: 2 }
        ],
        audioCodec: 'aac',

        // Props de entrada (contenido dinámico)
        inputProps: {
            title: "Render personalizado",
            color: "#00ff00"
        }
    });

    console.log(`Iniciando renderizado de ${compositionUrl}...`);

    // 3. Ejecutar renderizado
    try {
        await renderer.render(compositionUrl, outputPath, {
            onProgress: (p) => {
                const percent = Math.round(p * 100);
                process.stdout.write(`\rProgreso: ${percent}%`);
            }
        });
        console.log(`\n¡Listo! Guardado en ${outputPath}`);
    } catch (err) {
        console.error('\nRenderizado falló:', err);
        process.exit(1);
    }
}

main();

3. Ejecutar renderizado

Ejecuta el script.

# Si usas ts-node
npx ts-node render.ts

# Si usas node (js compilado)
node render.js

Solución de problemas

"Tiempo de espera de página" o "Conexión rechazada"

  • Asegúrate de que el servidor local que aloja la composición esté funcionando.
  • Verifica si la URL es correcta y accesible en un navegador normal.

"Salida negra" o "Video vacío"

  • Asegúrate de que window.helios esté expuesto (o que la página defina window.renderAt(t)).
  • Si usas mode: 'canvas', asegúrate de estar dibujando en un elemento <canvas>.
  • Si usas mode: 'dom', asegúrate de que los elementos sean visibles.

"El renderizado se cuelga"

  • Verifica si la composición tiene errores en la consola del navegador.
  • Habilita el trazado para depurar:
    await renderer.render(url, out, { tracePath: 'trace.zip' });
    

Problemas de audio

  • Asegúrate de que las rutas de los archivos de audio sean correctas en relación al lugar donde se ejecuta el script.
  • Si usas mode: 'dom' y dependes de audio implícito (por ejemplo, etiquetas <audio>), asegúrate de que los elementos estén presentes en el DOM.

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

End-to-end guided workflow for creating a social proof or testimonial video. Extracts brand identity from the repo, generates a warm soundtrack, and produces a trust-building motion.dev composition rendered via Helios CLI. Use when making customer testimonial, review highlight, or social proof videos.

Skills relacionados