Communitygithub.com

yazzang-homelab/motion-studio

Inicia um projeto de filme motion-studio (renderizador seek(t), molas, grade de batidas, som sintetizado, ferramentas de crítica), instala, configura o navegador e executa o doctor. Use para 'configurar o motion studio', 'novo projeto de filme', 'iniciar studio'.

O que é motion-studio?

Esta habilidade configura um novo projeto de filme usando o mecanismo motion-studio, que inclui um renderizador baseado em seek(t), simulação de molas, grade de batidas, síntese de som e ferramentas de crítica. Ela automatiza a criação do diretório do projeto, a definição de configurações como título, duração, FPS e BPM, e a instalação de dependências (incluindo Playwright). A habilidade garante que o navegador headless correto seja instalado e configurado, especialmente no Windows para evitar problemas de bloqueio de conta. Após a configuração, ela executa um diagnóstico (doctor) e valida se o projeto renderiza corretamente. É ideal para desenvolvedores e agentes de IA que desejam criar rapidamente um ambiente de animação e renderização de filmes. Suporta plataformas como Claude Code e ambientes com Node.js.

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

Perguntar na sua IA favorita

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

Documentação

Inicialização do Studio (etapa 02 do curso)

Crie um projeto de filme que pode renderizar, ouvir e olhar para seus próprios quadros. O aplicativo de bate-papo pode escrever uma animação; apenas um agente com um shell pode fechar a renderização, olhar, corrigir o loop. Esse loop é a diferença entre uma primeira tentativa "medíocre" e um filme digno de ser postado.

Argumentos da solicitação (podem estar vazios), mostrados uma vez:

1. Escolha o diretório e as configurações

  • Diretório: o primeiro argumento; senão . quando o diretório de trabalho estiver vazio; senão pergunte (padrão ./<slug-do-titulo>). Nunca crie o projeto dentro do diretório do plugin.
  • Configurações da solicitação: título, duração, formatos, fps, bpm, loop, URL da marca. Deixe o restante nos padrões do modelo (studio.json: 12 s, 60 fps, 4 subquadros, 120 BPM, primário 9x16).

2. Estruturar

node "${CLAUDE_SKILL_DIR}/scripts/init.mjs" <dir> --title "<Title>" [--duration S] [--fps N] [--bpm N] [--formats a,b] [--loop] [--brand-url URL] [--install] [--json]
BandeiraEfeito
<dir>alvo; criado se ausente
--title Ttítulo no studio.json e slug do arquivo de entrega
--duration S, --fps N, --bpm Ntemporização
--formats a,bsubconjunto de 9x16, 1x1, 16x9, 4x5 (ou all); primaryFormat permanece a menos que não esteja listado
--loopfilme de loop contínuo (interface se transforma)
--brand-url URLarmazena a URL do produto em brand.url. user:password@ e parâmetros com aparência de segredo (query, ;matrix, fragmento: token, key, secret, password, auth, sig, session, code ...) são removidos antes de qualquer gravação; stderr nomeia o que foi removido e --json lista em redacted. Ainda assim, passe uma URL pública simples: um segredo que é um segmento de caminho simples (/reset/<token>) não pode ser reconhecido. Uma URL simples é armazenada exatamente como digitada
--installexecuta npm install no novo projeto (lida com npm.cmd no Windows)
--forceatualiza um projeto antigo para o modelo atual (veja a tabela abaixo)
--jsonuma linha de resultado JSON em stdout

Um diretório existente não vazio é mesclado: apenas os arquivos ausentes são adicionados e os arquivos ignorados são listados. Relate a lista ignorada ao usuário; nunca exclua os arquivos deles.

--force em um projeto existente (verificado em relação a init.mjs):

