Communitygithub.com

AlessandroFare/fluxychat

Passerelle — charger EN PREMIER avant de composer une animation ou une vidéo HyperFrames. La loi de mouvement de haut niveau qui transforme une vidéo multi-scènes en un seul mouvement de caméra continu, au lieu d'une pile de diapositives animées indépendamment.

Qu'est-ce que fluxychat ?

Cette compétence définit la règle de transition fondamentale pour les animations HyperFrames. Elle établit que la sortie d'une scène détermine l'entrée de la suivante : même axe, même direction, même vitesse, et la coupe doit se produire en plein mouvement des deux côtés. Cela remplace toutes les directives de mouvement génériques en amont, garantissant une continuité visuelle parfaite. La compétence introduit des concepts clés : le vecteur (règle du signe d'échelle Z), le courant de film (une direction dominante comme LA GAUCHE pour la progression normale), les porteurs concrets (objets que l'œil suit à travers la coupe), le mouvement causal (chaque action déclenchée par la précédente), et la "Seam Gate" (Porte de Jointure) qui vérifie numériquement que toutes les transitions respectent la règle vectorielle, la vitesse, et interdisent le chevauchement. De plus, la compétence interdit les boucles de mouvement inactives (comme les oscillations lentes) au profit de "routes de mouvement soutenu" qui maintiennent la performance narrative : révélations échelonnées, voyage de caméra avec intention, séquences d'interface utilisateur animées, ou action guidée par curseur. Elle prescrit aussi une pause de 0,3 à 0,75 seconde avant le point culminant de chaque scène, et un vocabulaire de transition limité à 2-3 types par film. Cette règle est destinée aux utilisateurs de Cursor, Claude Code et autres agents IA de développement, avec des scripts de vérification à exécuter (seam-stamp.mjs, seam-gate.mjs) et la nécessité de créer un ledger vectoriel (ledger.json) avant toute composition.

Compatible avec~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/motion-doctrine

Demander à votre IA préférée

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

Documentation

Doctrine du Mouvement (Passerelle)

Lisez ceci avant de composer une animation. Cela décide CE QUI se passe à chaque jointure et comment chaque scène se comporte ; les compétences techniques l'implémentent. Ces règles remplacent les directives de mouvement génériques / en amont. L'échec que cela évite : des scènes créées isolément — l'élan de l'œil meurt à chaque coupe, et les scènes oscillent sur place entre l'entrée et la sortie.

Carte des routes

Décision (cette compétence)Compétence d'implémentation
Choix de la transition de jointure + paramètres + codecut-the-curve §1–5 (le catalogue)
Cascades d'entrée de texte / élémentscut-the-curve §6 (entrée en cascade)
Repositionnement de groupe dans la scène (sans coupe)cut-the-curve §7 (courbe de nudging)
Action / déclenchement de scène / ignition morphique guidé par curseuroversized-cursor
Mécanismes de rendu des jointures / protection flash blancseam-craft
Lancement de produit / vidéo explicative / travail de légendesuperpose text-beat-economics, brand-faithful, captions-overlay sur la compétence en amont

Ordre de création : registre vectoriel (ledger.json) → TAMPONNEZ les jointures maîtresses à partir de celui-ci (scripts/seam-stamp.mjs --ledger ledger.json --write index.html) → route de mouvement soutenu par phase → porteurs et causes → constructions des compositions → VÉRIFIEZ (scripts/seam-gate.mjs).

Créez manuellement uniquement les morphs de niveau A (correspondances de coupe) ; les jointures tamponnées passent la porte par construction.


Partie 1 — La Loi de la Jointure

La Loi Vectorielle

