Communitygithub.com

MattiaIppoliti/tia-skills

Toutes les connaissances en animation pour HyperFrames — règles atomiques de mouvement, blocs de scène multiphases, transitions de scène, techniques de motion design, et les sept adaptateurs runtime.

Qu'est-ce que tia-skills ?

Cette compétence regroupe toute l'expertise en animation pour le framework HyperFrames. Elle fournit aux développeurs un ensemble complet de règles atomiques de mouvement, de blocs de scène pré-conçus (blueprints), de transitions entre scènes, de techniques avancées de motion design, et d'adaptateurs pour sept runtime d'animation : GSAP (par défaut), Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API et TypeGPU/WebGPU. L'utilisateur peut composer rapidement 2 à 4 règles atomiques pour créer une animation, ou charger un bloc multiphase complet pour des chorégraphies plus complexes. La compétence inclut également des adaptateurs détaillés pour chaque runtime, permettant de consulter les API spécifiques (easing GSAP, contrôleur Lottie, AnimationMixer Three.js). Elle permet d'auditer une composition existante via un script d'analyse de carte d'animation, et de découvrir 24 effets d'animation de texte nommés. Conçue pour HyperFrames, elle respecte les contraintes critiques : timeline unique en pause, déterministe et compatible `seek`. Bien que la compétence soit rédigée pour l'ancien runtime HTML + GSAP, elle reste applicable à la version Remotion actuelle, avec un tableau de correspondance pour la traduction des concepts.

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

Demander à votre IA préférée

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

Documentation

⚠ Statut du contrat : le craft est à jour, le code ne l'est pas

Le framework de sortie de cette pile est Remotion + React (/hyperframes-core). Le motion craft ici reste valide : timing, choix d'easing, la forme d'un mouvement, les règles nommées et les blocs. Le code ne l'est pas : les exemples et adaptateurs sont écrits pour l'ancien runtime HTML + timeline GSAP en pause.

Traduction à la lecture :

