Communitygithub.com

motion-studio (estúdio de movimento)

Transforma uma referência (um frame, um vídeo ou uma biblioteca de imagens) em docs/style_guide.md e uma lista de planos no ritmo da batida: mede cortes, paleta e ritmo, capta a gramática, não o conteúdo, e aguarda aprovação. Use quando o usuário fornecer ou nomear um visual.

O que é motion-studio (estúdio de movimento)?

Esta habilidade transforma qualquer referência visual — um único frame, um vídeo completo ou uma pasta de imagens próprias — em dois documentos aprovados antes mesmo de qualquer código de filme ser escrito. Ao contrário de descrições abstratas, uma referência fornece ao modelo o ritmo, o tipo e as transições a copiar. A habilidade primeiro copia a referência para o disco, depois usa `refs.mjs` para extrair cortes, duração dos planos, paleta de cores, movimento por segundo e densidade de texto. Em seguida, escreve um guia de estilo (`docs/style_guide.md`) e uma lista de planos (`docs/shotlist.md`) sincronizados com a batida do áudio. A regra de ouro é captar a *gramática* da referência (relações de paleta, tipos de transição, linguagem de câmera) nunca o conteúdo (logotipos, personagens, texto). O usuário revisa ambos os documentos e dá o OK antes de qualquer código ser gerado. Funciona em qualquer projeto que use a estrutura `motion-studio` (via `/motion-studio:studio-init`) e lida com vídeos locais, frames ou pastas de imagens. A habilidade também permite que o modelo escolha a técnica de renderização (p5.js, canvas puro, etc.) com base na descrição do visual, não no nome da biblioteca.

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

Perguntar na sua IA favorita

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

Documentação

Estilo de referência (passo 05 do curso)

Sem referência, o modelo deriva para um visual padrão: texto centralizado sobre um gradiente com todos os elementos aparecendo gradualmente. Rexan Wong (@rexan_wong) analisou um lote de clipes virais e descobriu que nomear um estilo funciona melhor do que descrevê-lo, e que uma referência fornece ao modelo o ritmo, o tipo e as transições a copiar. Esta habilidade transforma uma referência em dois documentos aprovados antes de qualquer código de filme existir.

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

A escada da referência

DegrauO que o usuário forneceO que você extraiFerramenta
Um frameuma imagem estática de um vídeo que ele amapaleta, tipo, textura, densidade de composiçãorefs.mjs analyze refs/<pasta> + olhe para ele
Um vídeoum arquivo local de um filme que ele admirao acima mais tempos de corte, duração dos planos, energia de movimento por segundo, transiçõesrefs.mjs extract + analyze
Uma bibliotecauma pasta com imagens próprias ou trabalhos passadosum estilo de casa que ninguém mais pode copiarrefs.mjs analyze refs/<pasta>

O TikTok de código puro da Pleometric começou a partir de um único frame de outra animação viral; seu filme estilo Donald apontou o Opus para sua própria galeria de imagens PC-98. Onde encontrar referências: vídeos de lançamento em whatships.com, motion no Dribbble e filmes de lançamento de concorrentes. Estude-os; nunca os incorpore ou redistribua.

1. Coloque a referência no disco

  • Copie o arquivo ou pasta para refs/ no projeto (primeiro use /motion-studio:studio-init se não houver studio.json).
  • Dado apenas um link para o vídeo de outra pessoa, peça ao usuário uma cópia local que ele tenha permissão para estudar. Não baixe mídia de terceiros por conta própria.
  • Um único frame: coloque-o em sua própria pasta (refs/frame/) para que analyze o trate como um conjunto de imagens.
  • Pergunte o que pegar e o que não pegar quando o usuário tiver uma opinião ("a granulação e o tipo, não os personagens").

2. Meça

Execute a partir da raiz do projeto:

ReferênciaComandos
vídeonode tools/refs.mjs extract refs/<video> --every 0.5 em seguida node tools/refs.mjs analyze refs/<video>
frame ou bibliotecanode tools/refs.mjs analyze refs/<pasta>
cortador rápido (muitos cortes perdidos)adicione --threshold 0.2 ao analyze

Saídas: refs/frames/frame_NNNN.png, refs/frames/frames.json, refs/contact.png (folha legendada com até 60 quadros; uma folha alta é paginada como qualquer folha de contato: refs/contact.png é a página 1, depois refs/contact-2.png, contact-3.png ...; abra cada página, o resultado --json as lista em contacts) e refs/analysis.json com tempos de corte, duração dos planos (média, mediana, intervalo), uma paleta de 6 cores com proporções, brilho e contraste, energia de movimento por segundo com seu pico e uma dica de densidade de texto. O resumo impresso é um ponto de partida para o guia de estilo.

3. Escreva o guia de estilo e a lista de planos

Chame motion-studio:style-analyst (ele pode escrever docs/style_guide.md, docs/shotlist.md e refs/**):

Raiz do projeto: <caminho absoluto>. Referência: refs/<arquivo ou pasta>. Assunto: <assunto>. Duração: <S> s.
Abra refs/contact.png (e refs/contact-2.png ... quando estiver paginado) e alguns quadros próximos aos cortes, leia refs/analysis.json.
Escreva docs/style_guide.md seguindo as notas do guia de estilo, depois docs/shotlist.md para um filme de <S> s
sobre <assunto> naquele estilo, na grade de batidas de audio/beats.json (ou <BPM> BPM se ausente).
Capture a gramática da referência, nunca seu conteúdo, logotipos, personagens ou texto.
Retorne perguntas em vez de adivinhar.

As notas seção por seção estão em assets/style-guide-notes.md. Para usuários que desejam colar um prompt em uma nova sessão, os mesmos passos estão escritos como assets/reference-prompt.md.

4. Capture a gramática, nunca o conteúdo

CaptureNunca capture
relações de paleta (fundo escuro, um acento quente, proporção do acento)logotipos, personagens, mascotes
famílias tipográficas por classe, peso, espaçamento, saltos de escalacomposições ou frames exatos
duração dos planos e onde os cortes caem em relação à batidao texto, alegações ou dados da referência
tipos de transição (corte seco, wipe de máscara, match cut)sua filmagem, música ou voz
linguagem de câmera (zoom in, whip pan, câmera fixa)formas específicas de marca ou identidade visual
textura (quantidade de granulação, papel, pontilhado) e como o texto entra e saiqualquer coisa que o usuário não pediu para emprestar

5. O portão

Mostre ambos os arquivos (um resumo compacto do guia de estilo e a tabela da lista de planos é suficiente) e aguarde o OK do usuário antes de qualquer código de filme. Quando ele rejeitar, reescreva a lista de planos (e o guia de estilo se o visual estiver errado), nunca ajuste código para "mostrar em vez disso". Registre a decisão na linha Status: no topo de docs/shotlist.md.

6. Deixe o modelo escolher a técnica

Especifique o visual e as restrições, não a biblioteca. Pleometric sugeriu p5.js e Opus escreveu seu próprio renderizador de papel. Dentro deste estúdio, isso significa: descreva a textura e o movimento desejados no guia de estilo, e deixe a construção escolher como desenhá-los no motor de canvas (helpers lib/draw.js ou desenho personalizado). Nomeie um framework apenas quando o usuário precisar dele para reuso (rota B, /motion-studio:seek-engine).

Próximo: construa com /motion-studio:motion-reel a partir do estágio 5; para um loop de estado de UI neste estilo, /motion-studio:ui-morph-spec.

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

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