Communitygithub.com

AlessandroFare/fluxychat

Transforme um arquivo .md de changelog semanal em um vídeo de changelog finalizado e com marca (1080p quadrado, ~45-60s, VO da Annie, fundo animado com a marca, visualizações em mock-UI, legendas discretas). Use quando o usuário fornecer um changelog/digest markdown e quiser o vídeo semanal, ou disser "changelog vídeo".

O que é fluxychat?

Este skill, `AlessandroFare/fluxychat`, é um pipeline completo e autocontido para converter changelogs em markdown em vídeos de changelog semanais estilizados e com a marca HyperFrames. Ele opera de forma determinística: exige um conjunto específico de ativos (fontes, fundo animado, trilha sonora), um scaffold de projeto mestre e uma doutrina de movimento. O skill não é uma ferramenta de edição de vídeo genérica: ele força visualizações de UI animadas para cada tema em vez de listas de tópicos, usa uma camada de script de duas camadas (fala vs. exibição) para sincronizar a narração com legendas precisas e garante a consistência da marca com um pipeline de verificação rigoroso. Cada etapa, desde a inicialização do projeto com os ativos corretos até a renderização final, é codificada no SKILL.md; desvios (como usar um index.html de vídeo anterior ou pular a geração de legendas) são explicitamente proibidos. O resultado é um vídeo de changelog de 45 a 60 segundos (1080p quadrado) com a VO da Annie, legendas e uma estética de marca controlada — pronto para publicação sem ajustes adicionais.

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

Perguntar na sua IA favorita

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

Documentação

Changelog → Vídeo com Marca

Entrada: um changelog .md (temas + itens, como o resumo semanal HyperFrames). Saída: um projeto HyperFrames limpo, com portão verde e sem erros, em projects/active/weekly-changelog-<range>/. Renderize apenas quando solicitado.

Carregue primeiro, sem negociação: motion-doctrine (+ cut-the-curve, oversized-cursor se um cursor aparecer, seam-craft) e captions-overlay. Este skill fornece o pipeline específico para changelog; a doutrina fornece a lei do movimento.

A diretriz principal: visualize, não liste

Cada tema é ilustrado por um mock animado da UI real ou de um análogo fiel representando a mudança na experiência — nunca marcadores de texto. Roteie cada tema/item através de references/visualization-registry.md ANTES de escrever o roteiro; o registro decide ui-recreate / ui-analog / terminal / checklist. O checklist de texto é o ÚLTIMO recurso, reservado para itens genuinamente não visuais (listas de correções de confiabilidade).

Pipeline

0 · Inicialize o projeto a partir dos ativos DESTE skill — sem negociação

Faça isso antes de escrever qualquer HTML de composição. Pular esta etapa sempre produz um vídeo que se parece com um projeto similar que você construiu antes, NÃO com a marca deste skill — essa é a maneira mais comum de este skill perder a identidade da marca. Os ativos, fontes e scaffold do skill são o skill; o prompt SKILL.md é um roteador.

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

