Communitygithub.com

jayfirke/motion-studio

Planeje um filme como seu diretor e apresente-o ao proprietário como uma página de pré-visualização interativa (animatic com voz real, música e foley, uma linha do tempo, três opções trocáveis para cada decisão, notas ancoradas no tempo, versões e um botão de Aprovação) antes de qualquer renderização. Use para cada novo filme com mais de 10 segundos, quando o proprietário pedir para 'ver primeiro', 'pré-visualizar', 'storyboard', 'animatic' ou 'visualizar antes de renderizar', e quando eles deixarem notas em uma página de pré-visualização. Produz o approved-video-spec.json para as skills de motor; nunca renderiza o final em si.

O que é motion-studio?

Esta skill transforma o processo de pré-produção de filmes em uma experiência colaborativa e iterativa, permitindo que diretores tomem decisões criativas caras no estágio mais barato possível. Em vez de renderizar cenas finais, ela gera uma página web interativa (Previs Studio) que simula o filme completo: um player de vídeo com scrubbing, linhas do tempo, opções de direção, música e efeitos sonoros que podem ser trocados em tempo real, notas ancoradas no tempo, ferramentas de comparação lado a lado e um botão de aprovação. O proprietário do projeto pode assistir, comentar e aprovar antes que qualquer renderização cara seja feita. A skill é projetada para ser usada com o Claude Code, que recebe as notas da página, as processa e atualiza os dados do filme, mantendo um ciclo de revisão transparente. Ela suporta múltiplos 'motores' de renderização (como HyperFrames, Remotion, Diffusion Studio) que só constroem o que foi aprovado, garantindo que o trabalho final seja exatamente o que o cliente validou.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jayfirke/motion-studio/tree/HEAD/.agents/skills/video-director-previs

Perguntar na sua IA favorita

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

Documentação

video-director-previs

Tome decisões criativas caras no estágio mais barato. Esta skill é responsável pela pré-produção: direção, história, roteiro, storyboard, styleframes, animatic, música, SFX, voz, escolha do motor, QA, revisão, versões e aprovação. Os motores (HyperFrames, video-shotcraft, Remotion, motion-reel, bang-motion, Diffusion Studio) só constroem o que o proprietário aprovou.

Exemplo prático: examples/crumb-previs/ (um aplicativo fictício de divisão de contas). Seu pacote de dados é o filme de demonstração no Previs Studio (_shared/previs/studio/films/011-crumb/).

O aplicativo nunca muda por filme. O Previs Studio é um aplicativo React + TypeScript fixo (fonte _shared/previs/app/, veja seu README). npm run build lá faz type-check, empacota e incorpora em _shared/previs/studio/index.html e _shared/previs/page/index.html (template); adicione um destino em scripts/inline.mjs para cada página por filme. npm run smoke testa a página construída no Chrome real em desktop, tablet, celular e tela cheia (capturas de tela com --out). Nunca edite manualmente o index.html construído.

O que o proprietário recebe: Assistir (player estilo vídeo com tela cheia verdadeira, pré-visualização por hover-scrub, cartão final; modo de comentário que nomeia a menor parte sob o ponteiro, role para maior ou menor, arraste uma caixa em torno de várias partes, caneta e seta, arraste pela linha de cenas para um intervalo de tempo; faixas de som com formas de onda, batidas, curva de duck, solo/mute/volume e SFX arrastáveis que se encaixam na batida), escolhas que reproduzem seu momento no lugar com som, comparação lado a lado, segure para ouvir o original, Storyboard (cartões que reproduzem sua cena no lugar, Reproduzir tudo, escolhas por cena, uma folha de cenas), Plano (diretor chefe, história, equipe de direção, visual, som, ativos, produção, verificações, versões com "pedir para desfazer", exportação de especificação), uma revisão guiada, Pergunte ao diretor, busca ⌘K, desfazer/refazer, temas claro e escuro, dicas de ferramentas em cada controle. Os filmes chegam apenas como pacotes de dados.

