Communitygithub.com

AlessandroFare/fluxychat

O contrato de composição HyperFrames — construa um projeto renderizável. Use para estrutura de composição, atributos de temporização `data-*`, `class="clip"`, trilhas, sub-composições, variáveis, reprodução de mídia controlada pelo framework, regras de renderização determinística e validação. Também cobre projetos Tailwind e os formatos de plano STORYBOARD.md / SCRIPT.md. Leia antes de escrever HTML de composição.

O que é fluxychat?

Este skill define o contrato técnico central para construir composições no framework HyperFrames, que renderiza vídeo a partir de HTML. Ele especifica a estrutura de um projeto renderizável, incluindo o uso de atributos `data-*` para temporização, classes como `clip` para clipes, trilhas para empilhamento e sobreposição, e sub-composições modulares. O skill cobre regras rígidas de determinismo (proibindo relógios, `Math.random` não seedado, ou loops infinitos) para garantir uma linha do tempo buscável e consistente. Ele também abrange reprodução de mídia controlada pelo framework, validação via CLI, projetos com Tailwind v4, e os formatos de plano `STORYBOARD.md` / `SCRIPT.md`. Funciona com plataformas como Claude Code, Cursor e Codex, fornecendo uma referência completa para desenvolvedores que precisam construir ou editar composições HyperFrames sem cometer erros silenciosos de layout ou tempo de execução.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/hyperframes-core

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

HyperFrames Core

HyperFrames renderiza vídeo a partir de HTML. Uma composição é um arquivo HTML cujo DOM declara temporização com atributos data-*, cujo runtime de animação é buscável, e cuja reprodução de mídia é controlada pelo framework.

Este skill é o contrato técnico — como construir um projeto hyperframes. O corpo abaixo é o guia de construção; detalhes por tópico estão em references/ (index próximo), leia sob demanda. Outras preocupações estão nos skills de domínio irmãos — hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. O mapa de capacidades em /hyperframes diz o que cada um cobre.

Referências

ArquivoLeia para…
references/minimal-composition.mdcomeçar pelo menor esqueleto de composição renderizável
references/composition-patterns.mdescolher monolítico vs modular; estruturar um index.html modular; escolher um arquétipo de sub-comp
references/data-attributes.mdconsultar qualquer data-* (raiz / clip / anfitrião de sub-comp / aliases legados); usar class="clip"
references/tracks-and-clips.mdescolher data-track-index, lidar com sobreposição / z-index na mesma trilha, temporizar um clipe em relação a outro
references/sub-compositions.mdconectar uma sub-composição (atributos do anfitrião, <template>, vars por instância) e animar dentro dela
references/variables-and-media.mddeclarar variáveis; colocar <video>/<audio>, definir volume, cortar
references/determinism-rules.mdconstruir uma linha do tempo buscável; proibições de determinismo; a lista de permissão de propriedades animáveis; layout / ajuste de texto
references/full-screen-motion.mdcriar movimento de tela cheia com fundos compartilhados
references/storyboard-format.mdcriar um plano STORYBOARD.md (+ o manifesto analisado)
references/review-loop.mdexecutar as passagens de revisão plano → esboço → construção em um quadro ao vivo — compartilhado por todo fluxo de planejamento de storyboard
references/production-loop.mdlevar um plano aprovado a um vídeo entregue — as dependências de estágio (áudio, quadros, montagem, transições, legendas, verificar, entregar) uma construção livre segue diretamente
references/brief-contract.mdas regras básicas do brief — derivação de modo (colaborativo / autônomo), registro de campos compartilhados, invariantes de pergunta (o próprio questionamento vive em /hyperframes → a camada de intenção)
references/brief-format.mdcriar BRIEF.md — o documento de intenção confirmado que o Setup de um fluxo de trabalho escreve e cada passo posterior lê
references/script-format.mdcriar a narração travada opcional SCRIPT.md
references/subagent-dispatch.mdmapear verbos de despacho de subagentes (fan-out paralelo / background / espera) para seu harness
references/frame-worker-core.mdo contrato compartilhado de função de frame-worker — cada construtor de pacote de fluxo narrativo o anexa ao delta sub-agents/frame-worker.md daquele fluxo
references/tailwind.mdtrabalhar em um projeto Tailwind v4 (init --tailwind; o contrato de runtime difere do v3 do Studio)

Para especificidades de runtime de animação (API GSAP, Lottie, Three.js, etc.) vá para hyperframes-animation → adapters/<runtime>.md.

Construindo uma composição

Duas formas raiz (não intercambiáveis)

  • Autônoma (index.html de nível superior) — <div data-composition-id="…"> raiz fica diretamente em <body>, sem wrapper <template> (envolvê-lo esconde todo o conteúdo e quebra a renderização).
  • Sub-composição (carregada via data-composition-src) — a raiz deve ser envolvida em <template>.

