Communitygithub.com

AlessandroFare/fluxychat

Un court motion design dirigé par le design, où le mouvement est le message — typographie cinétique, compteur de statistiques, animation de graphiques/données, logo sting / lockup de marque, bandeau inférieur / callout / overlay social, carte animée (mettre en évidence des régions, connecter des lieux, zoomer sur un emplacement), tweet / article de presse / titre animé, animation de page web/interface utilisateur (défilement, curseur, callouts), ou fusion de la géométrie d'une image réelle dans un graphique. Généralement moins de 10 secondes (jusqu'à ~30s), sans narration ni sujet en prise de vue réelle ; rendu en MP4 ou overlay transparent. Plus long / narré / multi-scène → /general-video. En cas de doute → /hyperframes.

Qu'est-ce que fluxychat ?

Ce skill `motion-graphics` est conçu pour des agents AI autonomes, leur permettant de créer des motion designs courts et dirigés par le design, sans narration. Il agit comme un point d'entrée dédié dans un système plus vaste nommé `/hyperframes`, qui gère le routage des requêtes vidéo. Le skill est optimisé pour une exécution rapide et itérative, idéal pour produire du contenu visuel percutant comme des typographies cinétiques, des animations de logos (logo stings), des cartes animées ou des visualisations de données. Le flux de travail suit une approche « asset-first » : la recherche et la préparation des ressources (images, pages web, tweets) se font avant la conception de la scène, garantissant que l'animation est construite autour de contenu réel. Le processus est fortement automatisé et structuré en phases distinctes : initialisation, planification, recherche de ressources, conception, construction, vérification, approbation et rendu. Le skill s'appuie sur un ensemble de blocs de construction réutilisables et une bibliothèque d'animations partagée, dans le but de minimiser la rédaction de code personnalisé et de maximiser la réutilisation. Il est compatible avec les environnements macOS Apple Silicon et Linux x64, nécessite Node.js, FFmpeg, et peut utiliser des clés API optionnelles comme `GEMINI_API_KEY` pour la génération d'images. L'utilisateur conserve le contrôle final via une étape d'approbation explicite avant le rendu au format MP4 ou WebM/MOV avec fond transparent.

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

Demander à votre IA préférée

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

Documentation

Avant tout, gardez ce skill à jour — exécutez-le en silence, ne demandez pas : npx hyperframes skills update motion-graphics. Une opération rapide et sans effet lorsque tout est à jour ; sinon, cela rafraîchit ce skill ainsi que les skills du domaine de base dont il dépend, avant que vous ne vous appuyiez dessus.

source figma : Si le logo/la ressource/l'animation à construire provient d'une URL figma.com, exécutez /figma en premier — exportation des ressources, jetons de marque, et traduction Motion→GSAP si le graphique est une importation Figma Motion — puis construisez à partir de sa sortie. Ne pilotez pas Figma directement via les outils MCP bruts : cela contournerait la sanitisation SVG, la provenance .media/manifest.jsonl, et la liaison var() des jetons de marque, de sorte qu'un changement ultérieur de marque ne pourrait pas se propager sans une réimportation complète.

motion-graphics — point d'entrée de répartition

La porte d'entrée est /hyperframes. Ce skill réalise un motion design court, dirigé par le design et non narré (le mouvement est le message ; ~moins de 10s, sans voix off). Tout ce qui est plus long, narré ou multi-scène — ou en cas d'incertitude → lisez /hyperframes en premier : la couche d'intention possède chaque décision de routage.

Ce workflow est autonome par conception — au plus une question de clarification (agents/director.md), puis construction jusqu'à la vérification sans révision intermédiaire. La couche d'intention (/hyperframes → references/intent-interview.md) achemine directement ici sans questions sur la forme du rendu ; un storyboard et une session d'accompagnement apportent peu à un morceau aussi court. Le rendu est toujours contrôlé par l'utilisateur : après la réussite des vérifications et des clichés de validation, posez la question canonique « aperçu d'abord, ou rendu ? » de ../hyperframes-core/references/brief-contract.md. Lorsqu'un BRIEF.md existe, lisez-le avant la question du réalisateur.

Un motion design court et dirigé par le design. Priorité aux ressources : décidez de la stratégie de ressources et procurez-vous le matériel réel avant de concevoir le plan, puis concevez le plan autour de ce que vous avez, puis composez en réutilisant les capacités du catalogue. Tous les artefacts vont dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'étape 0) ; tous les chemins ci-dessous lui sont relatifs.