Dois lares, mesmo aplicativo

  • Previs Studio (todos os filmes): _shared/previs/studio/. Adicionar um filme = adicionar films/<id>/previs.json + films/<id>/audio/... e uma linha em films.json. Localmente: python3 -m http.server --directory _shared/previs/studio (ou a entrada previs-studio em .claude/launch.json).
  • Página por filme: projects/NNN/previs/page/ contém uma cópia do mesmo index.html (título <Product> Previs), films.json com uma linha cujo path é "", previs.json e audio/.
  • Como um Artefato do claude.ai (apenas Claude): publique a página com capabilities: {"db": {}, "user": {}, "sample": {}, "comments": {}, "downloads": true}. db armazena notas e escolhas, sample alimenta Pergunte ao diretor, comments carrega "Enviar para Claude Code", downloads a exportação da especificação. Sem elas, a página ainda funciona e salva no navegador.
  • Caminhos do banco de dados: comentários (solicitações de alteração fixadas no filme; a coleção mantém o nome antigo) films/<id>/notes (kind frame, region, range, sound, shot, revert ou request; target, targets, box, strokes, quick chips, t/t2, picks e version no momento); escolhas e ajustes de som films/<id>/state/picks (tweaks: <scene>.<sfx> {dt, db}, lane.vo|music|sfx {db}, mix.duck {on}); opções adicionadas films/<id>/state/custom; aprovação films/<id>/state/approval; status do Claude films/<id>/state/claude; atividade films/<id>/activity; notas (pensamentos livres sobre o filme como um todo: leia-as como contexto, nunca como tarefas) films/<id>/pad.

Bibliotecas: mais de três opções sob demanda

Cada decisão fornece três opções de diretor; D['libraries'] adiciona mais que o revisor (ou a aba Pergunte) pode puxar: direction (visuais: conjuntos de tokens + fonts_url), music (bases CC0 com bpm, phase, tags, level), motion (ease, spring {f,d} ou bezier), pacing, camera, transition, sfx (cada som no filme) e voice (vozes Fish: dir, durs, texts para outros idiomas, intro, sample). A decisão global voice escolhe o narrador; uma voz resolve cada linha para <dir><scene>-<A|B|C>.mp3, e uma voz com needs e sem dir é reproduzida como legendas até ser gravada. As opções adicionadas vivem no banco de dados da página, são desfazíveis e vão para a especificação aprovada. Construa bibliotecas com examples/crumb-previs/libraries.py como modelo:

  • Música: pesquise Freesound CC0 (freesound.py search ... --min-dur 20), freesound.py get, depois python3 _shared/previs/music_lib.py <page>/audio/music/lib <oggs> (excertos de 24 s alinhados à batida, BPM medido); escreva tags e um porquê por base; linhas de registro em _shared/ASSETS.md.
  • Vozes: escolha vozes públicas Fish com search_voices (sem clones de pessoas reais ou personagens), liste-as em voices/voices.tsv, escreva voices/lines-<lang>.txt, execute voices/make_voices.sh (modelo gratuito), depois verifique takes com whisper-cli e regenere qualquer um que perca palavras.
  • O diretor de IA (aba Pergunte, lib/director.ts) também pode projetar visuais (verificado por contraste, fontes Google permitidas), sensações de movimento e novas redações de linhas (que precisam de gravação: ele emite uma nota de solicitação para o Claude Code).

O lado do Claude Code nas notas (faça isso a cada rodada)

