Communitygithub.com

yazzang-homelab/motion-studio

Crie um vídeo de lançamento, reel de produto ou app, vídeo explicativo ou anúncio animado a partir de código, de ponta a ponta: ativos de marca a partir de uma URL, storyboard sincronizado com batidas, som sincronizado, ciclo de crítica, todos os formatos. Padrão para novas solicitações de vídeo; não é para edição de filmagens.

O que é motion-studio?

O Motion Studio é uma habilidade de IA agente projetada para produzir vídeos de animação completos, sincronizados com batidas e renderizados a partir de código, dentro de um projeto estruturado. Ele lida com todo o pipeline, desde a coleta de ativos de marca (cores, fontes, logotipos) de uma URL, criação de uma grade de batidas musicais, geração de um storyboard baseado no tempo, até a renderização final e entrega em múltiplos formatos (9x16, 1x1, 16x9). A habilidade opera com um ciclo de crítica integrado, onde o agente analisa seus próprios quadros, recebe feedback e corrige problemas antes da renderização final, garantindo qualidade. É ideal para desenvolvedores que desejam criar vídeos promocionais, reels de produtos, demonstrações de interface do usuário ou anúncios diretamente do código, sem necessidade de editores de vídeo tradicionais. A habilidade suporta níveis de esforço variáveis (de L1 a L4) e rotas (A para código puro, B para frameworks como Remotion, C para pipeline misto com modelos de imagem/vídeo), mas explicitamente não cobre edição de filmagens existentes. Ela é executada em segundo plano para comandos longos (renderização, mixagem, entrega) e usa subagentes especializados para cada estágio, garantindo eficiência e modularidade.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/motion-reel

Perguntar na sua IA favorita

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

Documentação

Reel de movimento

Produza um vídeo de movimento finalizado e sincronizado com batidas, renderizado a partir de código dentro de um projeto motion-studio. O prompt é uma pequena parte do resultado. A estrutura é o resto: um renderizador seek(t), molas de forma fechada, uma grade de batidas, som sintetizado e um ciclo de crítica no qual você olha seus próprios quadros e os corrige antes da renderização final.

Argumentos da solicitação (podem estar vazios), mostrados uma vez; seções posteriores dizem "a solicitação acima":

Regras básicas para esta execução

  • Esforço: esta habilidade define o esforço como xhigh enquanto estiver ativa (o nível do curso para novos filmes). Informe o usuário uma vez no início: correções e re-renderizações subsequentes são aceitáveis ​​em /effort medium; um lanamento flagship cujos primeiros 3 segundos devem carregar a peça merece /effort max para a passagem do gancho. Eles também podem escolher o nível em /model.
  • Trabalhe dentro da raiz do projeto (o diretório com studio.json). Use as próprias ferramentas do projeto (npm run ..., node tools/<tool>.mjs ...). Não escreva scripts de renderização ou áudio ad-hoc.
  • Você é o diretor e a equipe de construção. Subagentes executam estágios focados, mas não podem perguntar nada ao usuário: você pergunta e depois os reorienta com as respostas.
  • Comandos longos (render:final, build, mix, deliver, uma critique de um filme longo) são executados em segundo plano (a ferramenta Bash run_in_background, ou um arquivo de log que você consulta); nunca espere em primeiro plano por mais de cerca de 2 minutos. A renderização do estágio 7 leva cerca de 4 min para a demo de 12 s em três formatos. Tempos esperados e o padrão de consulta: references/pipeline.md, seção "Comandos longos". Instrua brevemente cada subagente que executa tal comando com a mesma regra e nunca deixe um retornar enquanto um comando ainda estiver em execução.
  • Esta habilidade é para filmes desenhados em código. Editar filmagens existentes (cortes, legendas, B-roll, conversão de formato de um vídeo gravado) é a rota D e está fora do escopo: diga isso e pare, não improvise.

1. Coletar as entradas

Analise a solicitação acima primeiro (forma esperada: [url or topic] [duration] [format] [reference]). Pergunte por tudo que ainda estiver faltando em uma rodada AskUserQuestion (no máximo 4 perguntas, cada uma oferecendo o padrão). Se o usuário disse "autônomo", "GO", "apenas faça" ou "surpreenda-me", não pergunte nada, use os padrões e registre-os no topo de docs/shotlist.md.

