Communitygithub.com

AlessandroFare/fluxychat

Transformez un fichier .md de changelog hebdomadaire en une vidéo de changelog finalisée et de marque (carré 1080, ~45-60s, voix Annie, fond animé de marque, visualisations mock-UI, sous-titres discrets). Utilisez-la lorsque l'utilisateur fournit un fichier markdown de changelog/digest et souhaite la vidéo hebdomadaire, ou dit « vidéo de changelog ». Autonome — polices, fond, lexique et scripts sont inclus dans cette compétence.

Qu'est-ce que fluxychat ?

Cette compétence transforme un fichier markdown de changelog (par exemple, le digest hebdomadaire de HyperFrames) en une vidéo vidéo de marque, carrée (1080×1080), d'environ 45 à 60 secondes, avec la voix off Annie (HeyGen), un fond animé de marque, des visualisations mock-UI, et des sous-titres discrets. La règle d'or est de visualiser, pas de lister : chaque thème est illustré par une maquette animée de l'interface utilisateur réelle ou d'un analogue fidèle, jamais par des puces de texte. Un pipeline en 6 étapes est défini, incluant l'amorçage du projet à partir des actifs de la compétence (polices, fond, squelette), l'analyse éditoriale du changelog pour respecter le budget temps (45-60s), le routage de chaque thème vers une visualisation appropriée via le `visualization-registry.md`, l'écriture d'un script à deux couches (parlé vs affiché) avec un lexique de prononciation, la génération de la voix off et des sous-titres alignés avec un mécanisme de repli Whisper, et la construction finale avec une vérification stricte de la présence des sous-titres et de l'intégrité des coutures (seams). La compétence est autonome car ses actifs (polices, fond, lexique, scripts) sont expédiés avec elle. Elle est prévue pour être utilisée dans le cadre du méta-projet HyperFrames, en conjonction avec la doctrine de mouvement (`motion-doctrine`).

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

Demander à votre IA préférée

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

Documentation

Changelog → Vidéo de marque

Entrée : un fichier .md de changelog (thèmes + éléments, comme le digest hebdomadaire HyperFrames). Sortie : un projet HyperFrames propre, prêt pour le rendu, dans projects/active/weekly-changelog-<range>/. Ne rend le rendu que lorsque demandé.

À charger en premier, non négociable : motion-doctrine (+ cut-the-curve, oversized-cursor si un curseur apparaît, seam-craft) et captions-overlay. Cette compétence fournit le pipeline spécifique au changelog ; la doctrine fournit la loi du mouvement.

La directive primordiale : visualiser, ne pas lister

Chaque thème est illustré par une maquette animée de l'interface utilisateur réelle ou d'un analogue fidèle qui joue le changement d'expérience — jamais de puces de texte. Acheminez chaque thème/élément via references/visualization-registry.md AVANT d'écrire le script ; le registre décide : ui-recreate / ui-analog / terminal / checklist. La checklist textuelle est le dernier recours, réservée aux éléments vraiment non visuels (listes de correctifs de fiabilité).

Pipeline

0 · Amorcer le projet à partir des actifs de CETTE compétence — non négociable

Faites ceci avant d'écrire un quelconque HTML de composition. Omettre cette étape produit toujours une vidéo qui ressemble à un projet similaire que vous avez déjà construit, PAS à la marque de cette compétence — c'est la façon la plus courante de dévier de la marque. Les actifs, polices et squelette de la compétence sont la compétence ; le prompt SKILL.md est un routeur.

mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
  -vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
  -an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html

