Communitygithub.com

AlessandroFare/fluxychat

Autor ou editar uma composição HyperFrames personalizada quando nenhum fluxo de trabalho especializado se encaixa, ou quando BRIEF.md define flow: companion. Use para peças de múltiplas cenas, reels de marca e sizzle, montagens, loops estáticos, cartões de título estáticos, remixes de footage e construções livres. Use motion-graphics para uma unidade curta e não narrada com foco em movimento, incluindo título animado. Roteie a criação nova através de hyperframes antes de usar esta skill.

O que é fluxychat?

Esta skill, AlessandroFare/fluxychat, é um workflow de uso geral para o HyperFrames, um framework de composição de vídeo. Ela atua como uma opção flexível para criar ou editar composições de vídeo personalizadas quando nenhum fluxo de trabalho especializado (como motion-graphics) se aplica ou quando o arquivo BRIEF.md especifica 'flow: companion', indicando uma colaboração mais próxima com o usuário. É ideal para projetos como reels de marca, montagens, loops estáticos, remixes de vídeo e construções livres que exigem uma abordagem mais artesanal e orientada a conceitos. A skill fornece um processo estruturado, começando com a verificação de atualizações, carregamento de adaptadores de fonte (mídia e Figma), inicialização do projeto, interpretação do fluxo de trabalho (automation vs. companion) e, em seguida, carregamento de conhecimento obrigatório para cada etapa (como regras de layout, animação, storyboard). Finalmente, ela executa a composição em uma ordem de dependência definida: planejamento, revisão, resolução de dependências, construção de cenas (com ou sem despacho para workers), validação e renderização. A skill enfatiza a execução de alta qualidade, especialmente no modo 'companion', onde o agente atua como um diretor criativo, projetando a melhor versão possível (o 'teto') e depois refinando com o usuário.

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

Perguntar na sua IA favorita

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

Documentação

Vídeo geral

Antes de confiar neste fluxo de trabalho, execute:

npx hyperframes skills update general-video

Um no-op bem-sucedido significa que a skill está atualizada. Informe uma falha de atualização em vez de continuar com base na memória.

1. Aplicar adaptadores de fonte transversais

  • Mídia: Para qualquer necessidade de áudio, imagem, ícone, logotipo, voz, grade, LUT, tratamento/efeito, legenda ou operação de mídia, carregue /media-use e siga ../media-use/references/resolve.md (resolver, adotar, reutilizar) e ../media-use/references/setup-providers.md (provedores, autenticação). Feedback vago de footage e estilos nomeados usam ../media-use/references/media-treatments.md antes de editar; não improvise efeitos de mídia suportados com CSS/SVG/opacidade. Antes da primeira ação autenticada do provedor, execute npx hyperframes auth status e repasse sua saída literalmente. Se desconectado, aplique a barreira em ../hyperframes-core/references/brief-contract.md: colaborativo aguarda o login ou uma escolha offline explícita; autônomo informa o status e continua através de um provedor offline disponível. Informe um bloqueador quando nenhum provedor offline puder satisfazer uma capacidade necessária. A adoção local sozinha não requer uma barreira de autenticação.
  • Figma: Se alguma entrada for uma URL figma.com, execute /figma primeiro. Construa a partir de seus ativos exportados, tokens, componentes ou quadros de storyboard. Não use chamadas brutas do conector Figma porque elas ignoram a sanitização SVG, a proveniência de mídia e a vinculação de tokens de marca.

Esses adaptadores não alteram o fluxo de trabalho selecionado por /hyperframes.

2. Iniciar a partir do estado do projeto

Aplique a primeira linha correspondente; não avalie linhas de estado inferiores:

