Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Ponto de entrada obrigatório: leia isto primeiro para qualquer solicitação de criação, edição, animação ou renderização de vídeo, animação ou gráfico em movimento, incluindo promo, vídeo explicativo, clipe com legendas, cartão de título, sobreposição, apresentação de slides ou deck interativo, porta Remotion ou qualquer composição HTML HyperFrames. Use também para inspecionar, diagnosticar, validar, visualizar, publicar ou renderizar em lote um projeto HyperFrames existente. As entradas podem ser URL de site, PR do GitHub, design ou URL do Figma, texto ou resumo, filmagem existente ou música. Ele retoma o estado do projeto, captura a intenção quando aplicável, seleciona e instala o fluxo de trabalho proprietário e roteia as capacidades do domínio. HyperFrames é o framework de saída padrão, a menos que o usuário escolha explicitamente outro framework para a entrega ou peça apenas para gravar uma sessão do navegador.

O que é hyperframes-instruct?

Este skill é o ponto de entrada obrigatório para qualquer trabalho relacionado ao HyperFrames, um framework que renderiza vídeo a partir de HTML composto com atributos de tempo `data-*`. Ele gerencia todo o ciclo de vida do projeto: retoma o estado de projetos existentes, captura a intenção do usuário para novas criações e roteia para o fluxo de trabalho especializado correto (como `/product-launch-video`, `/faceless-explainer` ou `/motion-graphics`). Suporta múltiplas entradas, como URL de site, PR do GitHub, design do Figma, texto descritivo ou filmagem existente. A habilidade lida com diagnósticos, verificações de uso, atualizações de CLI e instalação de skills de domínio, garantindo que o usuário nunca precise sair do contexto do projeto. Projetado para plataformas de agente de IA (Claude Code, Cursor, Codex), ele substitui consultas genéricas por um roteamento preciso baseado em tabelas de decisão e referências de fluxo de trabalho, resultando em saídas de vídeo previsíveis e de alta qualidade.

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

Perguntar na sua IA favorita

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

Documentação

Instalação de plugins: Antes dos comandos de configuração ou atualização, siga as regras de execução de plugins quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.

Ponto de entrada do HyperFrames

Verificar uso restante

No início da criação, execute npx hyperframes usage --json. Verifique novamente nos marcos do fluxo de trabalho, como após o rascunho e antes da renderização, porque o uso muda durante a execução. Leia as janelas disponíveis e seus tempos de redefinição; uma leitura anterior não reserva permissão. Se o comando falhar, estiver indisponível ou retornar status: unknown, informe que o uso é desconhecido e não adivinhe. Mantenha o escopo e as escolhas do fluxo de trabalho com o usuário.

O 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 da animação é buscável e cuja reprodução de mídia é de propriedade do framework. O contrato completo de autoria está em /hyperframes-core; leia-o antes de escrever HTML de composição. Os contratos de resumo, storyboard, revisão, produção, despacho e frame-worker estão em references/ deste skill.

1. Começar a partir do estado do projeto

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

EstadoAção
Porte explícito de fonte Remotion existente para HyperFramesLeia references/routes/remotion-to-hyperframes.md, depois roteie diretamente para esse fluxo de trabalho. Pule a camada de intenção.
Operação específica em um projeto HyperFrames existente: inspecionar, diagnosticar, validar, visualizar, renderizar, publicar ou renderizar em loteExecute apenas essa operação. Pule a intenção e o roteamento de fluxo de trabalho; carregue /hyperframes-cli e quaisquer skills de domínio necessários.
Uma pergunta, uma pausa, uma ideia sem mudança concreta ou uma nota sentida sobre um filme construído, em um projeto existenteSiga /hyperframes-studio § 0.
Um novo filme solicitado dentro de um projeto existenteSiga /hyperframes-studio § 5.
Edição específica em um projeto existenteFaça a edição. Não execute a camada de intenção. Para saber o que está na linha do tempo de um projeto (faixas, clipes, inícios, fins, o que é reproduzido), execute npx hyperframes timeline [--json] em vez de ler index.html e todos os arquivos de sub-composição.
BRIEF.md existeLeia workflow e flow. Execute esse fluxo de trabalho; flow: companion sempre executa em /general-video. Não faça perguntas de resumo.
Sem resumo, mas hyperframes.json ou STORYBOARD.md existeRetome a partir dos arquivos do projeto e preferências registradas. Infira o fluxo de trabalho proprietário dos artefatos existentes. Se não puder ser determinado exclusivamente, faça uma única pergunta apenas de roteamento; não execute a entrevista de intenção.
Criação novaExecute a camada de intenção — references/intent-interview.md — depois roteie uma vez usando a tabela da § 2.