La manière dont la scène A sort détermine la manière dont la scène B entre : même axe, même direction, vitesse assortie, coupée en plein mouvement des deux côtés.

  1. Axe — x reste x, y reste y, Z reste Z. N'échangez jamais d'axes à travers une coupe.
  2. Direction — ne jamais inverser. Sur Z, la direction = le SIGNE du changement d'échelle : grandir = poussée (caméra vers l'avant), rétrécir = traction (caméra vers l'arrière). Une sortie en recul répondue par une entrée qui grandit depuis une petite taille est un vecteur inversé — la violation la plus courante, car grandir depuis une petite taille est l'entrée d'élément par défaut.
  3. Vitesse — la vélocité initiale de l'entrée ≈ la vélocité finale de la sortie, via des easings en miroir (sortie power4.in + entrée power4.out, même distance et durée ; le côté entrant prend le relais ≥50% du chemin notionnel). Mécanismes dans cut-the-curve.
  4. Phase — la coupe atterrit en plein mouvement des DEUX côtés. S'arrêter au repos avant la coupe, ou démarrer du repos après elle, est un temps mort.

Le Courant

Chaque film choisit UNE direction dominante (défaut maison : GAUCHE). Chaque jointure ordinaire l'utilise. Les autres vecteurs sont RÉSERVÉS — en utiliser un signifie quelque chose :

VecteurSignification
Le courant (GAUCHE)"prochain temps" — progression neutre vers l'avant
Vers le hautélévation — une conclusion ou une révélation s'élève au-dessus de ce qui précède
Z vers l'avant (zoom traversant)poussée plus profonde dans la même pensée
Z vers l'arrière (zoom inverse)ARRIVÉE — quelque chose de plus grand atterrit
Éclatement d'échelle (explosion vers l'extérieur)quitter un monde — une surface explose devant la caméra
  • Ne jamais exécuter des jointures consécutives dans des directions opposées — le ping-pong est interprété comme une erreur.
  • Un changement de direction nécessite une cause visible (clic / rebond / impact) ou une limite de chapitre.

Le Registre Vectoriel

Écrivez-le avant de créer toute timeline maîtresse — sous forme de ledger.json à la racine du projet (schéma : references/seam-gate.md). Une ligne par jointure : temps de coupe, vecteurs de sortie et d'entrée (axe + direction signée ; les lignes Z portent le signe d'échelle), sélecteurs, technique. La sortie et l'entrée doivent correspondre ; si une ligne ne correspond pas, corrigez le plan, pas l'easing. Le vérificateur contrôle la cohérence des lignes statiquement avant tout échantillonnage au moment de l'exécution.

Porteurs

L'œil suit les objets, pas les abstractions. Les jointures les plus solides passent un porteur concret à travers la coupe à une position ET une vitesse assorties : un curseur en chemin, un conteneur qui rétrécit/s'ancre dans la disposition suivante, une marque qui vole vers son emplacement exact, le groupe de mots d'une coupe en cascade. Sans porteur naturel, les héros de la scène le portent (trajet partiel + fondu précoce, entrée en plein vol). Jamais un fondu enchaîné — il n'a aucun porteur.

Mouvement Causal

Enchaînez le mouvement pour que chaque déplacement soit visiblement déclenché par le précédent : clic → compression → ressort qui se détend → vol → impact → rebond → révélation.

  • Les effets commencent SUR l'image causale — même position temporelle, jamais "peu après."
  • Les réactions s'échelonnent avec la masse implicite : les grands éléments rebondissent plus lentement, les petits claquent rapidement.
  • Une force est une licence pour changer de direction ; un retournement non causé est un ping-pong.

La Porte de Jointure (porte de construction — exécutez le vérificateur, sortie 0 ou la jointure n'est pas terminée)

node <SKILL_DIR>/scripts/seam-stamp.mjs --ledger ledger.json --write index.html  # générer
node <SKILL_DIR>/scripts/seam-gate.mjs  verify --ledger ledger.json --project .  # vérifier

Le script (utilisation + schéma du registre : references/seam-gate.md) applique numériquement, par jointure : cohérence de la ligne du registre, la sortie bouge encore à la coupe, l'entrée est en plein vol (jamais au repos), la direction mesurée = direction du registre, correspondance de vitesse entrée/sortie (AVERTISSEMENT), zéro chevauchement (un côté visible par image — la coupe n'est pas un fondu), la règle du signe Z (d(échelle)/dt même signe des deux côtés ; les entrées de la scène entrante sont scannées pour les conflits de signe), et la continuité du rectangle porteur avec l'échelle des ancêtres incluse. Utilisez seam-gate.mjs probe --t <cut> pour trouver les vrais sélecteurs de porteurs de chaque jointure lors de la rédaction du registre.