EstadoAção
Edição específicaFaça a edição, preserve as decisões existentes do projeto e, em seguida, reexecute as verificações afetadas. Não reabra a descoberta.
BRIEF.md existeLeia-o. Se workflow nomear outro fluxo de trabalho e flow não for companion, entregue. Não faça perguntas sobre o brief.
Sem brief, mas hyperframes.json ou STORYBOARD.md existeRetome a partir dos arquivos e preferências registradas. Preencha BRIEF.md apenas com fatos conhecidos.
Criação novaExecute /hyperframes e sua camada de intenção. Retorne aqui apenas para workflow: general-video ou flow: companion.

Para um novo projeto, escolha um nome de diretório em kebab-case a partir do brief e crie o esqueleto antes de escrever o brief:

npx hyperframes init "videos/<projeto>" --non-interactive --example=blank --skill=general-video

Em seguida, escreva BRIEF.md na raiz do projeto usando ../hyperframes-core/references/brief-format.md. Em um projeto existente, a raiz é o diretório que contém hyperframes.json. Registre apenas os campos confirmados e baseados em preferência nomeados pelo formato do brief, usando node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>; nunca registre padrões inferidos. Aqui <MEDIA_DIR> é o diretório da skill /media-use instalada e <PROJECT_ROOT> é o diretório que contém hyperframes.json. Se a camada de intenção adotou uma receita, aplique-a agora com node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <nome> e não pergunte novamente.

3. Interpretar a forma da execução

Use apenas os termos canônicos de ../hyperframes-core/references/brief-contract.md:

CampoSignificadoEfeito
flowQuem dirigeautomation: escolha e execute a rota. companion: cocrie em conversa.
storyboardSe o quadro é uma superfície de revisãoyes: execute revisão de plano e esboço. no: construa sem o quadro.
mode derivadoComo as barreiras de checkpoint se comportamSiga o contrato do brief. Nunca peça ao usuário para nomear um modo.

Não invente sinônimos para esses estados. Um sinal contínuo de "apenas construa" é tratado pela camada de intenção e chega como flow: automation, storyboard: no.

  • Para flow: automation, escolha a rota e declare-a em uma linha na primeira atualização de progresso.
  • Para uma edição específica, faça a edição sem inventar uma nova rota.

Fluxo companion

Quando flow: companion:

  • Leia BRIEF.md e reconcilie ## Assets e ## Customizações aceitos com os artefatos do projeto. Complete o trabalho aceito que ainda está pendente; deixe o trabalho concluído em paz; não ofereça uma capacidade aceita novamente como se fosse nova.
  • Chegue como o diretor, não o empreiteiro. Um usuário que escolheu companion escolheu envolvimento e qualidade; a resposta honesta é a melhor versão que você pode projetar, não a menor que você pode defender. O primeiro plano é o tratamento de teto: o arco da história (pegue emprestada a lente de gênero mais próxima — menu § Lentes de gênero), a especificação de design, o tratamento de movimento de cada cena citado pelo nome (§ 5 da disciplina de plano), as transições, a identidade de áudio — música e marcas sonoras, ou silêncio deliberado — o material do usuário colocado, e uma abertura e fechamento projetados. Diga o que cada camada adiciona em uma linha; sinalize as caras (tempo de renderização, login, faturamento) conforme as nomeia. O usuário reduz um tratamento; eles nunca devem ter que montar um aprovação por aprovação.
  • O teto pertence ao conceito, não à caixa de ferramentas. Cada camada deve servir à mensagem do brief — um tratamento que vestiria qualquer vídeo da mesma forma é decoração. O trabalho artesanal sobe ao teto; o conteúdo nunca cresce além do que foi solicitado (§ 6).
  • Entre checkpoints, ../hyperframes/references/capability-menu.md funciona de duas maneiras. Como a lista de gatilhos: ofereça uma capacidade relevante quando o usuário mencionar sua entrada ou a construção atingir sua necessidade. Como o canal de atualização de cada passagem: um checkpoint de plano, esboço ou construção pode carregar uma ou duas ofertas rastreadas apontadas para o material que o usuário está olhando ("a estatística da cena 3 quer o tratamento de contagem"). Leia antes de oferecer; nunca despeje o catálogo completo.
  • Depois que o usuário aceitar uma capacidade, produza seu artefato e registre a decisão na seção de corpo correspondente do BRIEF.md imediatamente. Reescreva um campo de frontmatter e registre a preferência confirmada apenas quando o usuário a alterar explicitamente.
  • Mantenha as mesmas barreiras de storyboard, validação, pré-visualização final e aprovação de renderização. Companion muda quem dirige, não o que a qualidade exige.

