Communitygithub.com

Army161/OpenMontage

Crie animações gráficas curtas, com foco em design e sem narração: tipografia cinética, contagem de números, visualização de dados, logotipos, barras de título, sobreposições para redes sociais, destaques de páginas e muito mais. Renderiza em MP4 ou sobreposição transparente. Não é adequado para peças com narração, multi-cena ou com atores reais.

O que é OpenMontage?

Este skill é especializado na criação de motion graphics curtos e impactantes, onde o movimento é a mensagem principal. Ele é ideal para peças como tipografia cinética, animações de números/estatísticas, destaques de dados, stings de logo, barras de título, sobreposições para redes sociais e animações de tweets/notícias, geralmente com duração inferior a 10 segundos. O skill não se destina a vídeos com narração, cenas múltiplas, ou que envolvam atores reais. Ele opera por meio de um pipeline estruturado em fases: inicialização, planejamento (com decisão sobre necessidade de busca de ativos), captura de ativos (se necessário), design do plano de cena, construção da composição (reutilizando blocos de catálogo), renderização (para MP4 ou formato transparente) e verificação. O fluxo é orientado por ativos, priorizando a obtenção de material real antes de projetar a cena. As categorias de animação incluem desde formulários puros (como 'kinetic-type' e 'stat') até categorias orientadas por busca (como 'webpage' e 'news'), que utilizam mecanismos de pesquisa para obter conteúdo dinâmico. O skill é suportado em macOS (Apple Silicon) e Linux x64, dependendo de ferramentas como Node.js, FFmpeg e o sistema Hyperframes. É uma ferramenta poderosa para criadores que precisam de animações rápidas e visualmente sofisticadas, sem a complexidade de edição de vídeo tradicional.

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

motion-graphics — ponto de entrada de despacho

Confirme a rota antes do Passo 0. Este skill cria um ** motion graphic curto, focado em design e sem narração** (o movimento é a mensagem; ~até 10s, sem locução). Um tratamento mais longo, multi-cena ou narrado → /general-video; um vídeo narrado de um site → /website-to-video; um explicador de tópico → /faceless-explainer; um produto promocional → /product-launch-video; legendas em filmagens existentes → /embedded-captions. Fora do escopo: dados ao vivo / no momento da renderização, ou filmagens que não podem ser capturadas. Não tem certeza entre motion-first vs narrado? Leia /hyperframes primeiro.

Um motion graphic curto e focado em design. Primeiro os ativos: 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/<nome-do-projeto>/ (criado no Passo 0); todos os caminhos abaixo são relativos a ele.