CaminhoCom --force
studio.json, film/**, docs/**, assets/fonts/fonts.jsonmantidos e listados como kept; um ausente ainda é criado. Bandeiras como --bpm ainda corrigem studio.json
package.jsonmesclado, nunca substituído: define type: module, adiciona private, engines e todo script ou dependência do modelo que o projeto não possui. Um script do modelo cujo comando difere é redefinido para o comando do modelo (init imprime cada um como was ..., now ... e os retorna em packageReset). As versões de dependência nunca são alteradas, dependências do modelo incluídas: um intervalo existente permanece, mais novo, mais antigo ou fixo. Nome, versão, outros scripts e outros campos permanecem
.gitignoremesclado: linhas ausentes do modelo são anexadas abaixo de # motion-studio, nada é removido
todo o resto (CLAUDE.md, lib/**, tools/**, prompts/**, index.html, .env.example, fontes incluídas)sobrescrito e listado como overwritten. Edições locais nesses arquivos são perdidas: commit ou copie-os primeiro
seus próprios arquivos extrasintactos

Sem --force, package.json e .gitignore são mesclados da mesma forma, exceto que um script diferente mantém seu comando. Init lista todo script e versão de dependência que difere do modelo em kept your package.json values, which differ from the template (packageKept no resultado --json): esses npm run nomes executam SEU comando, e --force redefine scripts do modelo (nunca versões de dependência). Uma seção scripts, devDependencies ou optionalDependencies que não é um objeto é deixada intacta com um aviso. Como docs/** é mantido, um documento de modelo mais recente nunca atinge um projeto existente: compare com o template/docs/ do plugin manualmente após uma atualização.

3. Instalar, navegador, doctor

  1. Sem --install, execute npm install dentro do projeto. playwright é a única dependência obrigatória; ffmpeg-static é opcional e pode falhar ao baixar atrás de um proxy.
  2. Navegador (npm run setup:browser é o mesmo comando que a linha npx):
    • Windows: execute npx playwright install chromium-headless-shell (cerca de 115 MB de download, 270 MB no disco). studio.json browser: "auto" inicia apenas esse shell headless incluído, nunca o Chrome ou Edge instalado. Motivo: um Chrome ou Edge instalado iniciado com um perfil novo (a cada execução da ferramenta) faz o Chrome testar a conta do Windows para uma senha em branco, o que conta como uma falha de login. O laptop medido bloqueia a conta após 10 falhas de login em 10 minutos e registrou 464 em 24 h. Não altere browser para chrome ou msedge, e não defina MOTION_CHROME_PATH para um chrome.exe ou msedge.exe, a menos que o usuário peça e aceite o risco: ele imprime um aviso por inicialização e a 4ª inicialização em 10 minutos é recusada, 3 passam (o protetor de inicialização). O shell não é assinado, portanto um antivírus em tempo real pode tornar cada execução da ferramenta 15 a 25 s mais lenta (medido): informe o usuário uma vez; uma exclusão de antivírus para %LOCALAPPDATA%\ms-playwright é decisão deles ou de TI.
    • macOS e Linux: auto tenta o Chrome instalado, depois Edge, depois o navegador incluído, sem aviso. Se nenhum estiver instalado, execute npx playwright install chromium-headless-shell (Linux: npx playwright install --with-deps chromium-headless-shell), ou defina MOTION_CHROME_PATH para um executável da família Chromium.
  3. npm run doctor. Corrija cada linha FAIL antes de entregar, e no Windows uma linha WARN de navegador também (um Chrome ou Edge instalado foi escolhido: limpe-o e instale o shell headless); correções por SO estão em references/troubleshooting.md. Python com librosa é opcional (o mecanismo de batida JS cobre). Node 22+ é necessário apenas para ferramentas da rota B.
  4. Prove: npm run stills, depois abra out/review/9x16/contact.png (um filme longo é paginado: contact.png é a página 1, depois contact-2.png ..., nenhuma página com mais de 1800 px de altura; abra todas as páginas) e olhe. A demo de 12 s enviada deve mostrar um quadro composto em 0 s e uma mudança em cada tempo forte. npm run preview abre a pré-visualização ao vivo (Space pausa/play, setas avançam quadros, F cicla formatos, G guias de área segura).

4. Explique o projeto ao usuário

Resuma em algumas linhas, depois aponte para as referências:

  • Layout e quem edita o quê: references/project-layout.md
  • Todos os comandos: references/commands.md
  • Todas as assinaturas e padrões lib/: docs/API.md no novo projeto (a referência completa é docs/ARCHITECTURE.md no repositório do plugin)
  • As regras da casa residem no CLAUDE.md do projeto, que o Claude Code lê a cada execução lá.

Se init imprimiu uma linha de estrela ★ (starHint no resultado --json; aparece uma vez por máquina, no primeiro novo projeto), termine seu resumo com essa única linha como escrita. Nunca dê estrela no repositório ou execute gh para o usuário.

ComandoFaz
npm run previewpré-visualização ao vivo no navegador
npm run stillsum still por batida como folha de contato
npm run critiquecontato, tira, teste de telefone, métricas, bloco de revisão
npm run gateportão de crítica: 3 rodadas, todos os eixos >= 8, sem P0
npm run render:finaltodos os formatos, qualidade final (portão aplicado)
npm run sfx / npm run mixsintetizar SFX de cue / mixar para -14 LUFS e multiplexar
npm run deliververificações de entrega e pacote out/deliver/
npm run buildpartitura se ausente, sfx, renderização final, mix, entrega

5. Esforço e rotas

TrabalhoEsforçoDefinir com
pequenas correções, re-renderizaçõesmédio/effort medium
um novo filmexhigh/effort xhigh (a habilidade motion-reel define para você)
primeiros 3 segundos emblemáticos de um lançamentomax/effort max

/model também oferece a escolha de esforço ao selecionar Opus 5.5. A Rota A (este mecanismo) é o padrão. Use Remotion ou HyperFrames apenas quando o usuário nomear um; /motion-studio:seek-engine tem o handoff, incluindo o portão de licença Remotion.

6. Chaves

Copie .env.example para .env apenas quando uma chave for necessária (voz: ELEVENLABS_API_KEY; rota C imagens/vídeo: FAL_KEY). Diga ao usuário para colar o valor em .env ele mesmo. Em prompts e logs, refira-se apenas ao nome da variável. .env já está no .gitignore do projeto.

7. Companheiros opcionais

Mencione estes apenas quando relevante. Comandos de instalação e observações: references/companions.md.

CompanheiroUso paraNota
claude-animation (buildwithhanif)desenho à mão, pincel, aparência de storybookMIT; renderizador de canvas Node separado
HyperFrames (heygen-com)composições HTML + GSAPApache-2.0; Node 22+
Remotionséries e modelos Reactlicença corporativa para organizações com fins lucrativos com mais de 3 funcionários

Próximo: teste o mecanismo com /motion-studio:showreel, ou faça um filme real com /motion-studio:motion-reel.

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

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

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