Communitygithub.com

yazzang-homelab/motion-studio

Distribua todos os formatos a partir de uma única linha do tempo, depois empacote: reframing com layout() (nunca corte), renderize todos os formatos, verificações por formato, deliver.mjs, uma skill de marca, uma oferta de serviço. Use para 'exportar 9:16 e 16:9', 'entregar', 'criar uma skill'.

O que é motion-studio?

Esta skill transforma um único projeto de filme em um pipeline de produção repetível e profissional. Ela permite que você crie uma única linha do tempo que renderiza automaticamente em múltiplos formatos (9:16, 1:1, 16:9, 4:5) usando um sistema de layout inteligente que reposiciona o conteúdo para cada proporção, eliminando a necessidade de cortes manuais. Além da renderização, a skill automatiza a mixagem de áudio, verifica a qualidade (quadros, loudness, pico verdadeiro, silêncio, tamanho do arquivo) e empacota os entregáveis. O resultado final é uma skill de marca personalizada que permite ao usuário criar o próximo vídeo com uma única frase, e opcionalmente uma oferta de serviço para clientes. Suporta plataformas como Claude Code e usa ferramentas como Node.js, bash e o ecossistema motion-canvas. O fluxo de trabalho é guiado por uma estrutura de diretórios, um arquivo `studio.json` e templates, garantindo consistência e qualidade profissional.

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

Perguntar na sua IA favorita

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

Documentação

Distribua formatos, uma skill e um serviço (etapa 12 do curso)

Três movimentos transformam um bom clipe em um negócio repetível: exporte todos os formatos a partir de uma única linha do tempo, empacote o pipeline como uma skill para que o próximo vídeo seja uma frase e, se o usuário quiser, venda-o. Trabalhe na raiz do projeto de filme. Argumentos, mostrados uma vez:

Os arquivos desta skill estão em ${CLAUDE_SKILL_DIR} (templates em assets/).

1. Reenquadre por formato, nunca corte

As cenas desenham contra o layout L (ctx.L na fábrica, c.L em um desenho), então uma linha do tempo renderiza 9:16, 1:1, 16:9 (e 4:5) com texto e UI posicionados para cada formato.

FormatoTamanhoRótulo
9x161080x1920Reels, TikTok, Shorts
1x11080x1080X / feed
16x91920x1080YouTube, site
4x51080x1350feed retrato
FerramentaUso
L.uunidade de tamanho: 1 a um lado curto de 1080 px; 120 * L.u lê o mesmo tamanho em todos os formatos
L.So retângulo seguro {x, y, w, h} de studio.json safe[fmt] (margens da UI da plataforma)
L.pos(ax, ay)um ponto dentro do retângulo seguro, ax, ay de 0 a 1
L.pick({ '9x16': a, '1x1': b, '16x9': c, retrato, paisagem, quadrado, default })valores por formato: chave exata, depois orientação, depois padrão
L.split('auto', proporcao, intervalo)duas regiões: empilhadas em retrato e quadrado, lado a lado em paisagem
L.cols(n, intervalo) / L.rows(n, intervalo)colunas ou linhas dentro do retângulo seguro
fitFontSize(g, texto, maxL, (s) => fonte(s, familia, peso), inf, sup, { tracking, step })o maior tamanho que cabe em uma largura (lib/layout.js + lib/draw.js); step: 16 para fontes bitmap
wrapText(g, texto, maxL, fonte(tamanho, familia), { maxLines, ellipsis })linhas para texto multilinha, nunca cortando dentro de uma sílaba Hangul (lib/draw.js)
desenhar(g, lt, c) {
  const { L, marca } = c;
  const { a, b } = L.split('auto', L.pick({ paisagem: 0.45, default: 0.4 }), 32 * L.u);   // título | produto
  const tamanho = Math.min(L.pick({ '9x16': 170, '1x1': 140, '16x9': 150 }) * L.u,
                        fitFontSize(g, 'FAÇA ISSO SE MOVER.', a.l, (s) => fonte(s, marca.fontes.display, 400)));
  cinetico(g, 'FAÇA ISSO SE MOVER.', a.x, a.y + a.a * 0.6, lt, { tamanho, familia: marca.fontes.display, peso: 400, cor: marca.cores.fg, mola: 'default' });
  desenharProduto(g, b, lt, c);                                         // a UI do produto preenche a região b em todos os formatos
}