⚠ Regra de transporte: o runtime apenas clona conteúdos de <template>; tudo fora (incluindo estilos/scripts de <head>) é descartado — coloque <style>/<script> dentro do template. ⚠ Regra de ID do anfitrião: o data-composition-id do slot anfitrião deve ser exatamente igual ao data-composition-id do template interno e à chave window.__timelines["<id>"] — sem sufixo -mount/-slot/-host.

Forma do arquivo, conexão do anfitrião e checklist de pré-renderização → references/sub-compositions.md.

A raiz deve ser dimensionada (bug de layout silencioso)

A raiz autônoma precisa de uma caixa dimensionada explícita (width/height em px), e todo ancestral até um elemento com height:100% deve ter uma altura resolvida — caso contrário, um filho flex/100% colapsa para ~0 e o conteúdo se acumula no canto superior esquerdo. Não confie apenas em portões automatizados para pegar isso; inspecione um snapshot. Esqueleto → references/minimal-composition.md.

Uma linha do tempo pausada

Cada composição registra exatamente uma gsap.timeline({ paused: true }) em window.__timelines["<id>"] (chave = data-composition-id raiz), construída sincronamente no carregamento da página. Duração da renderização = data-duration raiz, não comprimento da linha do tempo. Não aninhe manualmente sub-linhas do tempo no anfitrião. Contrato completo (incl. runtimes não-GSAP) → references/determinism-rules.md + hyperframes-animation/adapters/.

Pegadinhas do lint na primeira passagem (falha garantida na primeira construção)

Duas regras que o lint pega, mas apenas depois do fato — escreva-as corretamente da primeira vez:

  • O elemento de composição raiz deve carregar data-start="0" (junto com data-composition-id/data-width/data-height); omiti-lo faz o lint falhar com root_composition_missing_data_start.
  • Nunca emparelhe um transform CSS inicial com um tween GSAP na mesma propriedade — o valor CSS e o início do tween brigam e o lint rejeita com gsap_css_transform_conflict. Defina o estado inicial dentro do tween com gsap.fromTo(el, { x: -40 }, { x: 0 }) em vez de um CSS transform: translateX(-40px).

Regras inegociáveis (bugs silenciosos que portões automatizados podem perder)

Expadas aqui; justificativa completa na referência vinculada. Não viole:

  • Sem relógios em tempo de renderização / Math.random não seedado / rede / estado de entrada; sem repeat: -1 (use uma contagem finita). → determinism-rules.md
  • Anime apenas a lista de permissão de propriedades visuais; nunca aplique tween em display ou visibility bruto. autoAlpha do GSAP e conjuntos de limite de linha do tempo de duração zero são as únicas exceções de visibilidade, e apenas em elementos não-clip ou wrappers dentro de um clip. O framework sozinho controla a visibilidade de .clip. Não faça gsap.set em clipes de cena posterior no carregamento da página. → determinism-rules.md
  • Sem <br> em texto do corpo; elementos transformados devem ser nível de bloco + dimensionados; decorativos absolutos pulsantes precisam de folga de pico. → determinism-rules.md
  • <video>/<audio> funcionam em qualquer profundidade de aninhamento (incluindo dentro de um <template> ou wrapper de sub-comp); o framework controla a reprodução e busca/decodifica a mídia onde quer que ela esteja. A única ressalva são as linhas do tempo, não o posicionamento: a linha do tempo de uma sub-comp não pode animar elementos raiz do anfitrião. → variables-and-media.md
  • Cada id deve ser único em toda a página montada; dentro de uma sub-comp, prefixe ids com o id da composição (#<id>-hero). IDs duplicados de <video>/<img> renderizam em branco — o produtor injeta quadros por getElementById, e duplicatas entre arquivos escapam do lint. → composition-patterns.md
  • Um preenchimento de cena de tela cheia vai em um filho de sangria total (position:absolute; inset:0), nunca na raiz da composição — a composição de quadros do produtor pode descartar o background do próprio elemento raiz (o quadro renderiza preto) mesmo que a pré-visualização/snapshot mostre-o corretamente. → composition-patterns.md

Editando composições existentes

  • Leia os arquivos primeiro. Preserve temporização, trilhas, IDs, variáveis, caminhos de mídia não relacionados.
  • Combine IDs de composição e chaves de linha do tempo existentes.
  • Adicionando um clipe: escolha um data-track-index sem sobreposição ou ajuste a temporização circundante intencionalmente.
  • data-hidden em qualquer elemento de composição o esconde TANTO na pré-visualização QUANTO na renderização, substituindo sua janela de tempo; é não destrutivo/reversível e alternado pelo ícone de olho da linha do tempo do Studio.
  • Adicionando uma sub-composição: verifique seu data-composition-id interno antes de conectar o anfitrião.

Validação

Use hyperframes-cli para detalhes de comando

  • npx hyperframes check passa (0 descobertas em lint, runtime, layout, motion e contraste)
  • Projetos com sub-composições: npx hyperframes snapshot --at <midpoints> e examine cada quadro
  • npx hyperframes preview para revisão (o usuário pode editar qualquer coisa na linha do tempo do Studio)
  • npx hyperframes render apenas após o usuário aprovar

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

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.

Habilidades Relacionadas