Communitygithub.com

MattiaIppoliti/tia-skills

Piloter la boucle de développement Remotion CLI : scaffold, studio, type-check, compositions, sondes de stills, rendu simple et par lots, bundle, rendu Lambda et Cloud Run, benchmark, versions, mise à niveau et vérifications GPU. À utiliser également pour diagnostiquer un échec de build ou de rendu, ou pour retrouver une capacité que possédait l'ancienne CLI HyperFrames.

Qu'est-ce que tia-skills ?

Cette compétence permet aux agents IA d'exploiter pleinement l'écosystème Remotion CLI en automatisant l'ensemble du cycle de développement vidéo programmatique. Elle couvre toutes les étapes clés : le scaffolding de projet avec `create-video`, la vérification de types via `tsc --noEmit`, la liste des compositions, les sondes de stills rapides pour l'itération visuelle, l'ouverture du studio pour validation utilisateur, le rendu vidéo local, le bundle pour déploiement distant, et les rendus distribués sur AWS Lambda ou Cloud Run. La compétence est conçue pour les agents travaillant avec Claude Code, Cursor, Cline ou tout autre éditeur/CLI supportant les fichiers SKILL.md. Elle inclut des instructions précises pour optimiser les performances de rendu (concurrence, format JPEG, benchmark), diagnostiquer les échecs courants (via un tableau de symptômes), et gérer les rendus par lots en shell ou via le renderer Node.js. Enfin, elle référence les fonctionnalités de l'ancienne CLI HyperFrames, désormais retirée, en indiquant leur équivalent Remotion, ce qui permet de migrer en douceur les workflows hérités.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Remotion CLI

L'outil est remotion, du paquet @remotion/cli. Chaque commande s'exécute via npx remotion <commande>, et chacune d'elles regroupe d'abord le projet, de sorte qu'une erreur de type ou une mauvaise importation se manifeste comme un échec de regroupement plutôt qu'un échec de rendu.

npx remotion --help et npx remotion <commande> --help font autorité pour les drapeaux. Les drapeaux changent entre les versions ; lisez la sortie d'aide plutôt que de vous fier à une liste, y compris celle-ci. Ce qui suit décrit la boucle et les modes d'échec, pas une référence des drapeaux.

La boucle

ÉtapeCommandePourquoi
Scaffoldnpx create-video@latest --blankécrit un package.json, remotion.config.ts, tsconfig adaptés
Vérification de typenpx tsc --noEmitle contrôle le moins coûteux ; détecte les dérives de schéma/prop avant tout rendu
Listenpx remotion compositionsconfirme que l'id que vous allez rendre existe réellement
Sonde d'une imagenpx remotion still <id> out/probe.png --frame=<n>secondes, pas minutes ; le cheval de bataille de l'itération
Révisionnpx remotion studioconfiez-la à l'utilisateur ; il parcourt et édite les props lui-même
Rendunpx remotion render <id> out/video.mp4seulement après l'approbation de l'utilisateur
Envoi à distancenpx remotion bundle → npx remotion lambda render <url> <id>rendu distribué ; nécessite une infrastructure AWS déployée

Sondez les stills avant de rendre

Un rendu complet d'une composition 1080p de 45 secondes prend des minutes. Un still prend des secondes et répond à la plupart des questions : le texte est-il dans le cadre, la ressource s'est-elle chargée, la couleur est-elle correcte. Sondez le milieu de chaque scène, regardez chaque image, et ensuite seulement rendez.

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

Ne signalez jamais qu'une composition fonctionne sur la foi d'un bundle réussi. Regardez les pixels.

Studio est la surface de révision, pas votre débogueur

npx remotion studio sert le projet avec une timeline, un éditeur de props piloté par le schéma Zod, et un parcours image par image précis. Confiez-le à l'utilisateur pour approbation. Pour votre propre vérification, préférez les sondes still : elles sont scriptables et vous pouvez examiner la sortie sans demander à l'utilisateur de décrire ce qu'il voit.

Passage de props

--props prend une chaîne JSON ou un chemin vers un fichier JSON et remplace defaultProps :

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