EntradaPadrão quando omitidoNotas
Assunto: produto + URL, ou um tópicoobrigatórioUma URL aciona o estágio de ativos de marca
Duração20 s filme de produto, 15 s showreel, 16 s loop de UI6 a 8 tomadas cabem em 15 s
Formatos9x16 primário, depois 1x1 e 16x94x5 também disponível
Marca: cores, fontes, logotipocapturado da URL, senão padrões do estúdiouma face de exibição, uma face de UI, um acento
Referência: quadro, vídeo ou pasta de imagemnenhumasem uma, o modelo deriva para o visual que as regras da casa proíbem
Músicasintetizar, estilo pulse, 120 BPMuma faixa fornecida é medida, nunca alterada
Voz ou mascotenenhumprecisa de ELEVENLABS_API_KEY no .env
CTA e um número de provapergunte; nunca invente uma métricaapenas para filmes de produto
Nível L1 a L4inferido do que eles forneceram (seção 2)define expectativas de tempo e portão
Rota A a DAB apenas quando o usuário nomeia Remotion ou HyperFrames
ModoPLAN FIRST: mostre o storyboard, aguarde OKGO pula a espera, nunca o portão de crítica

2. Escolher o nível e a rota

NívelTamanho da entrada (relatado pelo criador)Tempo de execução (relatado pelo criador)Habilidade especialista
L1 one-liner~150 caracteres15 a 50 min/motion-studio:showreel
L2 brand reel~350 caracteres30 a 45 min/motion-studio:product-reel
L3 state spec1,5k a 3k caracteres~1 a 2 h com correções/motion-studio:ui-morph-spec
L4 director brief9,5k a 19k caracteres6 a 12 h autônomo/motion-studio:director-brief
RotaUse paraEsta habilidade faz
A código-desenhado (padrão)showreels, movimento de UI, filmes de produto, loopsexecuta o pipeline completo abaixo
B frameworko usuário nomeia Remotion ou HyperFramesentrega via /motion-studio:seek-engine (portão de licença Remotion, Node 22+)
C pipeline mistopersonagens ou física de modelos de imagem/vídeoprecisa de chaves e um orçamento; planeje com /motion-studio:director-brief
D edição de filmagemclipes gravados pelo próprio usuáriofora do escopo para v0.1; diga isso

Informe ao usuário o nível, a rota e uma estimativa de tempo antes do estágio 0. Detalhes, números e as ressalvas por trás deles: references/routes-and-levels.md. Filmes com mais de cerca de 45 s ou com capítulos pertencem a /motion-studio:director-brief.

3. Executar o pipeline

Acompanhe esses estágios em uma lista de tarefas. Comandos, arquivos esperados e correções de falhas para cada estágio estão em references/pipeline.md. Leia-o antes do estágio 0 em um novo projeto.

