Communitygithub.com

AlessandroFare/fluxychat

Installez, découvrez et branchez des blocs et composants du registre dans des compositions HyperFrames. Utilisez cette compétence lors de l'exécution de `hyperframes add` ou `hyperframes catalog`, lors de l'installation d'un élément ou de tous les blocs correspondant à un tag, du branchement d'un élément installé dans `index.html`, ou de la manipulation de `hyperframes.json`. Elle couvre la découverte, les emplacements d'installation, le branchement de sous-compositions de blocs, la fusion d'extraits de composants, et la création d'un nouveau bloc ou composant pour contribuer en amont (idée → échafaudage → validation → PR).

Qu'est-ce que fluxychat ?

Cette compétence pour agents IA (comme Claude Code, Cursor, Codex, etc.) permet d'interagir avec le registre HyperFrames, un système modulaire de blocs et composants réutilisables pour créer des compositions vidéo. Elle offre des commandes CLI pour découvrir des éléments (via recherche sémantique ou filtres), les installer, et les brancher dans des compositions hôtes. Les **blocs** sont des sous-compositions autonomes avec leurs propres dimensions, durée et timeline, incluses via `data-composition-src`. Les **composants** sont des extraits d'effets (sans dimensions propres) qui sont collés directement dans le code HTML de la composition. La compétence gère également la configuration des chemins d'installation via `hyperframes.json`, et fournit des workflows complets pour contribuer de nouveaux éléments au registre via une PR en amont. Elle est conçue pour être utilisée avec le CLI HyperFrames, et son mécanisme de découverte par requête sémantique locale permet de trouver rapidement des éléments sans avoir à parcourir manuellement le catalogue.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/agent/skills/hyperframes-registry

Demander à votre IA préférée

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

Documentation

Registre HyperFrames

Le registre fournit des blocs et composants réutilisables, installables via hyperframes add <nom>.

  • Blocs — sous-compositions autonomes (propres dimensions, durée, timeline). Inclus via data-composition-src dans une composition hôte.
  • Composants — extraits d'effets (pas de dimensions propres). Collés directement dans le HTML d'une composition hôte.

Référence rapide

hyperframes add data-chart              # installer un bloc
hyperframes add grain-overlay           # installer un composant
hyperframes add captions                # installer tous les blocs tagués 'captions'
hyperframes add shimmer-sweep --dir .   # cibler un projet spécifique
hyperframes add data-chart --json       # sortie lisible par machine
hyperframes add data-chart --no-clipboard  # ignorer le presse-papier (CI/headless)

Après l'installation, le CLI affiche les fichiers écrits et un extrait à coller dans votre composition hôte. L'extrait est un point de départ — vous devrez ajouter les attributs data-composition-id (doit correspondre à l'ID interne de la composition du bloc), data-start, et data-track-index lors du branchement des blocs.

La valeur positionnelle est d'abord résolue comme un nom d'élément exact. Si aucun élément ne correspond et que la valeur est un tag, la commande installe tous les blocs avec ce tag. Les dépendances du registre sont installées avant l'élément demandé. hyperframes add fonctionne uniquement pour les blocs et composants ; pour les exemples, utilisez plutôt hyperframes init <dossier> --example <nom>.

Emplacements d'installation

Les blocs s'installent dans compositions/<nom>.html par défaut. Les composants s'installent dans compositions/components/<nom>.html par défaut.

Ces chemins sont configurables dans hyperframes.json :

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

Voir install-locations.md pour tous les détails.

Branchement de blocs

Les blocs sont des compositions autonomes — incluez-les via data-composition-src dans votre index.html hôte :

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

Attributs clés :

  • data-composition-src — chemin vers le fichier HTML du bloc
  • data-composition-id — doit correspondre à l'ID interne du bloc
  • data-start — quand le bloc apparaît dans la timeline hôte (secondes)
  • data-duration — durée de lecture du bloc
  • data-width / data-height — dimensions du canvas du bloc
  • data-track-index — ordre des couches (plus élevé = devant)

Voir wiring-blocks.md pour tous les détails.

Branchement de composants

Les composants sont des extraits — collez leur HTML dans le balisage de votre composition, leur CSS dans votre bloc de style, et leur JS dans votre script (le cas échéant) :

  1. Lisez le fichier installé (par exemple, compositions/components/grain-overlay.html)
  2. Copiez les éléments HTML dans le <div data-composition-id="..."> de votre composition
  3. Copiez le bloc <style> dans les styles de votre composition
  4. Copiez tout contenu <script> dans le script de votre composition (avant votre code de timeline)
  5. Si le composant expose une intégration de timeline GSAP (voir le bloc de commentaire dans l'extrait), ajoutez ces appels à votre timeline

Voir wiring-components.md pour tous les détails.

Découverte

Utilisez le CLI comme principale interface de découverte. Recherchez par intention avant de parcourir : le registre contient plus d'éléments que vous ne pouvez en parcourir manuellement, donc les lister et faire correspondre les noms ou tags est la voie lente, et elle échoue chaque fois que le vocabulaire de l'auteur diffère du vôtre.

# Classez l'ensemble du catalogue par rapport à ce que le beat doit faire
npx hyperframes catalog --query "révéler un titre ligne par ligne"
npx hyperframes add caption-clip-wipe

La recherche est locale et n'envoie rien. Par défaut, elle classe en fonction du vocabulaire partagé avec le nom, le titre et la description de l'élément, donc elle ne trouve que les éléments qui réutilisent vos mots ; --on-device classe par sens à la place, après un téléchargement unique du modèle. Avec --json, l'enveloppe indique quel niveau a répondu, donc vérifiez cela plutôt que de supposer qu'un classement a eu lieu.

L'installabilité est appliquée après le classement, pas avant : un nom que les vecteurs transportent mais que ce registre ne peut pas servir est retiré des résultats et compté dans dropped, donc un dropped non nul signifie que les deux sont de générations différentes. Voir /hyperframes-cli pour le niveau hors ligne, les portes de consentement, et comment rafraîchir un index obsolète.

Pour parcourir ou filtrer au lieu de rechercher :

npx hyperframes catalog
npx hyperframes catalog --type block
npx hyperframes catalog --type component
npx hyperframes catalog --type block --tag social
npx hyperframes catalog --json
npx hyperframes catalog --human-friendly

Le mode tableau normal et le mode --json listent uniquement les correspondances ; installez un nom sélectionné avec hyperframes add <nom>. --human-friendly ouvre un sélecteur interactif et installe l'élément sélectionné immédiatement. Dans les workflows CI ou agent, préférez --json suivi d'un add explicite.

Si le CLI ne peut pas atteindre le registre configuré, inspectez le manifeste brut comme solution de repli :

curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

Le registry-item.json de chaque élément contient : nom, type, titre, description, tags, dimensions (blocs uniquement), durée (blocs uniquement), et liste de fichiers.

Voir discovery.md pour les détails sur le filtrage par type et tags.

Contribuer un nouveau bloc ou composant

Pour créer un NOUVEL élément du registre (style de légende, bloc VFX, transition, tiers inférieur, ou composant réutilisable) et le soumettre sous forme de PR en amont — et non pas installer un élément existant — suivez le workflow complet idée → échafaudage → construction → validation → prévisualisation → livraison dans contributing.md. Des modèles de démarrage copiables (légende / VFX / composant / registry-item.json) se trouvent dans templates.md.

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

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

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