Communitygithub.com

sandeshrajbhandari/hyperframes-instruct

Um motion graphic curto e orientado pelo design, onde o movimento é a mensagem: tipografia cinética, contagem de estatísticas, animação de gráficos/dados, logotipo/brand lockup, lower-third/callout/sobreposição social, mapa animado (destacar regiões, conectar lugares, zoom em um local), tweet/artigo de notícias/manchete animado, animação de página web/UI (scroll, cursor, callouts), ou fusão da geometria de uma imagem real em um gráfico. Normalmente com menos de 10s (até ~30s), sem narração ou ação ao vivo; renderizado para MP4 ou overlay transparente. Mais longo/narrado/múltiplas cenas → /general-video. Dúvida → /hyperframes.

O que é hyperframes-instruct?

Esta skill, 'sandeshrajbhandari/hyperframes-instruct', é uma ferramenta especializada para gerar motion graphics curtos e impactantes, com foco em design e sem narração. Ela é ideal para criar animações como tipografia cinética, animações de dados (gráficos, contagens), reveals de logotipos, overlays para redes sociais, mapas animados e animações de interfaces web. A skill é parte do ecossistema HyperFrames e opera de forma autônoma, seguindo um fluxo de trabalho estruturado: planejamento, busca de ativos, design, construção, verificação e renderização. Ela prioriza o uso de ativos reais antes de projetar a cena e promove a reutilização de blocos de catálogo. O resultado final é um vídeo MP4 (ou overlay transparente) de alta qualidade.

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

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 execução de plugins quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.

Primeiro, mantenha esta skill atualizada — confirme com o usuário antes de executar: npx hyperframes skills update motion-graphics. Uma operação rápida e sem efeitos quando tudo está atualizado; caso contrário, atualiza esta skill e as skills de domínio principal das quais ela depende antes de você usá-las.

fonte figma: Se o logotipo/ativo/animação a ser criado vier de uma URL figma.com, execute /figma primeiro — exportação de ativos, tokens de marca e tradução Motion→GSAP se o gráfico for uma importação Figma Motion — depois construa a partir de sua saída. Não manipule o Figma diretamente via ferramentas MCP brutas: isso ignora a sanitização de SVG, a proveniência de .media/manifest.jsonl e a vinculação de var() de tokens de marca, portanto uma alteração posterior de marca não pode ser propagada sem uma reimportação completa.

motion-graphics — ponto de entrada

A porta de entrada é /hyperframes. Esta skill cria um motion graphic curto, orientado pelo design e sem narração (o movimento é a mensagem; ~menos de 10s, sem voz sobreposta). Qualquer coisa mais longa, narrada ou com múltiplas cenas — ou qualquer incerteza → leia /hyperframes primeiro: a camada de intenção é responsável por todas as decisões de rota.

Este fluxo de trabalho é autônomo por design — no máximo uma pergunta esclarecedora (agents/director.md), depois construa até a verificação sem revisão intermediária. A camada de intenção (/hyperframes → references/intent-interview.md) roteia diretamente aqui sem perguntas sobre a forma de execução; um storyboard e uma sessão de acompanhamento acrescentam pouco a uma peça tão curta. A renderização ainda é controlada pelo usuário: após as verificações e as provas de snapshot passarem, abra a pré-visualização do Studio e faça a pergunta canônica "renderizar agora, ou quais alterações?" de ../hyperframes/references/brief-contract.md. Quando um BRIEF.md existir, leia-o antes da pergunta do diretor.

Um motion graphic curto e orientado pelo design. Ativos primeiro: decida a estratégia de ativos e obtenha material real antes de projetar a cena, depois projete a cena em torno do que você tem e, em seguida, componha reutilizando as capacidades do catálogo. Todos os artefatos vão para PROJECT_DIR = videos/<project-name>/ (criado na Etapa 0); todos os caminhos abaixo são relativos a ele.

FaseExecuçãoArtefato principalFluxo detalhado
initBashhyperframes.jsonEtapa 0
plansubagente — decidir busca? + classificar + estratégia de ativosshot-plan.json (rascunho: categoria, consultas asset_needs, resumo)agents/director.md (Parte 1)
fonte ◇Bash — resolução de mídia (pular se asset_needs estiver vazio)assets/ + assets/index.mdphases/source/guide.md
designsubagente — design da cena em torno dos ativos resolvidosshot-plan.json (final: bloco(s) + layout + movimento + posições)agents/director.md (Parte 2)
buildsubagente — composição priorizando reusocompositions/index.htmlagents/builder.md
verifyBash — lint, check, provas de snapshot; reparo em caso de falhasnapshots/contact-sheet.jpgEtapa 5
approveAbrir a pré-visualização; perguntar renderizar ou alterações; aguardar respostaaprovação explícita de renderizaçãoEtapa 6
renderBash — hyperframes render (MP4, ou --format webm/mov para overlay)renders/video.mp4 ou overlay transparenteEtapa 6

