Communitygithub.com

Aseel1600/Edit01

Use quando o usuário deseja um motion graphic curto e baseado em design, onde o movimento é a mensagem: tipografia cinética, contagem de estatísticas ou números, gráfico/visualização de dados, selo de logotipo, lockup de marca, barras de título, sobreposições sociais, destaque animado de manchete/tweet/notícia, pôster em movimento ou destaque rápido de página capturada. Geralmente com duração inferior a 10 segundos e até ~30 segundos, sem narrativa, narração ou assunto ao vivo. Pode renderizar para MP4 ou sobreposição transparente. Não é adequado para peças mais longas, com múltiplas cenas, narradas ou de reel de marca (use general-video), vídeos de site narrados (website-to-video), explicadores de tópicos (faceless-explainer), promoções de produto (product-launch-video), vídeos de RP (pr-to-video) ou legendas em filmagens existentes (embedded-captions). Quando não tiver certeza se é uma peça rápida baseada em movimento ou um tratamento mais longo/narrado, veja /hyperframes.

O que é Edit01?

Este skill permite criar motion graphics curtos e sofisticados, focados em design, onde o movimento é o centro da mensagem. É ideal para animações como tipografia cinética, contagens de estatísticas, gráficos, selos de logotipo, barras de título e destaques de mídia social. O skill segue uma abordagem 'asset-first' (primeiro os ativos), ou seja, a fonte e os ativos são decididos antes do design do quadro, garantindo que a animação seja construída em torno do material real disponível. Ele suporta categorias que não exigem busca (como tipografia cinética ou estatísticas) e categorias orientadas por busca (como animações de páginas web, notícias ou tweets). O fluxo de trabalho inclui inicialização do projeto, planejamento inteligente, design baseado em ativos, construção reutilizando blocos de catálogo, renderização para MP4 ou sobreposição transparente e verificação. O sistema é modular, com categorias definidas em módulos separados, e oferece suporte para retomada do processo em qualquer etapa.

Funciona com~Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/Aseel1600/Edit01/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 — entrada de despacho

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

Um motion graphic curto baseado em design. Asset-first: decida a estratégia de ativos e busque material real antes de projetar o quadro, depois projete o quadro em torno do que você tem e, em seguida, componha reutilizando capacidades de 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 primárioFluxo detalhado
initBashhyperframes.jsonEtapa 0
planejarsubagente — decidir busca? + classificar + estratégia de ativosshot-plan.json (rascunho: categoria, consultas asset_needs, brief)agents/director.md (Parte 1)
buscar ◇Bash — resolver uso de mídia (pular se asset_needs estiver vazio)assets/ + assets/index.mdphases/source/guide.md
projetarsubagente — projetar quadro em torno dos ativos resolvidosshot-plan.json (final: bloco(s) + layout + movimento + posições)agents/director.md (Parte 2)
construirsubagente — composição reuso-primeirocompositions/index.htmlagents/builder.md
renderizarBash — hyperframes render (MP4, ou --format webm/mov para sobreposição)renders/video.mp4Etapa 5
verificarBash — lint / inspect -> subagente de reparo em caso de falha(correções no local)agents/finalize.md

