Communitygithub.com

motion-craft

Constrói vídeos de animação explicativa & Shorts cinematográficos baseados em código (9:16 Shorts & 16:9 Vídeo, duração de 15 segundos a 10 minutos) em 16 categorias visuais de nível profissional: 3D, Isométrico, Explosão de Casa, Stickman 3D, Astronomia (GLSL Black Hole), Mundo Animal, Oceano 3D, Ciência & Natureza, História, Mapas (Natural Earth d3-geo), Islâmico, Geografia, Anatomia, Folclore, Desenho Animado e Animação 2D. Gera recomendações visuais, roteiro em etapas (Gancho -> Cena 1..N), arquivo HTML autônomo que roda diretamente no navegador, pacote ZIP do código-fonte e renderização de vídeo MP4 determinística. Use esta habilidade sempre que o usuário solicitar um vídeo animado, Short educativo, vídeo explicativo, simulação 3D, mapa histórico/geográfico, stickman 3D, anatomia ou storyboard de vídeo.

O que é motion-craft?

MotionCraft é uma habilidade de agente autônoma (sem dependência de aplicativos externos) que transforma uma única frase de ideia em um pacote completo de produção de vídeo animado. Ele gera recomendações visuais detalhadas, um roteiro estruturado em etapas (Gancho -> Cena 1 -> Cena 2...), um arquivo HTML 100% autônomo que roda imediatamente no navegador, um pacote ZIP do código-fonte e opcionalmente um vídeo MP4 determinístico. A habilidade suporta 16 categorias visuais, incluindo 3D, Isométrico, Astronomia (com shaders GLSL), Mapas (Natural Earth d3-geo) e muito mais, garantindo qualidade de estúdio com texturas, iluminação e animações de câmera complexas. O código da cena (`sceneCode`) é determinístico (sem aleatoriedade), responsivo (9:16 e 16:9) e é executado por meio de um construtor Node.js integrado. A saída inclui um arquivo HTML jogável (com switch de proporção e efeitos sonoros WebAudio), um ZIP do código-fonte e um documento de roteiro, tudo sem precisar de `npm install` ou servidores. É ideal para criadores de conteúdo, educadores e desenvolvedores que desejam gerar rapidamente vídeos explicativos ou Shorts com qualidade profissional, diretamente de uma descrição textual.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alpianreza/motion-craft/tree/main

Perguntar na sua IA favorita

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

Documentação

MotionCraft — Habilidade Universal de Agente para Vídeos Explicativos & Shorts em 16 Categorias

Habilidade autônoma (zero dependência de aplicativo) que converte 1 frase de ideia em recomendação de direção visual, roteiro em etapas (HOOK → CENA 1 → CENA 2 → etc. até 10 minutos), arquivo autônomo <slug>.html (duplo clique abre direto no navegador, completo com botão para alternar proporção 9:16 ↔ 16:9 e WebAudio SFX), pacote de código-fonte <slug>-source.zip e renderização de vídeo .mp4.


Fluxo de Trabalho Obrigatório (5 Passos)

Passo 1 — Recomendação Visual & Plano de Roteiro (HOOK → CENA 1..N)

Quando o usuário fornecer uma ideia (se a proporção ou duração não forem mencionadas, use padrão 9:16 Shorts 30–45s para fatos rápidos, ou 16:9 Vídeo 60–600s para tópicos aprofundados):

  1. Selecione 1 Categoria mais adequada das 16 Categorias Oficiais: 3D · Isométrico · Explosão de Casa · Stickman 3D · Astronomia · Mundo Animal · Oceano · Ciência & Natureza · História · Mapas · Islâmico · Geografia · Anatomia · Folclore · Desenho Animado · Animação 2D.
  2. Formule uma Recomendação Visual Específica:
    • Objetos & Adereços (objetos): assunto principal texturizado/articulado + pelo menos 3 adereços para comparação de escala/evidência.
    • Câmera & Transições (camera): padrão multi-ângulo (aberto → close-up detalhe → órbita / giroPara / afastamento).
    • Ambiente & Iluminação (ambiente): atmosfera de céu/espaço, névoa/luz volumétrica, paleta de cores e tom da narração.
  3. Elabore o Roteiro em Etapas (0 até DUR segundos sem lacunas vazias):
    • A primeira parte OBRIGATÓRIA é HOOK (3–10 segundos de abertura para despertar curiosidade).
    • Em seguida, CENA 1, CENA 2, etc., e conclua com uma conclusão factual forte (~2,2 palavras/segundo).
    • Para durações longas (> 60s até 600s / 10 minutos), leia Guia de Duração Longa de 10 Minutos.

Passo 2 — Leia a Receita da Categoria & Padrão Ouro de Código de Exemplo (OBRIGATÓRIO!)