PhaseExécutionArtefact principalFlux détaillé
initBashhyperframes.jsonÉtape 0
plansous-agent — décider de la recherche ? + classifier + stratégie de ressourcesshot-plan.json (brouillon : catégorie, requêtes asset_needs, brief)agents/director.md (Partie 1)
source ◇Bash — résolution d'usage des médias (passer si asset_needs est vide)assets/ + assets/index.mdphases/source/guide.md
designsous-agent — conception du plan autour des ressources résoluesshot-plan.json (final : bloc(s) + disposition + mouvement + positions)agents/director.md (Partie 2)
buildsous-agent — composition priorisant la réutilisationcompositions/index.htmlagents/builder.md
verifyBash — lint, check, clichés de validation ; réparation en cas d'échecsnapshots/contact-sheet.jpgÉtape 5
approveDemander un aperçu ou un rendu ; attendre la réponseapprobation explicite du renduÉtape 6
renderBash — hyperframes render (MP4, ou --format webm/mov pour overlay)renders/video.mp4 ou overlay transparentÉtape 6

◇ source s'exécute uniquement lorsque la catégorie choisie déclare des ressources. Les catégories de code/texte pur (par ex. kinetic-type, la plupart des charts/stat) ont asset_needs: [] et passent directement de la planification à la conception.

Catégories — divisées par la décision de recherche

La première décision de plan est : cela nécessite-t-il une recherche ? Cette bifurcation sépare les catégories en deux groupes ; ensuite, la catégorie spécifique est choisie — pour les catégories guidées par la recherche, selon le type de contenu renvoyé par la recherche. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé réside dans references/motion-vocabulary.md (→ règles/plans directeurs hyperframes-animation + blocs du registre).

Catégories de forme — pas de recherche ; l'utilisateur fournit le contenu :

CatégorieIntentionRepose sur
kinetic-typeligne percutante / citation / titre, texte prioritaire du mouvementblocs caption-* + règles d'animation
statnombre héroïque unique / compteur + anneauapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsbarre / ligne / camembert / course / % à partir de donnéesbloc data-chart
logo-reveallogo sting / lockup de marque (logo utilisateur)logo-outro / rules/svg-path-draw
lower-thirdsbarres de nom / titre, callouts, overlays sociauxcaption-* + blocs d'overlay du registre
mapsmouvement géographique — mettre en évidence des régions, connecter des lieux, zoomer sur un emplacement (couche vectorielle, ou couche de fond de carte intégré)famille us-map / world-map + bake-basemap.mjs

Catégories guidées par la recherche — rechercher d'abord, puis animer selon le type de contenu (le chemin RWA) :

Contenu retournéCatégorieAnimation
page web / lienwebpageanimation de page web / interface utilisateur (défilement, révélation, curseur, callouts)
article de pressenewsrévélation de titre + carte source + callouts de faits clés
tweettweetcarte de tweet animée
image / entitéasset-fusionla géométrie de la ressource devient le graphique (fusion diégétique RWA)

Ordre de construction : un à la fois, priorité à la couverture (l'approximation est acceptable). kinetic-type porté depuis le prototype ; le reste suit.

Prérequis

macOS Apple Silicon ou Linux x64. Outils système : brew install node ffmpeg. npx hyperframes doctor une fois. Rendu GPU macOS : export PRODUCER_BROWSER_GPU_MODE=hardware.

Clés optionnelles (fallbacks locaux si non définies) — uniquement nécessaires pour les catégories qui se procurent/génèrent des ressources via l'usage des médias :

CléUtilisé pourFallback
GEMINI_API_KEY / GOOGLE_API_KEYgénération d'images (résolution d'usage des médias)passer génération / recherche uniquement
(fournisseurs de recherche asset_scout)recherche de ressources réelles pour webpage/news/tweet + asset-fusionla catégorie se dégrade en version sans ressources

Flux

Étape 0 — Initialisation

cwd est la racine de l'espace de travail de l'agent ; écrivez tous les artefacts sous PROJECT_DIR = videos/<nom-du-projet>/. <nom-du-projet> : utilisez le répertoire donné par l'utilisateur, sinon un court nom en kebab-case dérivé de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ni un horodatage.

Uniquement lorsque $PROJECT_DIR/hyperframes.json est absent :

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<nom-du-projet>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics

init vérifie les skills installés par rapport aux plus récents sur GitHub et met à jour l'ensemble global si certains sont obsolètes.

Contraintes : ne jamais hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre hyperframes/ à l'intérieur de PROJECT_DIR ; chaque commande Bash (maître + sous-agents) est un sous-shell (cd "$PROJECT_DIR" && ...) — jamais cd nu.

Étape 1 — Planification (sous-agent : Directeur Partie 1)