◇ buscar é 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 de planejar é: isso precisa de uma busca? Essa bifurcação divide as categorias em dois grupos; então a categoria específica é escolhida — para 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 foco em movimentoblocos caption-* + regras de animação
statnúmero herói único / contagem + anelapple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills}
chartsbarra / linha / pizza / corrida / % a partir de dadosbloco data-chart
logo-revealselo de logotipo / lockup de marca (logotipo 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 — buscar primeiro, depois animar por tipo de conteúdo (o caminho RWA):

Conteúdo retornadoCategoriaAnimação
página da web / linkwebpageanimação de página / interface do usuário (rolagem, revelação, 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 torna-se o 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; 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 macOS: export PRODUCER_BROWSER_GPU_MODE=hardware.

Chaves opcionais (fallbacks locais se não definidas) — necessárias apenas por categorias que buscam/geram ativos via media-use:

ChaveUsada 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

Etapa 0 — Inicializar

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

Somente 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

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

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

Etapa 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ícia / 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 na Etapa 2 e finalizada na Etapa 3.
  2. Escreva um rascunho de shot-plan.json (envelope + categoria de formulário escolhida ou intenção de busca + asset_needs + um brief de uma parágrafo). Schema: references/shot-plan-ir.md.

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

Etapa 2 — Buscar ◇ (Bash: media-use, condicional)

Se shot-plan.json.asset_needs não estiver vazio, resolva os ativos (busca / geração / busca → 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.

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

Degradação graciosa: se uma busca/fornecedor estiver indisponível, a categoria cai 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 o quadro em torno dos ativos disponíveis: escolha o(s) bloco(s) de catálogo + as regras/blueprints hyperframes-animation, o layout, o movimento, os beats e (para asset-fusion) os element_positions + a paleta de conta-gotas. Finaliza shot-plan.json (content.block + content.customize + conteúdo por categoria).

Etapa 4 — Construir (subagente: Construtor, reuso-primeiro)

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). Reuso-primeiro: npx hyperframes add <block> + customize no local; escreva manualmente apenas as lacunas + a funcionalidade de fusão de ativos. Saída compositions/index.html honrando o contrato HF (timeline GSAP pausada em window.__timelines, class="clip" + ids estáveis, tl.seek(0), determinístico).

Etapa 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)

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

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

exit 0 → concluído. Em caso de erros de lint/inspect, despache o subagente de reparo (agents/finalize.md: snapshot QA + uma passada de correção no local + re-renderizar). 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)   # Interface do Studio; ou `npx hyperframes play` para um link compartilhável

As flags estão na skill 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 (buscar)
shot-plan.json final, sem compositions/index.htmlEtapa 3/4 (projetar+construir)
compositions/index.html existe, sem renders/video.mp4Etapa 5 (renderizar) + Etapa 6
renders/video.mp4 existeRelatar + parar

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

  • Racional asset-first: a busca é carregada no início e informa o design do quadro (o fluxo RWA: analisar → buscar → revisar → compor). As categorias orientadas por busca (webpage/news/tweet) e asset-fusion dependem da busca de mídia (notícias/web/tweet/imagem), que é a linhagem RWA documentada do media-use.
  • Reuso-primeiro: o análogo no ecossistema de modelos gerados por LLM é "compor blocos de 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 classificação em agents/director.md + sua linha em catalog-map.md; o pipeline de fases não é tocado.
  • Forma do diretório:
    videos/<project-name>/
      hyperframes.json  context.log
      shot-plan.json            # o IR (saída do Diretor)
      assets/  assets/index.md  # saída do media-use (se buscado)
      compositions/index.html   # saída do Construtor
      renders/video.mp4
    
  • Registro: no roteador hyperframes — adicione a intenção "motion graphic curto baseado em design" + descrição do Workflow; retire os gatilhos de motion-graphics de /general-video; adicione arestas reversas de NÃO-USE. Consulte motion-graphics-genre.md §5-7.

Individual skills in this repo

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

Aseel1600/Edit01

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, Gemini Omni). Supports gateways: HeyGen API, fal.ai API, Kling official direct API, and the Gemini API (Gemini Omni Flash).

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

Generate expressive, multilingual narration with fish.audio (S1 / S2-generation models) and reuse cloned voices via reference_id. Use when the user prefers fish.audio/Fish Audio TTS, wants a specific playground voice model, or needs high-emotion voice-clone narration.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Aseel1600/Edit01

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.

Aseel1600/Edit01

Best practices for Remotion - Video creation in React

Aseel1600/Edit01

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.

Aseel1600/Edit01

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.

Aseel1600/Edit01

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

Habilidades Relacionadas