4. Carregar conhecimento obrigatório antes de cada etapa

Estas leituras são obrigatórias quando sua condição corresponder:

CondiçãoLer antes de agir
Qualquer HTML de composição ou layout de cena/hyperframes-core; use references/determinism-rules.md para seu contrato de layout
Qualquer criação não trivial ou tratamento visual/hyperframes-creative → references/house-style.md e references/video-composition.md
Qualquer movimento, animação ou transição de cena/hyperframes-animation; siga seu roteamento para as regras, adaptadores, blueprints ou referências de transição correspondentes
storyboard: yes../hyperframes-core/references/storyboard-format.md e ../hyperframes-core/references/review-loop.md
Qualquer ativo ou operação de mídia, incluindo narração, BGM, SFX, legendas, gradação ou transformações/media-use; para reprodução e posicionamento no framework, leia também /hyperframes-core → references/variables-and-media.md
Montagem de múltiplas cenas../hyperframes-core/references/production-loop.md
flow: companion, antes do primeiro plano/hyperframes-creative → references/story-spine.md e references/house-style.md; a lente de gênero mais próxima e o ../hyperframes/references/capability-menu.md completo — o tratamento de teto é projetado a partir destes, não lembrado
Uma oferta, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade de fluxo de trabalho cruzado companion../hyperframes/references/capability-menu.md
Uma especificação de design existe, antes da aprovação final/hyperframes-creative → references/design-adherence.md

Não substitua essas leituras por recordação. A divulgação progressiva salva contexto apenas quando a referência correspondente é realmente carregada.

5. Executar a composição

Use esta ordem de dependência. Pule uma etapa apenas quando sua entrada estiver ausente.

  1. Plano. Declare o arco do espectador, estrutura, ritmo e motor de duração. Use um arquivo para uma cena única curta; use subcomposições para três ou mais cortes de cena difíceis ou qualquer cena reutilizada. Leia /hyperframes-creative → references/story-spine.md para arcos narrados, references/beat-direction.md para ritmo e /hyperframes-core → references/composition-patterns.md para estrutura. Para um brief de múltiplas cenas aberto, expanda o prompt através de /hyperframes-creative → references/prompt-expansion.md. Um plano de múltiplas cenas cita a forma de cada cena: um id de blueprint de /hyperframes-animation → blueprints-index.md quando um se encaixa, ou as regras nomeadas que ele compõe de rules-index.md quando nenhum se encaixa — nomes de movimento vêm desses índices, nunca inventados. A verdade da história decide quais cenas existem; a citação as veste. Um plano de múltiplas cenas também é registrado como o artefato de despacho: um bloco ## Quadro N por cena em STORYBOARD.md — status: outline, um src: declarado, a citação de blueprint/regras e o texto da batida — mesmo quando storyboard: no. O bloco é a unidade de despacho; o quadro é apenas a superfície de revisão.
  2. Revisar o plano quando solicitado. Para storyboard: yes, execute o loop de revisão compartilhado sobre esses blocos. Para storyboard: no, continue sem abrir o quadro. Quando uma pausa de plano acontecer de qualquer forma, dobre a concessão de delegação do subagente (necessária pelo codex para o despacho da etapa 4) nessa pausa, em vez de parar novamente mais tarde.
  3. Resolver dependências. Instale blocos de registro antes do trabalho paralelo. Prepare ativos do usuário, adote mídia existente e resolva apenas o que o brief exige. Inicie o áudio cedo quando seus tempos ditarem a duração.
  4. Construir cenas. Para uma peça curta de cena única, implemente a cena em seu momento mais visível antes de adicionar movimento (o wireframe confirmado, quando presente, é esse estado final e não deve ser redesenhado), depois anime a partir de seu blueprint ou regras citadas — leia o corpo completo da receita (/hyperframes-animation → blueprints/<id>.md, rules/<id>.md) antes de escrever o movimento.

