Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Crie ou edite uma composição HyperFrames personalizada quando nenhum fluxo de trabalho especializado se encaixar, ou quando BRIEF.md define flow: companion. Use para peças de várias cenas, reels de marca e sizzle, montagens, loops estáticos, cartões de título estáticos, remixes de filmagens e construções livres.

O que é hyperframes-instruct?

Este skill capacita o agente AI a atuar como diretor de composições HyperFrames, funcionando como um fluxo de trabalho geral de vídeo quando nenhuma especialização se aplica, ou como um assistente de cocriação (companion flow) para produções mais longas ou complexas. Ele gerencia todo o ciclo de vida: desde a inicialização do projeto, passando pela interpretação da intenção do usuário, até a execução da composição final. O skill impõe regras rigorosas de busca e aplicação de conhecimento: antes de cada estágio, ele deve carregar referências específicas (como as de core, animação, criatividade, media) em vez de confiar em memória, garantindo consistência e evitando improvisações. Para tratamentos visuais complexos (como 'glitch' ou 'CRT scanlines'), ele obriga uma busca no catálogo online com `npx hyperframes catalog --query` antes de qualquer implementação manual, priorizando blocos e componentes da comunidade. Suporta dois modos de fluxo: 'automation', onde o agente decide e executa a rota de forma autônoma, e 'companion', onde ele age como diretor, oferecendo o tratamento de 'teto' (a melhor versão possível) e refinando com o usuário, sem jamais rebaixar a qualidade.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/sandeshrajbhandari/hyperframes-instruct/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

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

Vídeo geral

Execute npx hyperframes usage --json no início, a menos que o fluxo de trabalho o tenha acabado de ler; então verifique novamente em marcos, como após o rascunho e antes da renderização. Leia as janelas disponíveis e os tempos de reset. Se o uso for desconhecido, informe sem adivinhar a cota; mantenha o escopo e as escolhas do fluxo de trabalho com o usuário.

Antes de confiar neste fluxo de trabalho, execute:

npx hyperframes skills update general-video

Um no-op bem-sucedido significa que o skill está atualizado. 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, logo, voz, correção de cor, 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 filmagem 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 de provedor, execute npx hyperframes auth status e repasse sua saída literalmente. Se desconectado, aplique a proteção em ../hyperframes/references/brief-contract.md: colaborativo aguarda login ou uma escolha explícita offline; autônomo informa o status e continua por meio de um provedor offline disponível. Informe um bloqueio quando nenhum provedor offline puder satisfazer uma capacidade necessária. A adoção local por si só não exige proteção de autenticação.
  • Figma: Se qualquer 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, pois 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 execute novamente 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 a ele. Não faça perguntas sobre o brief.
Sem brief, mas hyperframes.json ou STORYBOARD.md existeRetome de 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 os arquivos 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/references/brief-format.md. Em um projeto existente, a raiz é o diretório que contém hyperframes.json. Registre apenas os campos confirmados 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 instalado do skill /media-use 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/references/brief-contract.md:

CampoSignificadoEfeito
flowQuem dirigeautomation: escolha e execute a rota. companion: cocrie em conversa.
storyboardPlanejar, esboçar e revisar antes de construiryes: execute o plano e a revisão do esboço (storyboard.html). no: construa sem ele.
mode derivadoComo os portões 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.

Para um corte duro, corte, emenda ou reordenação de filmagem existente, duplique a mesma fonte de vídeo em vários elementos de clipe. Em cada cópia, defina o intervalo da fonte com data-media-start mais data-duration, em seguida, defina o posicionamento/ordem autorizado com data-start. Cada segmento de vídeo mantém seu som: o som permanece no clipe (data-has-audio="true"), então cortar o vídeo corta seu som. /hyperframes-core é dono desta edição temporal; use /hyperframes-keyframes apenas para animação de propriedades visuais como zoom, punch, pan, crop, máscara ou clip-path em um wrapper interno. Copie os contratos completos de ../hyperframes-core/references/creator-editing-recipes.md.