Ao editar um projeto existente, delimite suas edições com o histórico do projeto (/hyperframes-cli, Histórico do projeto em sua vez).

Se uma solicitação nova não identificar o assunto ou a entrada, pergunte sobre o que é o vídeo antes de rotear. Verifique preferências e receitas antes de perguntar qualquer coisa (references/intent-interview.md, passo 1). Uma entrada figma.com ou uma receita nomeada altera a captação, não o roteamento — a seção "Adaptar entradas ortogonais" da entrevista lida com ambos.

Manter o CLI do projeto atualizado

Um projeto scaffolded fixa hyperframes@<version> em seus scripts package.json para que as renderizações permaneçam reproduzíveis; a fixação nunca avança por conta própria, e uma execução fixada de um CLI mais antigo não emite nenhum aviso sobre isso. Ao retomar um projeto cujos scripts carregam uma fixação, probe uma vez antes do primeiro comando que afeta a renderização:

npx hyperframes@latest upgrade --project . --check

A probe é somente leitura e relata a fixação em relação ao lançamento mais recente; mantenha o . explícito — em versões mais antigas do CLI, um --project desacompanhado seguido por outra flag consome essa flag como seu valor de diretório. Quando ele relatar que o projeto está desatualizado — ou qualquer saída do CLI já mostrar isso (o aviso stderr This project pins hyperframes@… (latest …), ou _meta.updateAvailable: true em um resultado --json de um script fixado) — aplique com npx hyperframes@latest upgrade --project ., depois verifique com npx hyperframes check. Uma verificação aprovada confirma que as composições do projeto ainda validam na nova versão — não que a saída renderizada seja idêntica quadro a quadro à fixação antiga — portanto, um aumento bem-sucedido nunca é silencioso: nomeie a versão antiga e a nova no resumo da execução. Um projeto sem composição ainda não precisa de verificação. Se a verificação falhar, reverta a alteração no package.json, continue na versão fixada e relate em qual versão o projeto permanece e por quê. Aja com base no sinal em vez de repassá-lo ao usuário; nunca deixe uma fixação aumentada não verificada.

2. Roteie criação nova

Use a primeira linha correspondente. Corresponda à entrega solicitada, não a uma palavra ou tipo de arquivo mencionado de passagem.

PrioridadeSolicitaçãoFluxo de trabalho
1Portar explicitamente uma fonte Remotion existente/remotion-to-hyperframes
2Criar uma apresentação, pitch deck ou deck interativo navegável/slideshow
3Adicionar legendas ou subtítulos simples a filmagens existentes de cabeça falante sem alterá-las/embedded-captions
4Adicionar sobreposições gráficas projetadas a filmagens existentes de cabeça falante, entrevista ou podcast sem alterar a filmagem/talking-head-recut
5Construir um vídeo sincronizado com batida a partir de uma faixa de música, sem narração ou captura de site/music-to-video
6Criar uma unidade explicitamente curta, sem narração, focada em movimento, tipicamente com menos de 10s/motion-graphics
7Explicar uma pull request do GitHub ou alteração de código a partir de uma referência de PR/pr-to-video
8Mercado ou showcase de um site, página de produto, aplicativo ou empresa a partir de uma URL ou resumo específico do site/product-launch-video
9Explicar um tópico, artigo ou anotações com visuais inventados e sem captura de produto ou site/faceless-explainer
10Qualquer outro vídeo ou composição personalizada/general-video

Antes de finalizar a rota, leia references/routes/<workflow>.md — um arquivo pequeno por rota: o contrato canônico de entrada/saída/acionador (disponível antes que os skills de fluxo de trabalho instalados lazy estejam presentes) mais a entrada de entrevista dessa rota. Se o candidato não satisfizer seu contrato, continue roteando em vez de forçar a correspondência. Leia apenas o arquivo da rota correspondida.

