Communitygithub.com

MattiaIppoliti/tia-skills

Impulsa el ciclo de desarrollo de Remotion CLI: scaffolding, estudio, verificación de tipos, composiciones, pruebas de fotogramas fijos, renderizado simple y por lotes, empaquetado, renderizado en Lambda y Cloud Run, benchmarking, versiones, actualización y comprobaciones de GPU. También úsalo para diagnosticar un error de compilación o renderizado, o al buscar una capacidad que solía tener la CLI retirada HyperFrames.

¿Qué es tia-skills?

Esta skill te guía a través del flujo de trabajo completo del CLI de Remotion, desde la creación de un proyecto hasta el renderizado en la nube. Está diseñada para desarrolladores que trabajan con la biblioteca Remotion para crear videos mediante React. La skill enfatiza un ciclo de desarrollo eficiente: primero, pruebas rápidas con fotogramas fijos (`still`) para verificar la composición, luego la revisión visual en el estudio (`studio`), y finalmente el renderizado completo. También cubre la resolución de problemas comunes como errores de compilación, tiempos de espera en renderizados y problemas de rendimiento, proporcionando diagnósticos precisos y comandos específicos para cada síntoma. Soporta plataformas como Lambda de AWS y Cloud Run de GCP para renderizado distribuido, y reemplaza las capacidades de la CLI retirada HyperFrames con alternativas modernas de Remotion. La skill es compatible con el CLI de Remotion y se usa mediante comandos `npx remotion`.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/hyperframes-cli

Preguntar en tu IA favorita

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

Documentación

Remotion CLI

La herramienta es remotion, de @remotion/cli. Cada comando se ejecuta a través de npx remotion <comando>, y cada uno de ellos empaqueta el proyecto primero, por lo que un error de tipo o una importación incorrecta se manifiesta como un fallo de empaquetado, no como un fallo de renderizado.

npx remotion --help y npx remotion <comando> --help son la autoridad en cuanto a banderas. Las banderas cambian entre versiones; lee la salida de ayuda en lugar de confiar en una lista, incluida esta. Lo que sigue a continuación es el ciclo y los modos de fallo, no una referencia de banderas.

El ciclo

EtapaComandoPor qué
Scaffoldingnpx create-video@latest --blankEscribe un package.json, remotion.config.ts y tsconfig correctos
Verificación de tiposnpx tsc --noEmitLa puerta más barata; detecta desviaciones de esquema/prop antes de cualquier renderizado
Listarnpx remotion compositionsConfirma que el id que estás a punto de renderizar realmente existe
Probar un fotogramanpx remotion still <id> out/probe.png --frame=<n>Segundos, no minutos; el caballo de batalla de la iteración
Revisarnpx remotion studioPonlo en manos del usuario; ellos exploran y editan las props ellos mismos
Renderizarnpx remotion render <id> out/video.mp4Solo después de que el usuario lo apruebe
Enviar remotamentenpx remotion bundle → npx remotion lambda render <url> <id>Renderizado distribuido; necesita infraestructura AWS desplegada

Prueba fotogramas fijos antes de renderizar

Un renderizado completo de una composición de 45 segundos a 1080p cuesta minutos. Un fotograma fijo cuesta segundos y responde la mayoría de las preguntas: ¿está el texto dentro del encuadre?, ¿se cargó el recurso?, ¿es correcto el color?. Prueba el punto medio de cada escena, mira cada imagen, y solo entonces renderiza.

npx remotion still launch out/s1.png --frame=45
npx remotion still launch out/s2.png --frame=180

Nunca reportes una composición como funcional basándote únicamente en un empaquetado exitoso. Mira los píxeles.

Studio es la superficie de revisión, no tu depurador

npx remotion studio sirve el proyecto con una línea de tiempo, un editor de props impulsado por el esquema Zod, y una exploración fotograma a fotograma precisa. Ponlo en manos del usuario para su aprobación. Para tu propia verificación, prefiere las pruebas con still: son programables y puedes ver el resultado sin pedirle al usuario que describa lo que ve.

Paso de props

--props toma una cadena JSON o una ruta a un archivo JSON, y sobrescribe defaultProps:

npx remotion render launch out/video.mp4 --props='{"productName":"Acme"}'