Depois leia references/build-spec.md do início ao fim (sem ler superficialmente) — ele define os tokens da marca (TT Norms Pro + ABC Solar Display + TT Norms Mono, creme #f5f6f4, verde racionado #5ef17c, cartões de vidro com bordas verdes, formato de pílula para kicker/sec-chip, trilho de legendas de 32px em top: 990) que cada cena herda do scaffold.

Só ENTÃO comece os passos 1-6 abaixo. Os passos 1-4 (analisar, rotear, roteiro, VO) planejam o que vai no scaffold; o passo 5 preenche os espaços reservados (<RANGE>, <TOTAL>, <CUT_N>, <DUR_N>, corpos das cenas) dentro do project/index.html já copiado — você NÃO reescreve o chrome, fontes, paleta ou layout do scaffold.

Se você se pegar usando cp em um index.html de vídeo anterior, ou escrevendo suas próprias declarações @font-face, ou projetando um fundo de shader WebGL em vez de usar o bg-pattern MP4 codificado acima: PARE. Delete o index.html atual e recomece no cp do scaffold master-skeleton. Reconstruir o conteúdo da cena no scaffold correto é mais barato do que adaptar a marca ao scaffold errado.

1 · Analisar + corte editorial

  • Extrair: intervalo da semana, estatísticas principais (lançamentos, commits), temas, itens.
  • Orçamento: 45-60s no total. Título ≤2s, encerramento ≤3,5s, 4 temas ≈ 9-12s cada.
  • Por tema, mantenha UMA visualização principal + no máximo 3 itens falados. Todo o resto existe apenas como o ponteiro de "resumo completo" do encerramento. Cortar é a função: um changelog com 30 itens ainda rende ≤14 compassos falados.
  • Ordene os temas por história: recurso principal → superfície do produto → desempenho → confiabilidade (o resumo geralmente já está assim).

2 · Roteamento da visualização

Para cada tema, escolha a superfície de references/visualization-registry.md e escreva uma linha: tema → superfície → as 2-4 ações sequenciais que o mock executa, cada uma ligada a uma frase do roteiro. Se nenhuma superfície do registro se encaixa e nenhum análogo fiel existe, é uma cena de checklist — não invente UI falsa para algo que não podemos representar honestamente.

3 · Roteiro de duas camadas (fala vs. exibição)

Escreva o roteiro como linhas de token conforme references/script-voice.md: registro conversacional, cada termo técnico carregando uma forma spoken fonética de references/lexicon.json enquanto display mantém a grafia padrão. As legendas mostram display; o VO lê spoken. Qualquer termo que não esteja no léxico: PARE e pergunte ao usuário como se pronuncia, depois adicione ao léxico. Salve como script-tokens.json no projeto.

4 · VO — Annie (HeyGen, fixa)

# texto da camada falada apenas; words JSON = timestamps de verdade do texto FALADO
# Caminho nativo do repositório: o skill changelog-video é executado a partir da raiz do repositório hyperframes,
# então ele usa o auxiliar TTS hyperframes-media rastreado diretamente (sem etapa de instalação `npx hyperframes
# skills`). Se você copiou o skill para outro repositório, substitua pelo
# seu próprio caminho para o script heygen-tts.mjs do hyperframes-media.
node skills/hyperframes-media/scripts/heygen-tts.mjs ./vo-spoken.txt \
  -o voiceover.mp3 --words vo-words.json \
  --voice 330290724a1b470fb63153f34d4c0183   # Annie — realista (não substitua)

Requer CLI heygen ≥0.3.0 autenticado (heygen auth login --oauth). Em seguida, alinhe os timestamps falados de volta aos tokens de exibição:

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

captions.json é a entrada do trilho de legendas (grafia de exibição, tempo de fala). O alinhador imprime avisos MISMATCH — resolva cada um antes de construir (geralmente uma grafia do léxico que o TTS renderiza como várias palavras). O áudio é o relógio: todos os tempos dos compassos vêm de vo-words.json; uma regeração do VO reabre cada costura.

Os timestamps das palavras são um portão rigoroso. Antes de prosseguir para o passo 5, verifique se vo-words.json não está vazio e tem um array words: [...] com start/end por palavra. Se estiver vazio (0 bytes) ou faltar o array — um modo de falha conhecido quando o provedor TTS retorna áudio, mas sem payload de timestamp — NÃO PROSSIGA sem eles. Fallback: alinhamento forçado do áudio produzido contra o roteiro de exibição usando whisper local:

uvx --from openai-whisper whisper voiceover.mp3 \
  --model base.en --language en --word_timestamps True \
  --output_format json --output_dir .
# depois execute align-captions.mjs com --words voiceover.json (mesma forma)

O Whisper ouve mal as renderizações do TTS ("gee-sap" → "gsap", "heyjen" → "hey Jen", etc.) — as legendas ainda usam a grafia DISPLAY de script-tokens.json; whisper fornece apenas os timestamps. align-captions.mjs lida com a junção. Este fallback é a diferença entre uma construção legendada e uma silenciosamente não legendada.

5 · Construir

Siga references/build-spec.md exatamente: tokens da marca + fontes (empacotadas em <SKILL_DIR>/assets/), a codificação do fundo animado, scaffold da cena, chrome, trilho de legendas, um momento verde racionado por cena. Depois, a ordem da doutrina: ledger.json (todas as costuras comuns cut-the-curve LEFT) → carimbo de costura → compassos internos nas palavras do VO → verificação de portão de costura.

Legendas são obrigatórias. O master-skeleton envia um IIFE de trilho de legendas que lê um array LINES — deixar esse array vazio é um bug enviado, não uma escolha de estilo. Preencha-o a partir de captions.json antes de prosseguir para o passo 6:

// cole no lugar de "const LINES = /* … */ []" no IIFE do trilho de legendas:
const LINES = /* conteúdo de captions.json */ [
  { id: 0, end: 2.74, w: [["Esta", 0.0], ["semana,", 0.30], …] },
  …
];

Se align-captions.mjs foi pulado ou LINES estiver [], a verificação de quadro no passo 6 falhará — não ignore removendo #cap-line do scaffold.

6 · Portões (tudo verde antes de apresentar)

  1. bun run --cwd packages/cli hyperframes check (ou o CLI hyperframes instalado do skill skills/hyperframes-cli/ local ao repositório) — 0 erros (contraste: texto escuro ≥ 0,66 alpha). NÃO use npx hyperframes@latest; o CLI rastreado local ao repositório é a fonte de verdade para o contrato de composição que este skill produz.
  2. seam-gate.mjs verify — 0 falhas.
  3. Reinicie o servidor de visualização (ele armazena em cache o pacote), verifique 3-4 compassos via __player.seek na página de composição bruta.
  4. NÃO renderize a menos que o usuário peça. Após uma renderização solicitada, verifique quadros do MP4 (ffmpeg -ss <t> … -frames:v 1): legendas presentes, vídeo de fundo não preto, sem quadros pequenos/congelados.
  5. Portão de presença de legendas — falha grave. Amostre 3-4 quadros distribuídos pela janela de fala do VO (por exemplo, t=3, t=15, t=30, t=42 para um VO de 48s) e confirme que o trilho de legendas em top: 990 renderiza texto visível em cada um. Se algum quadro em um intervalo de fala estiver sem legendas, a construção envia vídeo não legendado — trate como um portão vermelho e verifique novamente a população de LINES do passo 5. É exatamente isso que deu errado na construção da v4 de 13 a 20 de julho.

Layout do projeto

projects/active/weekly-changelog-<range>/
├── index.html            # mestre de documento único (cenas como slides, costuras carimbadas)
├── ledger.json           # ledger vetorial (entrada do carimbo de costura)
├── script-tokens.json    # roteiro de duas camadas (fonte de verdade para VO + legendas)
├── vo-spoken.txt         # gerado: camada falada, uma linha
├── voiceover.mp3 + vo-words.json + captions.json
├── bgm.mp3               # cópia de <SKILL_DIR>/assets/bgm.mp3 (a faixa principal) a menos que o usuário forneça uma
└── assets/fonts/ + assets/bg-pattern-<dur>s.mp4

Anti-padrões

NãoEm vez disso
Slides com marcadores para mudanças de UISimule a superfície representando a mudança
UI falsa para itens não representáveisCena de checklist honesta
"JSON"/"CLI" simples no texto do TTSFormas faladas do léxico; exibição permanece padrão
Grafias fonéticas nas legendasLegendas sempre renderizam a camada de exibição
Adivinhar a pronúncia de um termo desconhecidoPergunte, depois aumente o léxico
Falar cada item do changelog≤3 por tema; o link do resumo carrega o resto
Destaques verdes em todo lugarUm momento verde por cena (#5ef17c)
Começar de um index.html de vídeo anteriorPasso 0 — copie examples/master-skeleton.html deste skill para project/index.html, sempre
@font-face / shader WebGL / BGM personalizadoPasso 0 — copie os assets/ deste skill literalmente; os ativos do skill SÃO a marca
Entregue sem invalidação do CloudFrontExecute aws cloudfront create-invalidation na distribuição E2BSLVSZ7FG3U0 para o caminho exato após qualquer substituição no S3 — o CDN armazena o arquivo antigo
Enviar com o array LINES vazio no scaffoldPasso 4 deve produzir um captions.json preenchido; passo 5 deve colá-lo no IIFE; passo 6, portão 5 deve confirmar legendas nos quadros renderizados. Um LINES vazio = envio sem legendas = refazer a execução
Sem vo-words.json → pular legendas e enviarRecurso ao alinhamento forçado com whisper no áudio produzido; legendas são obrigatórias

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.

Habilidades Relacionadas