O proprietário envia notas da página ("Enviar para Claude Code": um comentário ao vivo que acorda uma sessão de observação, ou uma mensagem copiada). Então: 0. Puxe antes de mudar. O Claude no claude.ai pode responder a um thread "Enviar para Claude Code" por conta própria, editar o arquivo de dados e publicar uma nova versão. Antes de construir, leia o previs.json publicado, compare-o com sua construção local e porte qualquer alteração para build_previs.py para que a próxima construção a mantenha.

  1. Defina films/<id>/state/claude {state:"reading"|"working"|"publishing"|"idle", at, message, version, open} para que a página mostre o que você está fazendo.
  2. Para cada nota aberta: update-a com claude: {state:"seen"} quando lida, {state:"working"} enquanto altera, depois status:"done", claude:{state:"done", at, msg} e anexe {by:"claude", text, at} a replies (fixe if_version). Use state:"question" (com a pergunta em msg) quando precisar do proprietário, "wontfix" quando recomendar mantê-la. Notas com kind:"request" são trabalhos da aba Pergunte (gravar uma nova linha, encontrar um som); prefer aponta para a opção que o proprietário gosta; intent:"question" quer uma resposta, não uma alteração. Cada at é o tempo real: tire-o de date -u +%Y-%m-%dT%H:%M:%SZ, nunca um palpite.
  3. Adicione linhas a films/<id>/activity ({at, by:"claude", kind:"seen"|"applied"|"published"|"question", text, version}): o que você leu, o que mudou, o que publicou.
  4. Responda no thread de comentários da página se o proprietário usou Enviar para Claude Code, depois resolva-o.

Regras

  • Um diretor, sem comitê. Trabalhe através da lista de verificação especializada abaixo você mesmo, em ordem. Sem fluxos de trabalho ou subagentes, a menos que o proprietário peça (regra de custo).
  • Infira agressivamente; pergunte apenas verdadeiros bloqueadores (verdade do produto, um ativo faltando, uma questão de licença). Nunca um longo questionário antes de o proprietário ver algo.
  • Três opções em cada decisão, por padrão. Direção, música, sensação de movimento, ritmo e por cena: transição, câmera, linha de voz, cada evento SFX. As opções devem ser genuinamente diferentes. Marque a escolha do diretor e dê a cada opção uma frase simples do porquê ou trade-off. "Nada" é uma opção SFX válida.
  • Verdade do produto. Cada cena é rotulada real_ui, conceptual_ui, conceptual_visual ou external_footage; qualquer coisa que não seja real mostra um rótulo no player.
  • As regras da casa ainda se aplicam (AGENTS.md, OWNER.md): clichês proibidos, carries, dois níveis de texto, foley gravado, a voz padrão, licenças. A página só reproduz áudio CC0 ou auto-fabricado; Mixkit (apenas renderização) aparece apenas pelo nome.
  • Reduza a escala. Um sting de 6 s pode ser um cartão de direção, 3 opções de música e um animatic de 6 s. Um filme de produto de 40 s recebe o conjunto completo.
  • Travamentos. Assim que o proprietário aprovar, história, cópia, ordem, tempo e escolhas são travados. Uma nota posterior altera apenas seu alvo; liste o que você preservou.

Lista de verificação especializada (o diretor cobre cada um, brevemente)

História (gancho aos 2 s, um estado por batida) · roteiro e linhas de voz (palavras por segundo ≤ 3,4) · ritmo editorial (varie a duração dos takes, pausas, nem todo corte na batida) · direção de arte (3 direções como conjuntos de tokens: bg, on-bg, card, on-card, muted, line, paper, on-paper, accent, on-accent, frame, display, ui, mono) · tipografia · referências (emprestar / evitar / onde usado; gramática, nunca conteúdo) · câmera (cada movimento tem uma razão) · movimento (propósito, ease, overshoot ≤ 4% na UI, nenhum no tipo) · transições (um corte simples é válido) · ativos (existente / novo / gerado / placeholder, com licença) · música (BPM e fase medidos, curva de energia, onde o drop cai) · SFX (ativo, tempo, gatilho, ganho, porquê) · mix (voz lidera, duck 8 dB, impacto mais alto) · motor (escolhido, porquê, alternativa, fallback) · QA.

Arquivos (uma pasta por filme)

projects/NNN-name/previs/
  build_previs.py          # escreve page/previs.json; copie examples/crumb-previs/build_previs.py e edite (cenas = styleframe HTML + anim tweens)
  vo-lines.txt             # 3 redações por linha, para fish_tts.py
  page/index.html          # construído por _shared/previs/app (npm run build; adicione esta página como um destino em scripts/inline.mjs)
  page/films.json          # [{"id": "NNN-name", "name": "Product", "path": ""}]
  page/previs.json         # o plano completo
  page/audio/{music,vo,sfx}/
  changes.jsonl            # log de alterações somente anexação, uma operação por linha
  approved-video-spec.json # escrito por _shared/previs/freeze_spec.py após aprovação