Regras: sem pixels literais; conteúdo chave dentro de L.S; o mesmo momento acontece ao mesmo tempo em todos os formatos (apenas posição e tamanho mudam); um formato que parece um corte de outro é um P1 na crítica. Ajuste as margens safe em studio.json, não no código. Visualize cada formato com npm run preview (F alterna formatos, G mostra as guias seguras).

2. Revise todos os formatos

O loop de crítica é executado no formato principal; antes da final, execute pelo menos uma rodada por outro formato, cada um com sua própria evidência (cerca de 115 s de tempo de ferramenta por passagem ao vivo e 85 s por passagem --video, medido em um filme de 12 a 20 s):

node tools/stills.mjs --format 1x1
node tools/render.mjs --format 16x9 --draft --sub 1 --scale 0.5     # cerca de 20 s; depois: npm run sfx, node tools/mix.mjs --format 16x9
node tools/critique.mjs --format 16x9                                 # filme ao vivo -> out/review/16x9/
node tools/critique.mjs --format 16x9 --video out/16x9/final.mp4      # renderização mixada -> out/review/16x9/video/

Registre cada uma como sua própria rodada (## Rodada <n> — 16x9 — ...). O portão lê a última rodada, então termine com uma rodada aprovada.

3. Renderize, misture, entregue

Estas levam minutos: a demo de 12 s renderiza em cerca de 4 min para três formatos a 60 fps (cerca de 20 s por segundo de filme), mix leva 40 a 80 s e deliver cerca de 40 s. Inicie npm run build, render:final, mix e deliver com a opção run_in_background da ferramenta Bash e um log, consulte o log (tail -n 3), leia o resultado após a linha exit, e nunca espere em primeiro plano por mais de cerca de 2 minutos; adicione --chunk 10 a uma final de três formatos ou mais de cerca de 30 s. O manual do motion-reel ("Comandos longos") tem o padrão.

EtapaComandoSaída
tudo, em ordemnpm run buildscore (se ausente), sfx, renderização final de todos os formatos, mix, entrega
renderização final (com portão)npm run render:finalout/<fmt>/silent.mp4, poster.png, render.json para todos os formatos em studio.json formats
mix e muxnpm run mixout/score.wav, out/<fmt>/final.mp4, out/final.mp4 (principal), out/poster.png
verificações e pacotenpm run deliverout/deliver/<slug>_<fmt>.mp4 + poster + cada página do contato (<slug>_<fmt>_contact.png, depois _contact-2.png ...), out/deliver/manifest.json, docs/production.json

deliver.mjs verifica, por formato, out/<fmt>/final.mp4 contra o studio.json ATUAL: contagem de quadros (duração x fps), o tamanho do formato, fps e duração exata (um corte renderizado antes de uma edição de duration ou fps falha como stale render; uma renderização de rascunho ou escalada também falha), loudness integrado e pico verdadeiro contra audio.lufs +- audio.lufsTolerance e audio.truePeak; intervalos silenciosos (um intervalo de 1 s ou mais abaixo de -50 dB falha como silence, por exemplo silence 2.2 s at 00:02.1, a menos que comece nos primeiros 0.3 s, comece no último segundo ou esteja dentro de um intervalo critique.allowSilence); tamanho do arquivo contra deliver.maxBytes (padrão x: 536.870.912 bytes = o limite de upload de 512 MB do X; adicione os limites de outras plataformas lá); poster presente; a emenda do loop para filmes em loop; e o portão de crítica. Ele avisa (sem falha) quando as fontes do filme são mais recentes que a renderização. Ele sai com código 1 e nomeia cada verificação com falha; um final.mp4 ilegível também falha. Com --json, uma falha imprime uma linha { ok: false, error, failed: [...] }, também quando a execução não pode ser iniciada (um studio.json inválido, um formato desconhecido, uma flag ruim). --format 1x1 reentrega apenas aquele formato e mantém os arquivos entregues e entradas de manifesto dos outros (carriedOver); um portão com falha retira todos os arquivos entregues. docs/production.json registra título, formatos, durações, loudness, rodadas, últimas pontuações, o nível de esforço (de CLAUDE_EFFORT quando definido) e versões das ferramentas.

Verificação com falhaCorreção
quadros ou duração incorretos, ou stale renderreexecute npm run render:final; nunca entregue uma renderização parcial
loudness ou pico verdadeiro/motion-studio:sound-design (tabela de relatório de mixagem)
silenceuma faixa termina cedo ou um fundo toca sob nada: regenere-a (npm run score, sfx, voice), npm run mix, entregue novamente
tamanho acima do limitenode tools/render.mjs --format <f> --final --crf 18 e depois npm run mix novamente
poster ausentedefina studio.json poster (segundos) ou remova --no-poster
portão/motion-studio:critique-loop

Relate ao usuário: todos os arquivos em out/deliver/, os números por formato do manifesto, as pontuações da última rodada e o que você melhoraria em seguida.

4. Empacote o pipeline como a skill do próprio usuário

Para que o próximo vídeo seja uma frase (/acme-reel vídeo de lançamento para modo escuro, 20 s, vertical):

  1. Escolha o nome: <marca>-reel, letras minúsculas, dígitos e hífens.
  2. Crie .claude/skills/<marca>-reel/SKILL.md no repositório da marca (escopo do projeto, compartilhado via git) ou em ~/.claude/skills/<marca>-reel/SKILL.md (pessoal). Comece a partir de ${CLAUDE_SKILL_DIR}/assets/brand-skill-template.md (assets/brand-skill-template.md).
  3. Preencha a partir deste projeto, não de memória: valores da marca em studio.json, docs/style_guide.md, o docs/shotlist.md aprovado como o padrão de batida da história, e as lições em docs/review_log.md (o que o crítico continuava sinalizando se torna uma regra rígida). Copie o logotipo para .claude/skills/<marca>-reel/assets/.
  4. Mantenha a descrição com menos de cerca de 230 caracteres com frases de gatilho concretas, o corpo com menos de cerca de 200 linhas.
  5. Teste em uma sessão nova com uma solicitação real e verifique se ela pergunta apenas sobre o que muda por vídeo.
  6. Para compartilhar além de um repositório, publique como um plugin (um repositório com .claude-plugin/plugin.json e skills/<nome>/SKILL.md), da mesma forma que buildwithhanif/claude-animation-skill e este plugin são publicados.

5. Transforme em um serviço (opcional)

${CLAUDE_SKILL_DIR}/assets/service-offer.md (assets/service-offer.md) é uma oferta preenchível: o que está incluído (música, um mascote em qualquer estilo, recursos do produto, uma oferta no final, qualquer idioma, até 3 edições), formatos, prazo de entrega, o que o cliente fornece, direitos e divulgação, e precificação. Âncora de preço: Tony Dinh relatou ter pago cerca de US$ 1.000+ por um vídeo de lançamento semelhante um ano antes de fazer um com Opus 5.5 em menos de 30 minutos (https://x.com/tdinh_me/status/2103703135902740699). Ajude o usuário a preenchê-la; não publique ou envie por eles.

Próximo: inicie o próximo filme com /motion-studio:motion-reel, ou a nova skill /<marca>-reel do usuário.

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

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

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

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