Une prop qui échoue au schéma Zod de la composition fait échouer le rendu de manière explicite. C'est l'intérêt de déclarer le schéma, alors gardez-le précis.

Rendu par lots

Il n'y a pas de sous-commande de lot. Bouclez dans le shell sur les ids ou les charges utiles de props :

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

Pour de nombreux rendus d'une seule composition sur un ensemble de données, préférez renderMedia() depuis @remotion/renderer dans un script Node : il regroupe une fois au lieu d'une fois par rendu, ce qui domine le temps réel.

Performance de rendu

  • --concurrency=<n> définit le nombre de workers parallèles. La valeur par défaut est la moitié des cœurs CPU plafonnée à 8 ; le maximum est le nombre de cœurs, et en demander plus est une erreur, pas un plafonnement. Sur une machine à mémoire limitée, la réduire corrige les crashs qui ressemblent à des bugs du moteur de rendu.
  • --jpeg (au lieu du format PNG par défaut) constitue une accélération importante lorsque la composition n'a pas de transparence à préserver.
  • npx remotion benchmark mesure un rendu réel, alors utilisez-le pour justifier un changement de concurrence ou de codec plutôt que de deviner.
  • npx remotion gpu rapporte ce que le navigateur va réellement accélérer. Cela vaut la peine de vérifier avant d'attribuer un rendu lent à un shader ou un filtre lourd.

Diagnostic des échecs

SymptômeCause probable
Le bundling échoueUne erreur de type ou une mauvaise importation. Exécutez npx tsc --noEmit pour la version lisible de la même erreur.
« Aucune composition avec l'id … »L'id dans Root.tsx diffère de celui que vous avez passé. npx remotion compositions le résout.
Le rendu se bloque, puis expireUn delayRender() sans continueRender() correspondant. Chaque handle de délai doit être libéré.
Chaque image ressemble à l'image 0Une animation/transition CSS, ou requestAnimationFrame. Le moteur de rendu n'avance pas l'horloge du navigateur.
L'animation stroboscopique ou scintille image par imageMath.random() non ensemencé. Utilisez random(seed).
Le mouvement fonctionne en avançant, se brise sur un sautAnimation pilotée par l'état. Dérivez de useCurrentFrame() à la place.
Ressource 404 uniquement dans un rendu Lambda ou bundleUn chemin codé en dur au lieu de staticFile().
Erreur de versions incompréhensiblePaquets Remotion incompatibles. npx remotion versions signale le désaccord.
Mémoire insuffisante en milieu de renduConcurrence trop élevée pour la machine. Réduisez --concurrency.

Remontez la sortie d'erreur réelle lorsque vous signalez un échec. Ne paraphrasez pas une trace de pile.

Où sont passées les capacités de l'ancienne CLI HyperFrames

L'ancienne CLI hyperframes regroupait des commandes d'édition, de média et d'assurance qualité que la CLI de Remotion ne possède pas. Rien de ce qui suit n'est une commande Remotion, alors n'essayez pas de les exécuter :

Commande retiréeOù se trouve la capacité maintenant
initnpx create-video@latest --blank, puis /hyperframes-core → references/project-structure.md
lint, check, layout, validatenpx tsc --noEmit plus les sondes still. Le contrat data-* que ces contrôles appliquaient a disparu.
snapshot, compare, grade-comparenpx remotion still aux images choisies ; comparez les PNG avec vos propres outils.
preview, play, presentnpx remotion studio
add, catalog/hyperframes-registry
capture/product-launch-video (capture de site) et /media-use
tts, transcribe, remove-background/media-use
beats, keyframes/hyperframes-creative (planification des beats), /hyperframes-keyframes
cloud, publishnpx remotion bundle + remotion lambda / remotion cloudrun, ou votre propre hébergement
skills, docs, upgrade, doctorces compétences sont vendues dans ce dépôt ; npx remotion upgrade et npx remotion versions

Si un fichier de workflow ou de référence vous demande encore d'exécuter npx hyperframes <quelquechose>, cette instruction est obsolète. Faites l'équivalent Remotion à partir du tableau ci-dessus et dites dans votre résumé que vous avez rencontré un pointeur obsolète, afin qu'il puisse être corrigé.

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 associés