FaseExecuçãoArtefato primárioFluxo detalhado
initBashhyperframes.jsonPasso 0
plansubagente — decidir busca? + classificar + estratégia de ativosshot-plan.json (rascunho: categoria, consultas asset_needs, briefing)agents/director.md (Parte 1)
source ◇Bash — resolução de mídia (pule 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
renderBash — hyperframes render (MP4, ou --format webm/mov para overlay)renders/video.mp4Passo 5
verifyBash — lint / inspect -> subagente de reparo em caso de falha(correções no local)agents/finalize.md

◇ source é executado apenas quando a categoria escolhida declara ativos. Categorias puramente de código/texto (ex.: kinetic-type, a maioria dos 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 formulário — sem busca; o usuário fornece o conteúdo:

CategoriaIntençãoBaseia-se em
kinetic-typelinha / citação / título impactante, texto com movimentoblocos 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-revealsting de logo / lockup de marca (logo do usuário)logo-outro / rules/svg-path-draw
lower-thirdsbarras de nome / título, chamadas, sobreposições sociaiscaption-* + blocos de sobreposição do registro

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 / UI (scroll, revelar, cursor, chamadas)
artigo de notícianewsrevelação de manchete + cartão de fonte + chamadas de fatos-chave
tweettweetcartão de tweet animado
imagem / entidadeasset-fusiona geometria do ativo se torna o gráfico (fusão diegética RWA)

Ordem de construção: um de cada vez, priorizando cobertura (rústico é aceitável). kinetic-type portado do protótipo; os demais seguem.

Pré-requisitos

macOS Apple Silicon ou Linux x64. Ferramentas do sistema: brew install node ffmpeg. npx hyperframes doctor uma vez. Renderização GPU no 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 media-use:

ChaveUsado paraFallback
GEMINI_API_KEY / GOOGLE_API_KEYgeração de imagem (resolução media-use)pular geração / apenas busca
(fornecedores de busca asset_scout)busca de ativos reais para webpage/news/tweet + asset-fusioncategoria degrada para sem ativos

Fluxo

Passo 0 — Inicializar

cwd é a raiz do workspace do agente; escreva todos os artefatos em PROJECT_DIR = videos/<nome-do-projeto>/. <nome-do-projeto>: 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/<nome-do-projeto>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank

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 (master + subagentes) é um subshell (cd "$PROJECT_DIR" && ...) — nunca um cd simples.

Passo 1 — Planejar (subagente: Diretor Parte 1)

Despache um subagente. prompt = completo agents/director.md + ## 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 formulário (kinetic-type / stat / charts / logo-reveal / lower-thirds); o conteúdo é fornecido pelo usuário; asset_needs: [].
    • Sim → emita um plano de busca em asset_needs[] (notícias / web / tweet / imagem; consultas de dois polos). A categoria orientada por busca específica (webpage / news / tweet / asset-fusion) é confirmada pelo tipo de conteúdo retornado no Passo 2 e finalizada no Passo 3.
  2. Escreva um rascunho de shot-plan.json (envelope + categoria de formulário escolhida ou intenção de busca + asset_needs + um briefing de cena de um parágrafo). Schema: references/shot-plan-ir.md.

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

Passo 2 — Fonte ◇ (Bash: media-use, condicional)

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

# ilustrativo — veja phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)

Degrade graciosamente: se uma busca/fornecedor estiver indisponível, a categoria cai para sem ativos (anote em context.log).

Passo 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 o Passo 2 foi executado + catalog-map.md). Ele projeta a cena em torno dos ativos disponíveis: escolha o(s) bloco(s) do catálogo + as regras/blueprints hyperframes-animation, o layout, o movimento, as batidas e (para asset-fusion) as element_positions + a paleta de conta-gotas. Finaliza shot-plan.json (content.block + content.customize + conteúdo por categoria).

Passo 4 — Construir (subagente: Construtor, priorizando reuso)

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

Passo 5 — Renderizar (Bash)

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

Passo 6 — Verificar (Bash → subagente de reparo em caso de falha)

(cd "$PROJECT_DIR" && npx hyperframes lint . && npx hyperframes inspect .)

exit 0 → concluído. Em erros de lint/inspect, despache o subagente de reparo (agents/finalize.md: snapshot QA + uma passagem de correção no local + re-renderização). Nunca altere uma duração fixa no reparo.

Relatório + pré-visualização opcional

Relate a saída final (renders/video.mp4, ou a variante de sobreposição .webm / .mov) + duração. Não abra uma pré-visualização durante a execução. Ofereça uma apenas mediante solicitação, iniciada após a renderização para que sirva o arquivo final:

(cd "$PROJECT_DIR" && npx hyperframes preview)   # Studio UI; ou `npx hyperframes play` para um link compartilhável

Flags estão no skill hyperframes-cli (references/preview-render.md).

Tabela de retomada

EstadoContinuar a partir de
sem shot-plan.jsonPasso 1 (planejar)
shot-plan.json tem asset_needs, sem assets/Passo 2 (fonte)
shot-plan.json final, sem compositions/index.htmlPasso 3/4 (projetar+construir)
compositions/index.html existe, sem renders/video.mp4Passo 5 (renderizar) + Passo 6
renders/video.mp4 existeRelatar + parar

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

  • Racional de ativos primeiro: a captação é carregada no início e informa o design da cena (o fluxo RWA: analisar → buscar → revisar → compor). As categorias orientadas por busca (webpage/news/tweet) e asset-fusion dependem da busca media-use (notícias/web/tweet/imagem), que é a linhagem RWA documentada do media-use.
  • Reuso primeiro: o análogo intra-ecossistema de templates gerados por LLM é "compor blocos do catálogo + regras hyperframes-animation". A timeline GSAP pausada do HF ≙ useCurrentFrame do Remotion.
  • Contrato do módulo de categoria: um categories/<id>/module.md (planejamento + construção), compartilhando references/motion-vocabulary.md (+ avaliação opcional). Adicionar uma categoria = soltar a pasta + registrar sua linha de classificador em agents/director.md + sua linha em catalog-map.md; o pipeline de fases é intocado.
  • Estrutura de diretório:
    videos/<nome-do-projeto>/
      hyperframes.json  context.log
      shot-plan.json            # o IR (saída do Diretor)
      assets/  assets/index.md  # saída do media-use (se obtido)
      compositions/index.html   # saída do Construtor
      renders/video.mp4
    
  • Registro: no roteador hyperframes — adicione a intenção "motion graphic curto focado em design" + descrição do Fluxo de Trabalho; remova os gatilhos de motion-graphics de /general-video; adicione arestas reversas de NÃO-USAR. Veja motion-graphics-genre.md §5-7.

Individual skills in this repo

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

Army161/OpenMontage

Generate AI videos from text prompts using multiple provider gateways. Use when: (1) Generating videos from text descriptions, (2) Creating AI-generated video clips for content production, (3) Image-to-video generation with a reference image, (4) Choosing between video generation providers (VEO, Kling, Sora, Runway, Seedance, MiniMax). Supports two gateways: HeyGen API and fal.ai API.

Army161/OpenMontage

Create AI avatar videos with precise control over avatars, voices, scripts, scenes, and backgrounds using HeyGen's v2 API. Use when: (1) Choosing a specific avatar and voice for a video, (2) Writing exact scripts for an avatar to speak, (3) Building multi-scene videos with different backgrounds per scene, (4) Creating transparent WebM videos for compositing, (5) Using talking photos as video presenters, (6) Integrating HeyGen avatars with Remotion, (7) Batch video generation with exact specs, (8) Brand-consistent production videos with precise control.

Army161/OpenMontage

Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

Army161/OpenMontage

Review local character animation with schema checks, Playwright browser previews, frame sampling, and FFmpeg/ffprobe final output checks.

Army161/OpenMontage

Create videos from a text prompt using HeyGen's Video Agent. Use when: (1) Creating a video from a description or idea, (2) Generating explainer, demo, or marketing videos from a prompt, (3) Making a video without specifying exact avatars, voices, or scenes, (4) Quick video prototyping or drafts, (5) One-shot prompt-to-video generation, (6) User says "make me a video" or "create a video about X".

Army161/OpenMontage

Generate Mandarin and multilingual narration with Volcengine Doubao Speech 2.0. Use when creating Chinese voiceovers, when the user prefers Doubao/Volcengine/火山引擎/豆包 TTS, or when narration needs character-level timestamp metadata for subtitles.

Army161/OpenMontage

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Army161/OpenMontage

Use when implementing Disney's 12 animation principles with Framer Motion in React applications

Army161/OpenMontage

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). HyperFrames-native: single paused timeline, seek-safe, deterministic.