IciDans Remotion
gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})
ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), retouché à l'œil
une timeline en pause à window.__timelines[id]rien ; chaque valeur est une fonction de useCurrentFrame()
data-start / data-duration sur un clip<Sequence from> / durationInFrames, en trames
une keyframe ou transition CSSstyle inline dérivé de la trame (l'animation CSS ne rend pas)

Ne copiez jamais un exemple de cette compétence dans un projet Remotion sans le modifier.

Animation HyperFrames

Toutes les connaissances en mouvement en une seule compétence : règles (recettes atomiques), blocs (gabarits de scène multiphases), transitions (de scène à scène), techniques (motifs généraux de motion design), et adaptateurs (API par runtime).

Pour le contrat de composition (attributs de données, sous-compositions, déterminisme), voir hyperframes-core.

Par défaut : composer des règles atomiques

Choisissez 2 à 4 règles dans rules-index.md, assemblez-les avec une seule timeline GSAP en pause, c'est fait. C'est plus rapide et produit moins de code que de partir d'un bloc.

Charger un bloc quand

  • La scène correspond à un gabarit multiphase pré-conçu existant (révélation de marque, preuve sociale, etc.) et que la réutilisation de son pipeline de phases économise un temps d'écriture réel.
  • Vous voulez un code fonctionnel de référence pour une chorégraphie complexe de 4 à 5 phases.

Les blocs se trouvent dans blueprints-index.md. Chaque entrée pointe vers blueprints/<id>.md (recette). Ne le lisez pas par curiosité ; chargez-le seulement lorsque vous avez déjà décidé d'avoir besoin d'une orchestration au niveau de la scène.

Routage

Vous voulez…Lisez
Choisir un motif de mouvement atomique par déclencheur / baliserules-index.md
Lire la recette HTML / CSS / GSAP complète d'une règlerules/<nom>.md
Choisir un gabarit de scène multiphaseblueprints-index.md
Lire la recette complète d'un blocblueprints/<id>.md
Créer une transition de scène (pilotée par CSS, entre deux clips)transitions/overview.md, transitions/catalog.md
Rechercher une technique de motion design plus largetechniques.md
Analyser la carte d'animation d'une composition existantescripts/animation-map.mjs
API GSAP — timeline / tweens / paramètres de positionadapters/gsap.md
GSAP — recettes d'effets prêtes à l'emploirules/gsap-effects.md
GSAP — transformations / performancesadapters/gsap-transforms-and-perf.md
GSAP — easings / staggeradapters/gsap-easing-and-stagger.md
GSAP — timeline / labelsadapters/gsap-timeline-and-labels.md
Lottie / dotLottie (exports After Effects, window.__hfLottie)adapters/lottie.md
Three.js / WebGL (scènes 3D, AnimationMixer, hf-seek)adapters/three.md
Anime.js (window.__hfAnime)adapters/animejs.md
Keyframes CSS (animation-delay / play-state / fill-mode)adapters/css-animations.md
Web Animations API (element.animate(), recherche currentTime)adapters/waapi.md
TypeGPU / WebGPU (navigator.gpu, WGSL, pipelines de calcul)adapters/typegpu.md
HTML-en-texture + post-fx WebGL/GLSL (capture DOM en direct via drawElementImage)adapters/html-in-canvas-patterns.md
Effets d'animation de texte nommés (24 ID via la compétence externe animate-text)adapters/animate-text.md

Choisir un runtime

  • GSAP est la valeur par défaut pour 95 % du travail de motion — il couvre l'orchestration des timelines, les transformations, l'easing, le stagger. Toutes les règles atomiques de cette compétence sont basées sur GSAP.
  • Lottie lorsque un actif a sa propre timeline pré-intégrée (généralement des exports After Effects).
  • Three.js pour les scènes 3D, le mouvement de caméra, les visuels pilotés par shaders.
  • Anime.js pour des tweens légers quand GSAP est trop lourd.
  • CSS pour des motifs simples et répétés, de la décoration, des scintillements — sans coût JavaScript d'animation.
  • WAAPI pour les keyframes natives du navigateur sans dépendance GSAP.
  • TypeGPU / WebGPU pour les canevas rendus par GPU (particules, verre liquide, shaders personnalisés).

Plusieurs runtimes peuvent coexister dans une même composition. Chacun enregistre ses instances sur la variable globale spécifique au runtime afin qu'HyperFrames puisse toutes les parcourir en une seule passe.

Contraintes critiques

Prérequis : hyperframes-core → Règles non négociables (timeline unique en pause, data-duration détermine la durée, pas de Math.random / Date.now / performance.now, pas de repeat: -1, pas de gsap.set au chargement de page sur des clips de scènes ultérieures, pas de tweens display ou visibility bruts, et pas de construction de timeline dans async / setTimeout / Promise). Les réglages autoAlpha GSAP et les réglages de visibilité à durée nulle aux limites explicites de la timeline restent autorisés par le noyau. Utilisez ces exceptions uniquement sur des éléments qui ne sont pas des clips ou des wrappers à l'intérieur d'un clip ; le framework gère le cycle de vie des .clip. Ne répétez pas l'intégralité du contrat ici.

Ajouts de la compétence d'animation par-dessus le contrat du noyau :

  • Constantes de mise en page pré-calculées — ne dérivez jamais les positions de getBoundingClientRect() au moment du tween. Les mesures DOM au moment du tween se désynchronisent car le moteur de rendu échantillonne en parallèle ; calculez les coordonnées une fois à la configuration de la composition et réutilisez-les.
  • Le mouvement spatial utilise uniquement les alias de transformation GSAP (x, y, scale, rotation). La liste autorisée du noyau permet également opacity / color / backgroundColor / borderRadius pour les tweens de propriétés non spatiales — mais jamais width / height / top / left pour les changements de mise en page.

Scripts

node skills/hyperframes-animation/scripts/animation-map.mjs <dossier-composition> \
  --out <dossier-composition>/.hyperframes/anim-map

Lit chaque timeline GSAP enregistrée sur window.__timelines, énumère les tweens, échantillonne les boîtes englobantes, calcule des indicateurs, et produit animation-map.json. Utilisez-le pour auditer la chorégraphie (zones mortes, cohérence du stagger, avertissements de cycle de vie) après la création.

animation-map.mjs résout d'abord les packages d'aide dans le projet actuel, puis peut amorcer la version groupée du package HyperFrames. Définissez HYPERFRAMES_SKILL_PKG_VERSION=<version> uniquement lorsque vous exécutez la compétence en dehors de l'installation groupée CLI/compétence et que vous devez épingler cette version d'amorçage explicitement.

Voir aussi

  • hyperframes-core — structure de composition, attributs de données, sous-compositions, contrat de rendu déterministe
  • hyperframes-creative — palettes, typographie, narration, planification des temps (direction créative non-animation)
  • hyperframes-cli — npx hyperframes lint / check / snapshot / preview / render

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

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

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

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