Fluxo Companheiro

Quando flow: companion:

  • Leia BRIEF.md e concilie os ## Assets e ## Customizations 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 diretor, não como empreiteiro. Um usuário que escolheu companheiro escolheu envolvimento e qualidade; a resposta honesta é a melhor versão que você pode projetar, não a menor que pode defender. O primeiro plano é o tratamento de teto: o arco narrativo (pegue emprestado 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, cobrança) ao nomeá-las. O usuário reduz um tratamento; nunca deve 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 ofício sobe ao teto; o conteúdo nunca cresce além do que foi pedido (§ 6).
  • Entre checkpoints, ../hyperframes/references/capability-menu.md funciona de duas maneiras. Como lista de gatilhos: ofereça uma capacidade relevante quando o usuário mencionar sua entrada ou a construção atingir sua necessidade. Como canal de atualização de cada passagem: um checkpoint de plano, esboço ou construção pode carregar uma ou duas ofertas rastreadas apontando para o material que o usuário está olhando ("a estatística da cena 3 quer o tratamento de contagem regressiva"). Leia-o antes de oferecer; nunca despeje o catálogo completo.
  • Após o usuário aceitar uma capacidade, produza seu artefato e registre a decisão na seção correspondente do corpo do BRIEF.md imediatamente. Reescreva um campo de frontmatter e registre a preferência confirmada apenas quando o usuário a alterar explicitamente.
  • Mantenha os mesmos portões de storyboard, validação, pré-visualização final e aprovação de renderização. Companheiro muda quem dirige, não o que a qualidade exige.

4. Carregar conhecimento necessário antes de cada etapa

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

CondiçãoLeia antes de agir
Qualquer composição HTML ou layout de cena/hyperframes-core; use references/determinism-rules.md para seu contrato de layout
Qualquer criação ou tratamento visual não trivial/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/references/storyboard-format.md e ../hyperframes/references/review-loop.md
Qualquer ativo ou operação de mídia, incluindo narração, música de fundo, efeitos sonoros, legendas, correção de cor ou transformações/media-use; para reprodução e posicionamento do framework, leia também /hyperframes-core → references/variables-and-media.md
Montagem de várias cenas../hyperframes/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 desses, não lembrado
Uma oferta de capacidade companheira, captura, grade de batida, vídeo generativo, mapa, publicação ou capacidade entre fluxos de trabalho../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 estas leituras por lembrança. 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 driver de duração. Use um arquivo para uma única cena curta; use sub-composições para três ou mais cortes duros de cena 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 várias cenas em aberto, expanda o prompt por meio de /hyperframes-creative → references/prompt-expansion.md. Um plano de várias 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 compõe de rules-index.md quando nenhum se encaixa — os nomes de movimento vêm desses índices, nunca inventados. A verdade da história decide quais cenas existem; a citação as veste. Pesquise o catálogo ativo antes de planejar construir qualquer aparência nomeada você mesmo: para cada aparência, efeito, tratamento ou transição que o brief nomeia — "CRT scanlines", "glitch", "film grain", "shimmer sweep", "confetti burst" — execute npx hyperframes catalog --query "<a aparência, em inglês simples>" --json e leia os principais resultados antes que o plano nomeie como essa aparência será construída. A pesquisa não precisa de nada instalado: nenhum projeto, nenhum add anterior, nenhuma conta. Ela classifica todo o registro hospedado (~400 blocos e componentes) de qualquer diretório, portanto, também se aplica a uma aparência que o usuário solicita no meio da construção. Blocos que o plano nomeia são instalados na etapa 3; crie manualmente uma aparência apenas depois que uma pesquisa por ela vier sem nada que se encaixe. Um plano de várias cenas também é registrado como o artefato de despacho: um bloco ## Frame N por cena em STORYBOARD.md — status: outline, um src: declarado, a citação do blueprint/regras, um

Individual skills in this repo

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

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

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.

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