◇ fonte é executada apenas quando a categoria escolhida declara ativos. Categorias puramente de código/texto (ex.: kinetic-type, a maioria de charts/stat) têm asset_needs: [] e pulam direto do planejamento para o design.

Categorias — divididas pela decisão de busca

A primeira decisão do plan é: isso precisa de uma busca? Essa bifurcação divide as categorias em dois grupos; em seguida, a categoria específica é escolhida — para as orientadas por busca, pelo tipo de conteúdo que a busca retorna. Cada categoria é um categories/<id>/module.md (suas regras de planejamento + construção); o vocabulário de movimento compartilhado está em references/motion-vocabulary.md (→ regras/blueprints hyperframes-animation + blocos de registro).

Categorias de forma — sem busca; o usuário fornece o conteúdo:

CategoriaIntençãoBaseia-se em
kinetic-typefrase/citação/título impactante, texto com movimento em primeiro planoblocos caption-* + regras de animação
statnúmero herói único / contagem regressiva + anelapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsgráfico de barras/linhas/pizza/corrida/% a partir de dadosbloco data-chart
logo-reveallogotipo / brand lockup (logotipo do usuário)logo-outro / rules/svg-path-draw
lower-thirdsbarras de nome/título, callouts, overlays sociaiscaption-* + blocos de overlay do registro
mapsmovimento geográfico — destacar regiões, conectar lugares, zoom em um local (faixa vetorial ou faixa de mapa base rasterizado)família us-map / world-map + bake-basemap.mjs

Categorias orientadas por busca — busque primeiro, depois anime por tipo de conteúdo (caminho RWA):

Conteúdo retornadoCategoriaAnimação
página web / linkwebpageanimação de página web / UI (scroll, revelar, cursor, callouts)
artigo de notíciasnewsrevelação de manchete + cartão de fonte + callouts de fatos-chave
tweettweetcartão de tweet animado
imagem / entidadeasset-fusiona geometria do ativo se transforma no gráfico (fusão diegética RWA)

Ordem de construção: um de cada vez, priorizando cobertura (rascunho é aceitável). kinetic-type portado do protótipo; o restante segue.

Pré-requisitos

macOS Apple Silicon ou Linux x64. Ferramentas do sistema: brew install node ffmpeg. npx hyperframes doctor uma vez. Renderização GPU macOS: export PRODUCER_BROWSER_GPU_MODE=hardware.

Chaves opcionais (fallbacks locais se não definidas) — necessárias apenas para categorias que obtêm/geram ativos via uso de mídia:

ChaveUsada paraFallback
GEMINI_API_KEY / GOOGLE_API_KEYgeração de imagens (resolução de uso de mídia)pular geração / apenas busca
(provedores de busca de ativos)busca de ativos reais para webpage/news/tweet + asset-fusioncategoria degrada para sem ativos

Fluxo

Etapa 0 — Inicializar

cwd é a raiz do workspace do agente; escreva todos os artefatos em PROJECT_DIR = videos/<project-name>/. <project-name>: use o diretório que o usuário forneceu, senão um nome curto em kebab-case a partir da intenção (<assunto>-motion). Não use o nome base do workspace ou um timestamp.

Apenas quando $PROJECT_DIR/hyperframes.json estiver ausente:

PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics

init verifica as skills instaladas em relação às mais recentes no GitHub e atualiza o conjunto global se alguma estiver desatualizada.

Restrições: nunca execute hyperframes init na raiz do workspace; nunca aninhe outro hyperframes/ dentro de PROJECT_DIR; todo comando Bash (mestre + subagentes) é um subshell (cd "$PROJECT_DIR" && ...) — nunca cd simples.

Etapa 1 — Planejar (subagente: Diretor Parte 1)