Army161/OpenMontage

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

Army161/OpenMontage

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.

Army161/OpenMontage

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

Army161/OpenMontage

Audio and media assets for HyperFrames compositions, produced by one shared audio engine (`scripts/audio.mjs`) — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), background music + sound effects (HeyGen audio-library retrieval by default, with local Lyria / MusicGen BGM generation and a bundled SFX library as the no-credential fallback), Whisper transcription, background removal, and caption authoring. Use for voiceover / TTS, BGM, SFX / sound effects, transcription, captions / subtitles / lyrics / karaoke / per-word styling, voice + provider selection, and music-mood prompting.

Army161/OpenMontage

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

Army161/OpenMontage

Use when the user has a music track (an audio file, or a video to pull audio from) and wants a beat-synced HyperFrames video, calm to hard-hitting. The music drives everything: one analyzer reads it once, the orchestrator lays out the frames and fills a per-frame plan, and one sub-agent builds each frame. Typography and templates are the floor — a complete video needs zero assets — but any images or videos the user supplies are cut into the frames on the same beat grid (beat-cut / ken-burns). The genre (lyric video, slideshow, kinetic promo) falls out of the per-frame choices; the pipeline never branches on it.

Army161/OpenMontage

Best practices for Remotion - Video creation in React

Army161/OpenMontage

Toolkit-specific Remotion patterns — custom transitions, shared components, and project conventions. For core Remotion framework knowledge (hooks, animations, rendering, etc.), see the `remotion-official` skill.

Army161/OpenMontage

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

Army161/OpenMontage

Animate SVG character rigs with GSAP, CSS transforms, Remotion frame control, and HyperFrames-compatible browser previews.

Army161/OpenMontage

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Habilidades Relacionadas