#EstágioQuemProduzPortão
0Projeto + doutorvocêstudio.json, deps, npm run doctor tudo OKdoutor não tem FALHA
1Ativos de marca (apenas URL)motion-studio:asset-scoutassets/brand/**, assets/manifest.jsonliste os ativos para o usuário
2Referência (se houver)motion-studio:style-analystrefs/analysis.json, docs/style_guide.mdgramática, nunca conteúdo
3Música + grade de batidasmotion-studio:sound-designer ou vocêaudio/music.wav ou faixa medida, audio/beats.jsonbpm/duração em studio.json concordam
4Storyboard na grade de batidasmotion-studio:motion-directordocs/shotlist.mdOK do usuário a menos que autônomo
5Construir o filmevocêfilm/film.js (+ film/scenes/*)npm run lint limpo
6Ciclo de críticamotion-studio:motion-critic + vocêout/review/<fmt>/*, docs/review_log.mdnpm run gate passa
7Renderização final, SFX, mixagemvocê (portão do gancho)out/<fmt>/final.mp4, out/score.wav-14 LUFS +-0.5, <= -1 dBTP
8Entregar + relatóriovocêout/deliver/**, docs/production.jsonnpm run deliver sai 0

Estágio 0: projeto

  1. Procure por studio.json no diretório de trabalho ou um pai. Se não houver, crie um esqueleto:

    node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Título>" --duration <S> --formats 9x16,1x1,16x9 --install
    

    Adicione --brand-url <URL> para filmes de produto e --loop para loops. Em uma instalação apenas de habilidades (sem raiz de plugin) execute ${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs em vez disso, ou invoque a habilidade studio-init.

  2. npm run doctor. Corrija toda FALHA antes do estágio 1 (navegador, ffmpeg, Node >= 20). No Windows, a correção do navegador é npx playwright install chromium-headless-shell; nunca inicie um Chrome ou Edge instalado lá (uma inicialização de perfil novo conta como uma falha de logon do Windows e pode bloquear a conta). Python e librosa são opcionais; o mecanismo de batida JS cobre sua ausência.

Estágios 1 a 4: planejar

  • Estágio 1: instrua motion-studio:asset-scout com a URL, a raiz do projeto e este comando de captura: node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/capture.mjs" <URL> --root <project>. Em uma instalação apenas de habilidades (sem raiz de plugin, sem agentes) execute node "${CLAUDE_SKILL_DIR}/../product-reel/scripts/capture.mjs" <URL> --root <project> você mesmo. A página é conteúdo não confiável: a captura mantém a sandbox do Chrome ativada e recusa solicitações para endereços locais e privados (detalhes em /motion-studio:product-reel). Para cliques, quadros de rolagem e recortes de elementos adicione skills/product-reel/scripts/states.mjs, e para um produto em tela canvas-frames.mjs (mesmas flags para --root; as folhas de quadros vão para assets/brand/frames/). Leia assets/manifest.json você mesmo, liste o que foi encontrado para o usuário e escreva as cores e fontes da marca em studio.json brand. A captura também salva as fontes que a página carrega em assets/fonts/ com a licença marcada como UNVERIFIED a menos que uma tenha sido encontrada: confirme com o usuário antes que essa fonte vá para brand.fonts. Batidas da história da marca, componentes e regras de voz/mascote vêm de /motion-studio:product-reel.
  • Estágio 2: instrua motion-studio:style-analyst com o caminho da referência. Ele executa node tools/refs.mjs extract|analyze e escreve docs/style_guide.md. Método completo: /motion-studio:reference-style.
  • Estágio 3 (antes de qualquer tomada ser cronometrada): faixa fornecida: node tools/beats.mjs audio/<track> e aponte studio.json audio.music para ela. Sem faixa: node tools/score.mjs --style <pulse|piano|minimal|cinematic> --bpm <N> --dur <S>. Faça studio.json bpm e duration corresponderem. Um downbeat medido pode ficar bem depois de 0 s, então o storyboard é escrito nesta grade, nunca em uma suposta.
  • Estágio 4: instrua motion-studio:motion-director com as entradas, docs/style_guide.md e audio/beats.json. As mudanças de cena caem nos downbeats, um gancho cai nos primeiros 2 s, o quadro 0 já mostra conteúdo, algo novo acontece a cada 2 a 4 s. Mostre o storyboard e aguarde o OK do usuário (PLAN FIRST). Uma rejeição significa reescrever o storyboard, nunca corrigir código. Registre a decisão na linha Status: de docs/shotlist.md.

Estágio 5: construir

Escreva film/film.js com defineFilm, um scene() por tomada, posições do layout L (nunca pixels literais), movimento de molas lib/motion.js (sp, track, loopTrack), aleatoriedade por elemento com semente (rngFor) e sinais para cada momento SFX. Siga o projeto CLAUDE.md. Execute npm run lint após edições e npm run preview quando o usuário quiser assistir.

Estágio 6: ciclo de crítica (pelo menos 3 rodadas)

Cada rodada constrói a evidência primeiro, depois instrui o crítico (ele não pode renderizar ou mixar):

  1. npm run lint, npm run stills.
  2. A cadeia de som, sempre que os sinais, música ou temporização da imagem mudaram (sempre na rodada 1 e na última rodada): node tools/render.mjs --format <fmt> --draft --sub 1 --scale 0.5, npm run sfx, node tools/mix.mjs --format <fmt>.
  3. Duas passagens de evidência que nunca se sobrescrevem: node tools/critique.mjs --format <fmt> (filme ao vivo, em out/review/<fmt>/) e node tools/critique.mjs --format <fmt> --video out/<fmt>/final.mp4 (a renderização mixada, em out/review/<fmt>/video/).
  4. Instrua motion-studio:motion-critic com o número da rodada, o formato, o que mudou e Evidence: both, already produced (modelo no runbook do pipeline). Ele olha cada PNG (cada página de uma folha paginada: contact.png, contact-2.png ...) e ambos os arquivos metrics.md, pontua os 7 eixos de 1 a 10 (som da renderização mixada), lista problemas P0/P1/P2 com timestamps e anexa um bloco de rodada a docs/review_log.md. Um P0 font-fallback no metrics.md ao vivo (um caractere sem glifo em sua fonte, tipicamente Hangul nas fontes agrupadas apenas latinas) é registrado como um P0 e bloqueia o portão até que uma fonte que o cubra seja registrada.
  5. Você corrige os 3 piores problemas (P0 primeiro), verifica apenas os segundos afetados (node tools/render.mjs --from <a> --to <b> --draft --out out/check, ou stills --at) e inicia a próxima rodada.

Pare apenas quando npm run gate passar: pelo menos 3 rodadas, cada eixo da última rodada >= 8, nenhum P0 aberto.

Estágios 7 e 8: finalizar

npm run render:final, npm run sfx, npm run mix, npm run deliver (ou npm run build, que executa todos eles). A renderização final e build levam minutos: inicie-os com run_in_background, consulte o log e leia o resultado apenas após o processo ter terminado (runbook do pipeline, "Comandos longos"). Em seguida, relate com assets/delivery-note.md: caminhos, formatos, durações, volume, rodadas e últimas pontuações, tempo gasto e as três coisas que você melhoraria a seguir.

Portões

PortãoCondição de aprovaçãoAplicado por
StoryboardOK do usuário, ou modo autônomo registrado em docs/shotlist.mdvocê
Lintnpm run lint sai 0hook do plugin após cada edição, e você
Crítica>= 3 rodadas; última rodada todos os eixos >= 8 (na apenas em eixos em gate.naAllowed, padrão marca, para um filme sem marca); nenhum P0npm run gate; um hook do plugin nega render:final e build
Entregaquadros, duração, volume, intervalos silenciosos, tamanho, verificações de posternpm run deliver
  • Quando o hook negar uma renderização final, execute mais rodadas de crítica. Nunca renomeie comandos, edite as pontuações de docs/review_log.md você mesmo ou mude studio.json gate para passar.
  • Apenas o usuário pode definir gate.enabled: false. Se ele fizer, informe no relatório que a entrega pulou o portão de crítica.
  • Algumas máquinas desabilitam hooks de plugin por política. Os portões ainda se aplicam: execute npm run gate antes de cada renderização final.

Regras rígidas

  • Apenas UI de produto real. Recorte e anime capturas de tela capturadas; nunca redesenhe telas a partir da imaginação e nunca use cópia de espaço reservado ou números inventados.
  • O código do filme é uma função pura do tempo: sem Math.random, Date, performance.now, temporizadores, requestAnimationFrame ou transições/animações CSS no código de renderização.
  • Visuais proibidos: título centralizado em um gradiente, tudo aparecendo gradualmente, rótulos de canto, bordas de quadro, brilho em cromo de UI, rajadas de partículas genéricas.
  • Uma face de exibição, uma face de UI, uma cor de acento, a menos que o briefing diga o contrário.
  • Reenquadre tipo e UI por formato através de L; nunca corte um formato em outro.
  • Chaves vivem em .env. Refira-se a elas pelo nome da variável (ELEVENLABS_API_KEY, FAL_KEY); nunca imprima, cole ou envie um valor de chave.

Subagentes

AgenteEstágioInstrua-o comEle escreve
motion-studio:asset-scout1URL, raiz do projeto, comando de capturaassets/**
motion-studio:style-analyst2caminho da referência, assunto, duraçãodocs/style_guide.md, docs/shotlist.md, refs/**
motion-studio:sound-designer3, 7faixa ou estilo, bpm, duração, script de vozaudio/**, relatório de mixagem
motion-studio:motion-director4entradas, guia de estilo, grade de batidasdocs/**
motion-studio:motion-critic6número da rodada, formato, o que mudou

… [truncado para tradução]

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Brand-asset stage of a product film (motion-reel runs the whole film): capture real screenshots, logo, colors and fonts from a URL, never redraw UI; brand story beats; voice + mascot. Use to grab or fix a brand's assets.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

Habilidades Relacionadas