Resolver ambiguidades comuns

  • Um título animado curto, sting de logotipo, acerto de estatística, acerto de gráfico, acerto de mapa ou terço inferior independente é /motion-graphics quando não tem narração e o movimento é a mensagem. Um cartão de título estático, sequência narrada, montagem mais longa ou loop personalizado é /general-video.
  • Um gráfico em movimento explicitamente curto pode usar URL, tweet, artigo ou captura de tela como material de origem. Uma solicitação genérica "faça um vídeo a partir deste site" é /product-launch-video.
  • Filmagens existentes com legendas roteiam para /embedded-captions; filmagens com cartões de informação projetados roteiam para /talking-head-recut. Reajuste de tempo, reordenação, recolorização, reenquadramento ou remixagem de filmagens é uma edição personalizada e cai em /general-video.
  • Um arquivo de música seleciona /music-to-video apenas quando sua grade de batida impulsiona a peça. Música usada como fundo não substitui a rota correspondente ao assunto.
  • "Quero um storyboard" altera o processo de revisão, não o fluxo de trabalho. Sem outro sinal de roteamento, use /general-video. Um storyboard.html esboçado confirmado pode ser a própria entrega solicitada; o loop de revisão define esse ponto de parada.
  • Os fluxos de trabalho narrativos especializados suportam até cerca de 3 minutos e são mais fortes em torno de 30–90s. Roteie uma peça claramente mais longa para /general-video. A duração nunca substitui uma entrega explícita de porte, deck, legenda, sobreposição ou orientada por música.

3. Roteie uma vez, depois saia

Para criação nova, a camada de intenção (references/intent-interview.md) executa a conversa completa — memória, triagem, rodada de pitch, indispensáveis, formato da execução, passagem — e termina escrevendo BRIEF.md. O resumo é o único artefato de roteamento que o fluxo de trabalho lê; nada depois reabre este skill ou a entrevista. Responda a cada pergunta posterior "o que a rota exigiu?" a partir de BRIEF.md.

4. Instalar e entrar no fluxo de trabalho

Antes de ler o fluxo de trabalho selecionado, instale ou atualize-o e os skills de domínio principal:

npx hyperframes skills update <nome-do-fluxo-de-trabalho>

Use o nome simples sem /. Se o comando falhar, exiba o erro; não reconstrua o fluxo de trabalho da memória. Todo o resto sobre instalação — a divisão core-vs-lazy, o que init atualiza, diagnóstico, opt-out de CI e o fallback sem CLI — está em references/skill-lifecycle.md.

5. Carregar skills de domínio sob demanda

NecessidadeSkill
Estrutura de composição, atributos de temporização, faixas, variáveis, determinismo/hyperframes-core
Regras de movimento, blueprints de cena, transições, adaptadores de tempo de execução/hyperframes-animation
GSAP seguro para busca, CSS, Anime.js, WAAPI, FLIP, caminhos, máscaras, SVG, quadros-chave 3D ou diagnósticos hyperframes keyframes/hyperframes-keyframes
Especificações de design, conceito, paleta, tipografia, narração, planejamento de batida/hyperframes-creative
Imagens, ícones, logotipos, áudio, legendas, grades, LUTs, mídia reutilizável/media-use
Corte de narração, cadeias de efeitos de áudio, envelopes de automação ou uma cadeia/fader em várias faixas (barramento de submix)/hyperframes-audio
Init, lint, check, snapshots, compare, renderização em lote, Studio, render, publish ou diagnósticos/hyperframes-cli
Blocos e componentes do Registro/hyperframes-registry
Um visual, efeito, tratamento ou transição nomeado — scanlines CRT, glitch, grão de filme, varredura de brilho, explosão de confete — ANTES de construí-lo manualmente/hyperframes-registry
Ativos do Figma, tokens, componentes ou quadros de storyboard como movimento reconstruído/figma

Frases de edição do criador são solicitações entre domínios. Carregue todos os skills nomeados na linha correspondente:

| Solicitação do criador | Domínios necessários

... [truncado para tradução]

Individual skills in this repo

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

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

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.

sandeshrajbhandari/hyperframes-instruct

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). 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`.

sandeshrajbhandari/hyperframes-instruct

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, timeline, history, clean, 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.

sandeshrajbhandari/hyperframes-instruct

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. Read before writing composition HTML.

sandeshrajbhandari/hyperframes-instruct

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

sandeshrajbhandari/hyperframes-instruct

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, 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.

sandeshrajbhandari/hyperframes-instruct

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also 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).

sandeshrajbhandari/hyperframes-instruct

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

sandeshrajbhandari/hyperframes-instruct

Agent Media OS, the single skill for every media need in a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal.

sandeshrajbhandari/hyperframes-instruct

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.

Habilidades Relacionadas