O despacho só se paga em escala. Criar pacotes e aquecer contextos de worker fresco custa minutos e tokens reais: um filme de até ~6 cenas curtas constrói MAIS RÁPIDO inline, neste contexto, uma cena após a outra (medido: 5 cenas curtas ≈ 9 min inline vs ≈ 21 min empacotado). Distribua apenas quando o plano exceder isso — mais cenas, ou individualmente pesadas — e então dê a cada worker 2–3 cenas, não uma, e spawn todos os workers em uma única onda (uma segunda onda quase dobra o tempo). Ao despachar:

node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"

O construtor escreve um pacote limitado por cena em .hyperframes/frame-packets/ (o bloco de storyboard exato da cena + o corpo do blueprint + cada regra citada, inline) e _role.md (../hyperframes-core/references/frame-worker.md). 5. Validar. Execute todas as verificações de qualidade:

  • Um problema de mídia ou provedor? Execute /media-use → references/quality.md.
  • Um problema de composition? Execute /hyperframes-core → references/quality.md.
  • Um problema de movimento? Execute /hyperframes-animation → references/quality.md.
  • Um problema de criatividade? Execute /hyperframes-creative → references/quality.md.
  • Um problema de licenciamento ou conformidade? Execute ../hyperframes/references/compliance.md.
  1. Pré-visualizar aprovação e ajuste fino. Quando a saída do build existir, leia ../hyperframes-core/references/preview-loop.md e, em seguida, execute npx hyperframes preview para iniciar o servidor de pré-visualização. Mostre ao usuário: "Pré-visualização disponível em: " e espere feedback. Faça ajustes finos baseados no feedback e revalide.
  2. Renderizar a saída final. Execute npx hyperframes build --production e forneça ao usuário o caminho de saída localizado e uma breve descrição. Não peça aprovação de renderização; a aprovação já ocorreu.

6. Manter o escopo e a profundidade

  • Nunca aumente o escopo do vídeo. A cena, duração e complexidade do brief são os limites. Um tratamento projetado não adiciona cenas, prolonga a duração ou adiciona complexidade não solicitada.
  • Cada cena deve conter seu próprio conceito. Uma cena que apenas conecta duas outras é uma transição, não uma cena. Cada cena deve avançar a mensagem, não apenas a duração.
  • A profundidade do projeto é medida em suporte de mensagem, não em densidade de camadas. Uma cena com uma ideia clara comunicada de forma eficaz tem mais profundidade do que uma cena com dez camadas que não servem a mensagem.

7. Arquivos de skill

Dentro do diretório de skill, os seguintes arquivos compõem este workflow:

  • SKILL.md — este arquivo
  • scripts/ — scripts de suporte para gerenciamento de preferências (prefs.mjs), receitas (recipe.mjs) e pacotes de quadro (frame-packets.mjs)
  • references/ — referências para o menu de capacidade e conformidade
  • ../hyperframes-core/ — skill de base para contratos de composição
  • ../hyperframes-creative/ — skill criativa para tratamento de movimento e design
  • ../hyperframes-animation/ — skill de animação para blueprints e transições
  • /media-use — skill de gerenciamento de mídia para ativos, provedores e tratamentos

Não carregue ou modifique arquivos fora desses caminhos sem instrução explícita.


Esta skill é direcionada por BRIEF.md e pela camada de intenção /hyperframes. Atualizações podem ser obtidas executando npx hyperframes skills update general-video.

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

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