Communitygithub.com

sansayan01/finance_app_zo

O contrato de composição do HyperFrames — construa um projeto renderizável. Use para estrutura de composição, atributos `data-*` de tempo, `class="clip"`, faixas, sub-composições, variáveis, reprodução de mídia gerenciada 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 é finance_app_zo?

Esta skill define o contrato técnico central do HyperFrames, um framework que renderiza vídeo a partir de HTML. Ela ensina como construir um único projeto de composição, detalhando a estrutura de arquivos, os atributos `data-*` para controle de tempo, o uso de faixas (`data-track-index`) e sub-composições, além de como gerenciar a reprodução de mídia (vídeo/áudio) de forma determinística. A skill cobre tanto composições independentes quanto sub-composições, com regras rígidas para evitar bugs silenciosos que ferramentas de lint/validação não capturam, como a exigência de que o elemento raiz tenha largura/altura explícitas e que IDs sejam únicos em toda a página montada. Também inclui orientações sobre como editar composições existentes, adicionar clipes ou sub-composições sem quebrar a linha do tempo, e como usar a CLI do HyperFrames para validar, visualizar e renderizar o projeto. Além disso, aborda o uso de Tailwind v4 e os formatos de plano STORYBOARD.md e SCRIPT.md para organizar o roteiro visual.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/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 tempo de execução de animação é buscável (seekable) e cuja reprodução de mídia é gerenciada pelo framework.

Esta 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/ (leia sob demanda). Outros assuntos estão nas skills de domínio irmãs — hyperframes-animation, hyperframes-creative, media-use, hyperframes-cli, hyperframes-registry. O mapa de capacidades em /hyperframes diz o que cada uma cobre.

Referências

ArquivoLeia para…
references/minimal-composition.mdcomeçar pelo menor esqueleto de composição renderizável
references/composition-patterns.mdescolher monolítica vs modular; estruturar um index.html modular; escolher um arquétipo de sub-comp
references/data-attributes.mdconsultar qualquer data-* (raiz / clip / host de sub-comp / aliases legados); usar class="clip"
references/tracks-and-clips.mdescolher data-track-index, lidar com sobreposição / z-index na mesma faixa, temporizar um clip relativo a outro
references/sub-compositions.mdconectar uma sub-composição (atributos do host, <template>, variáveis 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; lista de propriedades animáveis permitidas; layout / ajuste de texto
references/full-screen-motion.mdcriar movimento em tela cheia com fundos compartilhados
references/storyboard-format.mdcriar um plano STORYBOARD.md (+ o manifesto analisado)
references/brief-contract.mdconduzir a entrada de um fluxo de criação — modo de interação (colaborativo / autônomo), campos compartilhados do brief, regras de pergunta
references/script-format.mdcriar a narração travada opcional SCRIPT.md
references/subagent-dispatch.mdmapear verbos de despacho de subagentes (fan-out paralelo / segundo plano / espera) para seu harness
references/tailwind.mdtrabalhar em um projeto Tailwind v4 (init --tailwind; contrato de execução difere do Studio v3)

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)

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

⚠ Regra de transporte: o runtime apenas clona o conteúdo do <template>; tudo fora (incluindo estilos/scripts do <head>) é descartado — coloque <style>/<script> dentro do template. ⚠ Regra de ID do host: o data-composition-id do slot hospedeiro 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 host e checklist pré-renderização → references/sub-compositions.md.

A raiz deve ter tamanho definido (bug de layout silencioso)

A raiz independente precisa de uma caixa dimensionada explicitamente (width/height em px), e cada ancestral até um elemento com height:100% deve ter altura resolvida — caso contrário, um filho flex/100% colapsa para ~0 e o conteúdo se acumula no canto superior esquerdo. lint/validate/inspect não capturam isso. Esqueleto → references/minimal-composition.md.

Uma timeline pausada

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

Regras inegociáveis (bugs silenciosos que lint/validate/inspect não capturam)

Expõe-se aqui; fundamentação completa na referência vinculada. Não viole:

  • Sem relógios em tempo de renderização / Math.random sem semente / rede / estado de entrada; sem repeat: -1 (use uma contagem finita). → determinism-rules.md
  • Anime apenas a lista de propriedades visuais permitidas; nunca display/visibility; sem gsap.set em clips de cenas posteriores. → determinism-rules.md
  • Sem <br> em texto do corpo; elementos transformados devem ser em nível de bloco + dimensionados; elementos decorativos absolutos pulsantes precisam de folga de pico. → determinism-rules.md
  • <video>/<audio> deve ser filho direto da raiz do host (nunca dentro de um <template>/invólucro de sub-comp); o framework gerencia a reprodução. → variables-and-media.md
  • Cada id deve ser único em toda a página montada; dentro de uma sub-comp, prefixe os ids com o id da composição (#<id>-hero). IDs duplicadas de <video>/<img> renderizam em branco — o produtor injeta quadros por getElementById, e duplicatas entre arquivos escapam do lint. → composition-patterns.md
  • O preenchimento de uma cena em tela cheia vai em um filho sem margem (position:absolute; inset:0), nunca na própria raiz da composição — a composição de quadros do produtor pode descartar o background do elemento raiz (o quadro renderiza preto) mesmo que a pré-visualização/snapshot mostre corretamente. → composition-patterns.md

Editando composições existentes

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

Validação

Use hyperframes-cli para detalhes de comandos

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

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

sansayan01/finance_app_zo

The fallback workflow for authoring or editing any custom HyperFrames composition at any length or format — longer / multi-scene pieces, brand and sizzle reels, montages, title cards, static loops, freeform builds. Use only when no specialized workflow fits the input; routing table at /hyperframes.

sansayan01/finance_app_zo

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.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

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`.

sansayan01/finance_app_zo

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.

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

Habilidades Relacionadas