Una prop que falla el esquema Zod de la composición hace que el renderizado falle estrepitosamente. Ese es el propósito de declarar el esquema, así que manténlo preciso.

Renderizado por lotes

No hay un subcomando de lote. Itera en el shell sobre ids o cargas de props:

for id in $(npx remotion compositions --quiet); do
  npx remotion render "$id" "out/$id.mp4"
done

Para muchos renderizados de una misma composición sobre un conjunto de datos, prefiere renderMedia() de @remotion/renderer en un script de Node: empaqueta una vez en lugar de una vez por renderizado, lo que domina el tiempo real.

Rendimiento del renderizado

  • --concurrency=<n> establece trabajadores en paralelo. El valor predeterminado es la mitad de los núcleos de la CPU con un máximo de 8; el máximo es el número de núcleos, y pedir más es un error, no un límite. En una máquina con poca memoria, reducirlo soluciona fallos que parecen errores del renderizador.
  • --jpeg (en lugar del formato predeterminado PNG) es una gran aceleración cuando la composición no tiene transparencia que preservar.
  • npx remotion benchmark mide un renderizado real, así que úsalo para justificar un cambio de concurrencia o códec en lugar de adivinar.
  • npx remotion gpu informa qué acelerará realmente el navegador. Vale la pena verificarlo antes de culpar a un sombreador o un filtro pesado por un renderizado lento.

Diagnóstico de fallos

SíntomaCausa probable
El empaquetado fallaUn error de tipo o una importación incorrecta. Ejecuta npx tsc --noEmit para la versión legible del mismo error.
"No composition with id …" (No hay composición con id …)El id en Root.tsx difiere del que pasaste. npx remotion compositions lo resuelve.
El renderizado se cuelga y luego agota el tiempoUn delayRender() sin su correspondiente continueRender(). Cada manejador de retardo debe ser liberado.
Cada fotograma se ve como el fotograma 0Una animación/transición CSS, o requestAnimationFrame. El renderizador no avanza el reloj del navegador.
La animación parpadea o titila fotograma a fotogramaMath.random() sin semilla. Usa random(seed).
El movimiento funciona al explorar hacia adelante, se rompe en un saltoAnimación basada en estado. En su lugar, deriva de useCurrentFrame().
Recurso 404 solo en un renderizado Lambda o empaquetadoUna ruta hardcodeada en lugar de staticFile().
Error de versiones sin sentidoPaquetes Remotion no coincidentes. npx remotion versions reporta la discrepancia.
Falta de memoria a mitad del renderizadoConcurrencia demasiado alta para la máquina. Reduce --concurrency.

Muestra la salida de error real cuando reportes un fallo. No parafrasees un stack trace.

Dónde fueron a parar las capacidades de la CLI retirada HyperFrames

La antigua CLI hyperframes agrupaba comandos de autoría, medios y QA que el CLI de Remotion no tiene. Nada de lo siguiente es un comando de Remotion, así que no intentes ejecutarlos:

Comando retiradoDónde vive la capacidad ahora
initnpx create-video@latest --blank, luego /hyperframes-core → references/project-structure.md
lint, check, layout, validatenpx tsc --noEmit más pruebas con still. El contrato data-* que esas pasarelas imponían ya no existe.
snapshot, compare, grade-comparenpx remotion still en fotogramas elegidos; compara los PNGs con tus propias herramientas.
preview, play, presentnpx remotion studio
add, catalog/hyperframes-registry
capture/product-launch-video (captura de sitio) y /media-use
tts, transcribe, remove-background/media-use
beats, keyframes/hyperframes-creative (planificación de ritmos), /hyperframes-keyframes
cloud, publishnpx remotion bundle + remotion lambda / remotion cloudrun, o tu propio hosting
skills, docs, upgrade, doctorestas skills están distribuidas en este repositorio; npx remotion upgrade y npx remotion versions

Si un workflow, skill o archivo de referencia aún te indica que ejecutes npx hyperframes <cualquier cosa>, esa instrucción está desactualizada. Haz el equivalente en Remotion de la tabla anterior y menciona en tu resumen que encontraste un puntero obsoleto, para que pueda ser corregido.

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

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.

MattiaIppoliti/tia-skills

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.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

Skills relacionados