Règles que le script ne peut pas vérifier — toujours à vous :

  1. Les modifications rouvrent la jointure. Tout changement dans la première/dernière ~1s d'une scène (y compris le ré-étalonnage pour une nouvelle VO) invalide l'audit de cette limite — relancez le vérificateur.
  2. L'audio est l'horloge. Ré-étalonnez les scènes par rapport aux horodatages réels des mots de la VO ; ne précipitez jamais une lecture pour tenir dans un créneau. Une régénération de la VO rouvre ses jointures.
  3. Piège du clip-gating (la cause habituelle d'un ÉCHEC de zéro chevauchement) : un clip dont le data-start précède son tween d'entrée est démasqué à son opacité initiale — définissez autoAlpha: 0 initial ET data-start = le temps de la coupe, jamais plus tôt.

Partie 2 — Performance (la scène continue de performer)

Pas d'oscillation inutile

Les boucles sinusoïdales inactives (respiration, flottement, dérive, pulsation lumineuse) sont INTERDITES en tant que mouvement soutenu — elles donnent l'impression que "la vidéo attend." Une scène qui termine son entrée avec des secondes restantes est un bogue de planification : ajoutez de l'histoire, pas de l'oscillation. Chaque phase entre l'entrée et la sortie est gérée par l'une de ces routes (nommez la route dans le plan) :

RouteCe que c'est
Révélations échelonnéesRetenez du contenu ; révélez-le sur les temps forts de la narration — le cadre gagne continuellement en information (défaut pour ≥2 groupes de contenu)
Caméra avec intentionUn chemin d'échelle+panoramique cartographié : établir un plan large → voyager → arriver sur le sujet
Vie UI séquencéeLe produit se comporte au fil du temps : la progression avance, l'étape en surbrillance, les comptes défilent
Séquences animéesLes éléments jouent un temps : une carte se range dans une pile, un objet est glissé, un résultat s'assemble
Action guidée par curseurUn curseur surdimensionné guide l'œil vers un déclencheur ; son CLIC déclenche le temps suivant (oversized-cursor)

Test : faites une pause à n'importe quelle seconde — quelque chose de significatif doit être en plein vol (une révélation qui atterrit, la caméra qui voyage, l'UI qui fait ce que la narration dit).

Calme avant le point culminant

Planifiez une pause de 0,3 à 0,75 s entre l'action majeure et son résultat — la virgule dramatique. Une scène qui passe directement de l'action au résultat perd son effet.

Intention de synchronisation

  • Entrée unique ≤ ~800 ms ; un build-up plus long = un décalage multi-éléments, pas un seul élément lent.
  • Sortie ≈ 75% de l'entrée. Exception : cut-the-curve inverse cela (entrée ~127% de la sortie).
  • Décalage total ≤ 500 ms ; avec 8+ éléments, resserrez le délai par élément ou décalez les premiers.
  • Easings interdits : bounce.out / elastic.out. Le dépassement à l'entrée back.out(1.4–1.7) est acceptable.
  • Les éléments similaires partagent une intention d'easing et de durée unique — jamais une paire unique par élément.

Vocabulaire de transition

Utilisez seulement 2–3 transitions inter-scènes par film et répétez-les ; la limite par défaut est cut-the-curve dans la direction du courant. Les morphs d'éléments partagés écrits à la main (intent: morph) ne comptent pas dans le budget.


Anti-Patterns

À ne pas faireÀ la place
Créer l'entrée de chaque scène en isolationÉcrivez le registre vectoriel d'abord
Fondu enchaîné entre les scènesCut-the-curve dans la direction du courant
La sortie se termine, PUIS la scène changeCoupez en plein mouvement des deux côtés
L'entrée commence au repos après une coupeEntrez ≥50% du chemin notionnel
Sortie zoom inverse → entrée qui grandit depuis une petite taille (ou poussée → rétraction surdimensionnée)Faites correspondre le signe de la vélocité d'échelle (Porte de Jointure 7)
L'introduction pop-in de la scène entrante sous un passage ZMaintenez son image d'ouverture composée, ou faites correspondre le signe
Oscillation / respiration / flottement inutiles pour remplir le tempsAttribuez une route de mouvement soutenu ; ou ajoutez de l'histoire
Inversion de direction sans causeUtilisez une force, ou conservez le courant
Vecteurs réservés utilisés comme variétéPar défaut, utilisez le courant ; utilisez-les pour le sens
Réaction quelques images après sa causeAllumage dans la même image
L'action passe directement au résultatPlanifiez le calme avant le point culminant (0,3–0,75 s)

Individual skills in this repo

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

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: 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`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, 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 HTML.

AlessandroFare/fluxychat

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

AlessandroFare/fluxychat

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

AlessandroFare/fluxychat

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

Skills associés