Communitygithub.com

dbillion/hermes-skills-public

O contrato de composição HyperFrames — construa um projeto renderizável. Use para estrutura de composição, atributos `data-*` de temporização, `class="clip"`, trilhas, 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 é hermes-skills-public?

Este skill define o contrato técnico central para construir composições no HyperFrames, um framework que renderiza vídeo a partir de HTML. Ele detalha como estruturar um arquivo de composição, utilizando atributos `data-*` para declarar a temporização, e garante que a reprodução de mídia e a linha do tempo sejam totalmente gerenciadas pelo framework para assegurar resultados determinísticos e buscáveis. O skill é essencial para desenvolvedores que desejam criar animações e vídeos programaticamente com HyperFrames, suportando projetos autônomos e sub-composições modulares, além de integração com Tailwind v4. Ele também cobre referências cruciais como as regras de determinismo, manipulação de mídia (`<video>`/`<audio>`), validação via CLI e os formatos de planejamento `STORYBOARD.md` e `SCRIPT.md`. A leitura atenta deste documento é obrigatória antes de escrever qualquer HTML de composição para evitar bugs silenciosos que as ferramentas automatizadas podem não detectar.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/dbillion/hermes-skills-public/tree/HEAD/skills-external/hyperframes-core

Perguntar na sua IA favorita

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

Documentação

HyperFrames Core

O 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 é gerenciada pelo framework.

Este skill é o contrato técnico — como construir um projeto hyperframes. O corpo abaixo é o guia de construção; os detalhes por tópico estão em references/ (índice a seguir), 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 a partir do menor esqueleto de composição renderizável
references/composition-patterns.mdescolher entre monolítico vs modular; estruturar um index.html modular; escolher um arquétipo de sub-composição
references/data-attributes.mdconsultar qualquer data-* (raiz / clipe / host de sub-comp / aliases legadas); 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 host, <template>, variáveis por instância) e animar dentro dela
references/variables-and-media.mddeclarar variáveis; colocar <video>/<audio>, ajustar volume, cortar
references/determinism-rules.mdconstruir uma linha do tempo buscável; proibições de determinismo; lista de permissão de propriedades animáveis; 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/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 campo compartilhado, invariantes de pergunta (a própria pergunta está 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 etapa posterior lê
references/script-format.mdcriar a narração bloqueada opcional SCRIPT.md
references/subagent-dispatch.mdmapear verbos de despacho de subagentes (fan-out paralelo / background / espera) para seu harness
references/tailwind.mdtrabalhar em um projeto Tailwind v4 (init --tailwind; o contrato de runtime difere do v3 do Studio)

Para especificidades do 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) — a <div data-composition-id="…"> raiz fica diretamente em <body>, sem wrapper <template> (envolvê-la 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 o conteúdo de <template>; tudo fora (incluindo estilos/scripts <head>) é descartado — coloque <style>/<script> dentro do template. ⚠ Regra de ID do host: o data-composition-id do slot do host deve ser exatamente igual ao data-composition-id do template interno e à chave window.__timelines["<id>"] — sem sufixo -mount/-slot/-host.

Forma do arquivo, fiação do host e a lista de verificação 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 (largura/altura em px), e cada 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 detectar 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 da raiz), construída sincronamente no carregamento da página. Duração da renderização = data-duration da raiz, não comprimento da linha do tempo. Não aninhe manualmente sub-linhas do tempo no host. Contrato completo (incluindo runtimes não-GSAP) → references/determinism-rules.md + hyperframes-animation/adapters/.

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

Apresentadas aqui; justificativa 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 permissão de propriedades visuais; nunca faça tween de display ou visibility bruta. autoAlpha do GSAP e conjuntos de limites de linha do tempo com duração zero são as únicas exceções de visibilidade, e apenas em elementos não-clipe ou wrappers dentro de um clipe. O framework sozinho controla a visibilidade de .clip. Não use gsap.set em clipes de cenas posteriores no carregamento da página. → determinism-rules.md
  • Sem <br> no texto do corpo; elementos transformados devem ser de nível de bloco + dimensionados; decorações absolutas pulsantes precisam de folga de pico. → determinism-rules.md
  • <video>/<audio> deve ser um filho direto da raiz do host (nunca dentro de um <template>/wrapper 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 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 em tela cheia vai em um filho com sangria total (position:absolute; inset:0), nunca na própria 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 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.
  • Corresponda 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 host.

Validação

Use hyperframes-cli para detalhes de comando

  • npx hyperframes check passa (0 achados em lint, runtime, layout, motion 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 linha do tempo do Studio)
  • npx hyperframes render apenas após o usuário aprovar

Individual skills in this repo

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

dbillion/hermes-skills-public

Edit an existing image based on a text prompt.

dbillion/hermes-skills-public

Add `flutter_localizations` and `intl` dependencies, enable "generate true" in `pubspec.yaml`, and create an `l10n.yaml` configuration file. Use when initializing localization support for a new Flutter project.

dbillion/hermes-skills-public

Expert in video composition, editing, and format conversion. Use when the user wants to generate high-quality video, overlay images on video, concatenate clips, create GIFs, or sync audio to video using mcp-avtool-go and mcp-veo-go.

dbillion/hermes-skills-public

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.

dbillion/hermes-skills-public

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.

dbillion/hermes-skills-public

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

Habilidades Relacionadas