NÃO escreva sceneCode a partir de chutes vazios! Antes de escrever o código de animação:

  1. Leia a tabela de categorias e o ID style em Catálogo de 16 Categorias e a lista de funções de tempo de execução em Referência da API do Engine v4 (MF).
  2. Leia os exemplos de código-fonte oficiais mais próximos em Padrão Ouro de Código de Referência.
  3. Lei de Equivalência de Qualidade: A densidade de objetos, detalhes de textura (CanvasTexture / SVG em camadas / linha costeira world-atlas / shader GLSL), iluminação e suavidade da câmera DEVEM SER EQUIVALENTES aos exemplos em golden-showcases.md. É proibido desenhar caixas/círculos simples sem textura ou adereços!

Passo 3 — Regras de Ouro para Escrever sceneCode

sceneCode é executado como o corpo da função (MF, stage, tl, W, H, DUR):

  • Responsivo Duplo (9:16 Shorts & 16:9 Vídeo): Sempre use proporções de W e H (W * 0.5, H * 0.45, size: W < H ? 50 : 56, labelX: W < H ? W * 0.08 : W * 0.54) para que a animação seja exibida por completo sem cortes em 1080×1920 ou 1920×1080.
  • Não Sobrescreva a Variável H: Nunca escreva const { H } = MF; pois isso sobrescreverá a altura do palco H! Sempre chame usando o prefixo MF. (MF.H, MF.S, MF.T).
  • 100% Determinístico: É proibido usar Math.random(), Date.now(), setTimeout ou setInterval. Use MF.rng('seed-fixo'), tweens em tl e MF.onTick((t) => ...) como função pura do tempo t.
  • Frame 0 Já Deve Estar Vivo: Elementos do palco e título de abertura HOOK devem usar at: 0 para que o primeiro frame não fique vazio/escuro.
  • Anti-PPT: No máximo 1 manchete (MF.highlightHeadline) + 1 chamada/número (MF.leaderCallout / MF.bigStat) por vez. A história deve ser conduzida por mudanças na ação do mundo/objetos e movimento da câmera, e não por uma sequência de cartões de texto!

Passo 4 — Monte o Arquivo Autônomo (.html, -source.zip, -naskah.md)

Crie um arquivo de especificação JSON (ex.: spec.json):

{
  "title": "Título do Vídeo",
  "idea": "Ideia original do usuário",
  "style": "stickman-3d",
  "aspectRatio": "9:16",
  "duration": 30,
  "visualRecommendation": {
    "objetos": "...",
    "camera": "...",
    "ambiente": "..."
  },
  "scenes": [
    { "label": "HOOK", "title": "...", "start": 0, "end": 7, "narration": "...", "visualBeat": "..." },
    { "label": "CENA 1", "title": "...", "start": 7, "end": 18, "narration": "...", "visualBeat": "..." }
  ],
  "sceneCode": "const view = MF.H('div', { className: 'mf-view' }, stage); ..."
}

Em seguida, execute o script de construção autônomo (Node.js nativo puro, 0 dependências npm!):

node "<caminho-para-habilidade>/scripts/build.mjs" --spec caminho/para/spec.json --out-dir caminho/destino

Este script valida a sintaxe e o determinismo do sceneCode, incorpora ./assets/motion-engine.js, ./assets/sfx-synth.mjs e ./assets/land-110m.json (se usar mapas), e gera:

  1. <slug>.html — 1 arquivo autônomo pronto para assistir em qualquer navegador (auto-loop + barra de scrub + botão para alternar 9:16 ↔ 16:9 + WebAudio SFX).
  2. <slug>-source.zip — arquivo completo do código-fonte (index.html, src/scene.js, src/project.json, NASKAH-DAN-STORYBOARD.md, engine/).
  3. <slug>-naskah.md — documento de roteiro e recomendações visuais organizado.

Fallback Sem Shell / Web Chat: Se o ambiente do agente não tiver acesso ao terminal Node.js, copie o conteúdo de ./assets/starter-template.html, substitua os placeholders /*__MOTION_ENGINE__*/, /*__SFX_SYNTH__*/ e /*__PROJECT_JSON__*/ null diretamente para gerar o arquivo index.html completo.

Passo 5 — Verificação de Quadros & Exportação de Vídeo MP4 (Opcional / Se o Navegador Headless Estiver Disponível)

Se o ambiente tiver Chrome/Edge + puppeteer-core (ou puppeteer), execute a verificação automática para garantir 0 erros de tempo de execução e verificar capturas de tela:

# Verificação rápida (verificar 0 erros + salvar screenshot do HOOK e do meio):
node "<caminho-para-habilidade>/scripts/export-mp4.mjs" --html caminho/destino/<slug>.html --verify-only

# Renderização completa para vídeo MP4 (H.264 + AAC SFX automático, opcional + --vo narracao.mp3):
node "<caminho-para-habilidade>/scripts/export-mp4.mjs" --html caminho/destino/<slug>.html --fps 30 --scale 1

Se forem encontrados erros ou textos sobrepostos nas capturas de tela de verificação, corrija o sceneCode, reconstrua com scripts/build.mjs e entregue o resultado ao usuário.

Habilidades Relacionadas