Despache um subagente. prompt = agents/director.md completo + ## Contexto de despacho (SKILL_DIR / PROJECT_DIR / a solicitação do usuário / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Ele deve:

  1. Decidir: isso precisa de uma busca? (a primeira bifurcação)
    • Não → escolha uma categoria de forma (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps); o conteúdo é fornecido pelo usuário; asset_needs: [].
    • Sim → emita um plano de busca em asset_needs[] (notícias / web / tweet / imagem; consultas bipolares). A categoria orientada por busca específica (webpage / news / tweet / asset-fusion) é confirmada pelo tipo de conteúdo retornado na Etapa 2 e finalizada na Etapa 3.
  2. Escreva um rascunho de shot-plan.json (envelope + categoria de forma escolhida ou intenção de busca + asset_needs + um resumo de cena de um parágrafo). Schema: references/shot-plan-ir.md.

Validação: [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo missing.

Etapa 2 — Fonte ◇ (Bash: uso de mídia, condicional)

Se shot-plan.json.asset_needs não estiver vazio, resolva os ativos (busca / geração / obtenção → caminhos locais congelados do projeto + ledger). Consulte phases/source/guide.md (encapsula media-use resolve; as categorias orientadas por busca usam a busca de notícias/web/tweet/imagem). Se asset_needs estiver vazio, pule para a Etapa 3.

Degrade graciosamente: se uma busca/provedor não estiver disponível, a categoria retorna para sem ativos (anote em context.log).

Etapa 3 — Projetar (subagente: Diretor Parte 2)

Despache um subagente (prompt = agents/director.md Parte 2 + contexto de despacho incluindo o assets/index.md resolvido se a Etapa 2 foi executada + catalog-map.md). Ele projeta a cena em torno dos ativos disponíveis: escolha o(s) bloco(s) do catálogo + as regras/blueprints do hyperframes-animation, o layout, o movimento, os beats e (para asset-fusion) as element_positions + paleta de conta-gotas. Finaliza shot-plan.json (content.block + content.customize + conteúdo por categoria).

Etapa 4 — Construir (subagente: Construtor, priorizar reuso)

Inclua os princípios de movimento compartilhados no contexto de despacho do Construtor. Para charts e stat, inclua também dados em movimento. O Construtor lê esses guias antes de escrever a linha do tempo.

Despache um subagente. prompt = agents/builder.md completo + contexto de despacho (shot-plan.json, catalog-map.md, o module.md da categoria, references/motion-vocabulary.md, references/builder-contract.md). Priorizar reuso: npx hyperframes add <block> + personalize no local; escreva manualmente apenas lacunas + o recurso de fusão de ativos. Saída compositions/index.html respeitando o contrato HF (linha do tempo GSAP pausada em window.__timelines, class="clip" + ids estáveis, tl.seek(0), determinístico).

Etapa 5 — Verificar (Bash → subagente de reparo em caso de falha)

(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <proof-times>)

Escolha tempos de prova que mostrem o estado de abertura, o movimento característico e a pausa final. Inspecione a folha de contato ou snapshot gerada antes de continuar. Em caso de falha de lint, check ou snapshot, despache o subagente de reparo (agents/finalize.md) para uma passagem de correção no local e, em seguida, reexecute a verificação com falha. Nunca altere uma duração fixa apenas para esconder um defeito.

Etapa 6 — Aprovar e renderizar (Bash)

Abra o Studio e, em seguida, faça uma pergunta: "renderizar agora, ou quais alterações?" Após revisões, retorne à mesma verificação:

(cd "$PROJECT_DIR" && npx hyperframes preview --background)

Renderize somente após uma resposta explícita de renderização:

(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# variante de overlay transparente: --format webm  (ou mov)

Verifique se a saída existe, não está vazia e tem a duração pretendida. A entrega final nomeia o artefato, a duração real, a composição ou id do frame, os tempos de prova e a folha de contato ou snapshot inspecionada. Flags estão em /hyperframes-cli → references/preview-render.md.

Tabela de retomada

EstadoContinuar de
sem shot-plan.jsonEtapa 1 (planejar)
shot-plan.json tem asset_needs, sem assets/Etapa 2 (fonte)
shot-plan.json final, sem compositions/index.htmlEtapa 3/4 (projetar+construir)
compositions/index.html existe, snapshots de prova ausentesEtapa 5 (verificar)
verificações e snapshots de prova passam, sem renderização aprovadaEtapa 6 (aprovação)
renderização aprovada existeverificar saída, depois relatar

Notas de design (mantenedores — a execução não lê isso)

  • Racionamento de ativos primeiro

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

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.

Habilidades Relacionadas