Ensuite, lisez references/build-spec.md du début à la fin (pas en diagonale) — il définit les jetons de marque (TT Norms Pro + ABC Solar Display + TT Norms Mono, crème #f5f6f4, vert rationné #5ef17c, cartes en verre avec bordures teintées de vert, forme de pilule kicker/sec-chip, rail de sous-titres 32px à top: 990) que chaque scène hérite du squelette.

SEULEMENT ALORS commencez les étapes 1 à 6 ci-dessous. Les étapes 1 à 4 (analyse, routage, script, VO) planifient ce qui va dans le squelette ; l'étape 5 remplit les espaces réservés (<RANGE>, <TOTAL>, <CUT_N>, <DUR_N>, corps de scène) à l'intérieur du project/index.html déjà copié — vous NE réécrivez PAS le chrome, les polices, la palette ou la coque de mise en page du squelette.

Si vous vous surprenez à utiliser cp sur le index.html d'une vidéo précédente, ou à écrire vos propres déclarations @font-face, ou à concevoir un arrière-plan shader WebGL au lieu d'utiliser la vidéo bg-pattern MP4 encodée ci-dessus : ARRÊTEZ. Supprimez le index.html actuel et recommencez à partir du cp du squelette master-skeleton. Reconstruire le contenu de la scène sur le bon squelette est moins coûteux que de rétro-adapter la marque dans un mauvais squelette.

1 · Analyse + coupe éditoriale

  • Extraire : la plage de la semaine, les statistiques principales (versions, commits), les thèmes, les éléments.
  • Budget : 45-60s au total. Titre ≤2s, outro ≤3.5s, 4 thèmes ≈ 9-12s chacun.
  • Par thème, garder UNE visualisation héroïque + au maximum 3 éléments parlés. Tout le reste n'existe que comme pointeur "digest complet" dans l'outro. La coupe est le travail : un changelog avec 30 éléments donne toujours ≤14 temps parlés.
  • Ordonner les thèmes par histoire : fonctionnalité phare → surface produit → performance → fiabilité (le digest est généralement déjà dans cet ordre).

2 · Routage de la visualisation

Pour chaque thème, choisir la surface dans references/visualization-registry.md et écrire une ligne : thème → surface → les 2-4 actions séquencées que la maquette effectue, chacune liée à une phrase du script. Si aucune surface du registre ne correspond et qu'aucun analogue fidèle n'existe, il s'agit d'une scène de checklist — n'inventez pas d'interface utilisateur factice pour quelque chose que nous ne pouvons pas représenter honnêtement.

3 · Script à deux couches (parlé vs affiché)

Écrire le script sous forme de lignes de jetons selon references/script-voice.md : registre conversationnel, chaque terme technique portant une forme phonétique spoken tirée de references/lexicon.json tandis que display conserve l'orthographe standard. Les sous-titres affichent display ; la VO lit spoken. Tout terme qui n'est pas dans le lexique : ARRÊTEZ et demandez à l'utilisateur comment il se prononce, puis ajoutez-le au lexique. Enregistrer sous script-tokens.json dans le projet.

4 · VO — Annie (HeyGen, épinglée)

# texte de la couche parlée uniquement ; words.json = timestamps de référence du texte PARLÉ
# Chemin natif du dépôt : la compétence changelog-vidéo s'exécute depuis la racine du dépôt hyperframes,
# elle utilise donc l'assistant TTS hyperframes-media suivi directement (pas de `npx hyperframes
# skills` install step). Si vous avez copié la compétence dans un autre dépôt, remplacez par
# votre propre chemin vers l'assistant media-use / hyperframes-media heygen-tts.mjs.
node skills/hyperframes-media/scripts/heygen-tts.mjs ./vo-spoken.txt \
  -o voiceover.mp3 --words vo-words.json \
  --voice 330290724a1b470fb63153f34d4c0183   # Annie — lifelike (ne pas substituer)

Nécessite heygen CLI ≥0.3.0 authentifié (heygen auth login --oauth). Ensuite, aligner les timestamps parlés sur les jetons affichés :

node <SKILL_DIR>/scripts/align-captions.mjs \
  --tokens script-tokens.json --words vo-words.json --out captions.json

captions.json est l'entrée du rail de sous-titres (orthographe affichée, timing parlé). L'aligneur imprime des avertissements MISMATCH — résolvez chacun avant de construire (généralement une orthographe du lexique que le TTS rend comme plusieurs mots). L'audio est l'horloge : tous les temps des temps forts viennent de vo-words.json ; une régénération de la VO rouvre chaque couture.

Les timestamps des mots sont une porte stricte. Avant de passer à l'étape 5, vérifiez que vo-words.json n'est pas vide et contient un tableau words: [...] avec start/end pour chaque mot. S'il est vide (0 octet) ou ne contient pas le tableau — un mode de défaillance connu lorsque le fournisseur TTS renvoie l'audio mais pas de payload de timestamp — NE CONTINUEZ PAS sans eux. Solution de repli : aligner forcément l'audio produit sur le script affiché en utilisant Whisper local :

uvx --from openai-whisper whisper voiceover.mp3 \
  --model base.en --language en --word_timestamps True \
  --output_format json --output_dir .
# puis exécutez align-captions.mjs avec --words voiceover.json (même structure)

Whisper peut mal interpréter les rendus TTS ("gee-sap" → "gsap", "heyjen" → "hey Jen", etc.) — les sous-titres utilisent toujours l'orthographe AFFICHÉE de script-tokens.json ; whisper ne fournit que les timestamps. align-captions.mjs gère la jointure. Cette solution de repli fait la différence entre une construction sous-titrée et une construction silencieusement non sous-titrée.

5 · Construction

Suivez references/build-spec.md exactement : jetons de marque + polices (fournies dans <SKILL_DIR>/assets/), l'encodage du fond animé, le squelette de la scène, le chrome, le rail de sous-titres, un moment vert rationné par scène. Ensuite, l'ordre de la doctrine : ledger.json (toutes les coutures ordinaires cut-the-curve LEFT) → seam-stamp → temps forts internes sur les mots de la VO → vérification seam-gate.

Les sous-titres sont non optionnels. Le squelette master-skeleton inclut une IIFE de rail de sous-titres qui lit un tableau LINES — laisser ce tableau vide est un bogue expédié, pas un choix de style. Remplissez-le à partir de captions.json avant de passer à l'étape 6 :

// collez à la place de "const LINES = /* … */ []" dans l'IIFE du rail de sous-titres :
const LINES = /* contenu de captions.json */ [
  { id: 0, end: 2.74, w: [["This", 0.0], ["week,", 0.30], …] },
  …
];

Si align-captions.mjs a été sauté ou si LINES est [], la vérification de trame à l'étape 6 échouera — ne la contournez pas en supprimant #cap-line du squelette.

6 · Vérifications (toutes vertes avant de présenter)

  1. bun run --cwd packages/cli hyperframes check (ou le CLI hyperframes installé à partir de la compétence locale skills/hyperframes-cli/) — 0 erreurs (contraste : texte sombre ≥ .66 alpha). N'utilisez PAS npx hyperframes@latest ; le CLI local suivi du dépôt est la source de vérité pour le contrat de composition que cette compétence produit.
  2. seam-gate.mjs verify — 0 échec.
  3. Redémarrez le serveur de prévisualisation (il met en cache le bundle), vérifiez 3-4 temps forts via __player.seek sur la page de composition brute.
  4. Ne RENDEZ PAS à moins que l'utilisateur ne le demande. Après un rendu demandé, vérifiez les trames de la MP4 (ffmpeg -ss <t> … -frames:v 1) : sous-titres présents, vidéo de fond non noire, pas de trames minuscules/gelées.
  5. Vérification de présence des sous-titres — échec strict. Échantillonnez 3-4 trames réparties sur la fenêtre parlée de la VO (par exemple t=3, t=15, t=30, t=42 pour une VO de 48s) et confirmez que le rail de sous-titres à top: 990 affiche du texte visible sur chacune. Si une trame dans un intervalle parlé manque de sous-titres, la construction expédie sans sous-titres — traitez-la comme une vérification rouge et revérifiez le remplissage de LINES à l'étape 5. C'est exactement ce qui n'a pas fonctionné sur la version v4 du 13-20 juillet.

Structure du projet

projects/active/weekly-changelog-<range>/
├── index.html            # document maître unique (scènes sous forme de diapositives, coutures estampillées)
├── ledger.json           # registre vectoriel (entrée seam-stamp)
├── script-tokens.json    # script à deux couches (source de vérité pour la VO + les sous-titres)
├── vo-spoken.txt         # généré : couche parlée, une ligne
├── voiceover.mp3 + vo-words.json + captions.json
├── bgm.mp3               # copie depuis <SKILL_DIR>/assets/bgm.mp3 (le morceau maison) sauf si l'utilisateur en fournit un
└── assets/fonts/ + assets/bg-pattern-<dur>s.mp4

Anti-patrons

À ne pas faireÀ la place
Diapositives à puces pour les changements d'interfaceMaquetter la surface qui joue le changement
Interface utilisateur factice pour des éléments non représentablesScène de checklist honnête
"JSON"/"CLI" brut dans le texte TTSFormes parlées du lexique ; l'affichage reste standard
Orthographes phonétiques dans les sous-titresLes sous-titres rendent toujours la couche affichée
Deviner la prononciation d'un terme inconnuDemander, puis développer le lexique
Parler de chaque élément du changelog≤3 par thème ; le lien du digest porte le reste
Accents verts partoutUn moment vert par scène (#5ef17c)
Partir du index.html d'une vidéo précédenteÉtape 0 — copiez examples/master-skeleton.html de cette compétence dans project/index.html, toujours
@font-face / shader WebGL / BGM personnalisé fait mainÉtape 0 — copiez les assets/ de cette compétence mot pour mot ; les actifs de la compétence SONT la marque
Livraison sans invalidation CloudFrontExécutez aws cloudfront create-invalidation sur la distribution E2BSLVSZ7FG3U0 pour le chemin exact après tout remplacement S3 — le CDN met en cache l'ancien fichier sinon
Expédier avec le tableau LINES vide dans le squeletteL'étape 4 doit produire un captions.json rempli ; l'étape 5 doit le coller dans l'IIFE ; l'étape 6, vérification 5, doit confirmer les sous-titres sur les trames rendues. LINES vide = expédition sans sous-titres = recommencez l'exécution
Pas de vo-words.json → sauter les sous-titres et expédier quand mêmeReplier sur l'alignement forcé Whisper sur l'audio produit ; les sous-titres sont non optionnels

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

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

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