Passos

  1. Leia o briefing ou pedido de uma linha e a fonte do produto (UI real, tokens, cópia). Escreva BRIEF.md com as decisões inferidas.
  2. Áudio (barato, local):
    • Bases: meça tempo e fase por comb fit sobre 85–150 BPM em um envelope de onset de baixa banda (AGENTS-tooling.md, "Previs"); corte excertos de 24 s começando em uma batida, loudnorm para −18 LUFS: ffmpeg -ss <phase> -t 24 -i bed.wav -af "loudnorm=I=-18:TP=-2,afade=t=out:st=22.5:d=1.5" page/audio/music/A.mp3.
    • Voz: python3 _shared/tools/fish_tts.py --lines previs/vo-lines.txt --out-dir previs/vo-wav (modelo gratuito), depois corte silêncio em page/audio/vo/sN-{A,B,C}.mp3.
    • Foley: copie prévias CC0 de _guide/prompt-studio/media/foley/ ou busque com freesound.py.
  3. Planeje em build_previs.py (veja o exemplo para cada campo): project, summary, chief, story (beats → scenes), directors, assets, gates, pipeline, changes, directions (3), global.music|motion|pacing|voice (3 cada), engine, references, style_rules, audio_notes, qa, versions, film_css (todas as cores via tokens, classes prefixadas f-), fonts_url, e scenes[] com html, anim (tweens {s, t:[a,b], f, to, e} em x, y, s, sx, sy, r, o, clip, w, blur; {s, set, at, until} alternâncias de classe; {s, count:[from,to], t, p, d} contadores; e:'m' segue a escolha de Movimento), decisions (tipos de transição cut, push, slide, zoom, iris; camera {s,x,y,origin}; vo {text, src, dur, at, copy}), sfx (at pode ser uma lista para execuções), key (o momento do still do storyboard). Dê a cada elemento que o proprietário possa apontar um simples data-name ("Total do recibo", "Botão de solicitação").
  4. Verifique localmente: sirva a pasta da página, veja um still de cada cena e um no meio da transição, alterne todas as três direções uma vez, confirme que não há erros no console. Uma passada, sem loop.
  5. Compartilhe a página (localmente, ou como um Artefato do claude.ai com as capabilities acima) e adicione o filme ao Previs Studio. Dê ao proprietário o link e um resumo de cinco linhas. Pare para revisão.
  6. Loop de revisão (cada rodada é uma republicação):
    • Leia notas, escolhas e aprovação.
    • Para cada nota aberta: altere apenas seu alvo, anexe uma operação a changes.jsonl ({"v","target","t","change","from","to","reason","preserve":[...]}), depois marque a nota como concluída com uma resposta de uma linha (protocolo acima). Uma nota revert pede para desfazer uma alteração listada.
    • Aumente versions e adicione as changes da rodada em build_previs.py, execute-o novamente, copie previs.json para a cópia do Studio, republique. O player mostra um banner "o que mudou" e o Plano lista cada alteração com um pedido de Desfazer.
  7. Aprovação: quando state/approval tiver approved: true (carrega picks, tweaks e custom), salve-o, execute python3 _shared/previs/freeze_spec.py projects/NNN-name/previs --approval <file> (resolve opções adicionadas e a voz, e lista needs_before_build como linhas não gravadas), escreva SHOTLIST.md a partir da especificação, depois passe para a skill de motor nomeada na especificação. O motor constrói exatamente a especificação (polimento permitido, decisões não).

Custo

Apenas trabalho solo. Uma pré-visualização de 20 s leva algumas horas de uma sessão (aproximadamente $30–60 equivalente API), com Fish no modelo gratuito e sem renderizações. A renderização de produção e suas verificações vêm após a aprovação.

Individual skills in this repo

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

Habilidades Relacionadas