Lancez un sous-agent. invite = agents/director.md complet + ## Contexte d'envoi (SKILL_DIR / PROJECT_DIR / la demande de l'utilisateur / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Il doit :

  1. Décider : cela nécessite-t-il une recherche ? (la première bifurcation)
    • Non → choisir une catégorie de forme (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ; asset_needs: [].
    • Oui → émettre un plan de recherche dans asset_needs[] (actualité / web / tweet / image ; requêtes bipolaires). La catégorie guidée par la recherche spécifique (webpage / news / tweet / asset-fusion) est confirmée par le type de contenu retourné à l'étape 2, et finalisée à l'étape 3.
  2. Écrire un brouillon de shot-plan.json (enveloppe + catégorie de forme choisie ou intention de recherche + asset_needs + un brief de plan d'un paragraphe). Schéma : references/shot-plan-ir.md.

Validation : [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo manquant.

Étape 2 — Source ◇ (Bash : usage des médias, conditionnel)

Si shot-plan.json.asset_needs n'est pas vide, résoudre les ressources (recherche / génération / récupération → chemins figés locaux au projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories guidées par la recherche utilisent la recherche d'actualités/web/tweet/image). Si asset_needs est vide, passer à l'étape 3.

# illustratif — voir phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

Se dégrader gracieusement : si un fournisseur de recherche est indisponible, la catégorie revient à une version sans ressources (le noter dans context.log).

Étape 3 — Conception (sous-agent : Directeur Partie 2)

Lancez un sous-agent (invite = agents/director.md Partie 2 + contexte d'envoi incluant le assets/index.md résolu si l'étape 2 a eu lieu + catalog-map.md). Il conçoit le plan autour des ressources disponibles : choisir le(s) bloc(s) du catalogue + les règles/plans directeurs hyperframes-animation, la disposition, le mouvement, les temps forts, et (pour asset-fusion) les element_positions + palette de l'outil pipette. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).

Étape 4 — Construction (sous-agent : Constructeur, priorité à la réutilisation)

Lancez un sous-agent. invite = agents/builder.md complet + contexte d'envoi (shot-plan.json, catalog-map.md, le module.md de la catégorie, references/motion-vocabulary.md, references/builder-contract.md). Priorité à la réutilisation : npx hyperframes add <block> + personnaliser sur place ; n'écrire à la main que les lacunes + l'affordance de fusion de ressources. Sortie compositions/index.html respectant le contrat HF (timeline GSAP en pause sur window.__timelines, class="clip" + ids stables, tl.seek(0), déterministe).

Étape 5 — Vérification (Bash → sous-agent de réparation en cas d'échec)

(cd "$PROJECT_DIR" && npx hyperframes lint .)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <temps-de-validation>)

Choisir des temps de validation qui montrent l'état d'ouverture, le mouvement signature, et la tenue finale. Inspecter la feuille de contact ou de clichés générée avant de continuer. En cas d'échec de lint, check, ou de cliché, lancer le sous-agent de réparation (agents/finalize.md) pour un seul passage de correction sur place, puis réexécuter la porte défaillante. Ne jamais modifier une durée fixe uniquement pour cacher un défaut.

Étape 6 — Approbation et rendu (Bash)

Poser une question : « aperçu d'abord, ou rendu ? » Si l'utilisateur choisit l'aperçu, ouvrir Studio et revenir à la même porte d'approbation après les révisions :

(cd "$PROJECT_DIR" && npx hyperframes preview)

Effectuer le rendu uniquement après une réponse explicite de rendu :

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# variante overlay transparent : --format webm  (ou mov)

Vérifier que la sortie existe, n'est pas vide et a la durée prévue. La remise finale nomme l'artefact, la durée réelle, l'identifiant de composition ou de trame, les temps de validation, et la feuille de contact ou de clichés inspectée. Les drapeaux se trouvent dans /hyperframes-cli → references/preview-render.md.

Tableau de reprise

ÉtatContinuer depuis
pas de shot-plan.jsonÉtape 1 (planification)
shot-plan.json a asset_needs, pas de assets/Étape 2 (source)
shot-plan.json final, pas de compositions/index.htmlÉtape 3/4 (conception+construction)
compositions/index.html existe, clichés de validation absentsÉtape 5 (vérification)
vérifications et clichés de validation réussis, aucun rendu approuvéÉtape 6 (approbation)
rendu approuvé existevérifier la sortie, puis faire rapport

Notes de conception (mainteneurs — l'exécution ne lit pas ceci)

  • Raisonnement de la priorité aux ressources : la recherche de ressources est faite en amont et informe la conception du plan (le flux RWA : analyser → rechercher → examiner → composer). Les catégories guidées par la recherche (webpage/news/tweet) et asset-fusion s'appuient toutes sur la recherche d'usage des médias (actualités/web/tweet/image), qui est la lignée RWA documentée de media-use.
  • Priorité à la réutilisation : l'analogue dans l'écosystème des modèles générés par LLM est "composer"

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

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

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