Communitygithub.com

motionable: make

Pipeline interno da Motionable (modo plano, aprovação, cenas, música, crítica, renderização). Comece com /motionable:scratch, :website ou :project.

O que é motionable: make?

Este skill capacita um agente de IA para funcionar como um pipeline completo de produção de filmes promocionais, transformando fatos e personalidade de um produto em um filme acabado e único, sem repetir estilos de trabalhos anteriores. Ele é projetado para uso com ferramentas como Claude Code, Cursor ou Codex, e opera a partir de um diretório raiz (`ROOT`) contendo os scripts do motor de animação. O fluxo de trabalho começa com a coleta de evidências e personalidade do produto, segue um plano detalhado que gera um roteiro e direção visual, obtém aprovação do usuário por meio de um resumo de 4 linhas e uma grade de batidas, e então constrói o filme escrevendo código Swift, gerando ilustrações SVG e compondo música. A revisão automatizada é rigorosa: o agente executa verificações de tempo, legibilidade de interface, comparação com outros filmes e qualidade de áudio, corrigindo problemas em até duas rodadas antes de exibir o resultado final ao usuário. O skill também suporta personalizações como adição de selos da App Store (com regras específicas), variantes de abertura para testes A/B e cortes para diferentes formatos, garantindo um produto de alta qualidade com mínimo retrabalho manual.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/suntay44/motionable/tree/HEAD/skills/make

Perguntar na sua IA favorita

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

Documentação

O que motionable: make faz?

Você chega aqui com fatos sobre um produto (cada um com uma fonte), as respostas do usuário, caminhos de imagens, cores e anotações sobre sua personalidade. Seu trabalho é um filme finalizado que pareça este produto, e nenhum outro filme do estúdio.

ROOT é a raiz da motionable: ${CLAUDE_PLUGIN_ROOT}. Se isso não for expandido, use a pasta dois níveis acima do caminho real (realpath) deste arquivo, que contém engine/ e scripts/.

Leia ROOT/PLAN.md (modo plano), ROOT/ENGINE.md (os ingredientes), ROOT/rules.md (regras rígidas) e ROOT/checklist.md (crítica) antes de planejar. ROOT/examples/owly/ mostra como é um trabalho finalizado. Nunca copie seu visual, som ou estrutura: é uma direção entre infinitas.

1. Crie o filme

  • Onde: os filmes ficam na pasta atual (normalmente o estúdio do usuário para vídeos hype), como <slug>/.
    • Se a pasta atual for o repositório do próprio produto, use motionable/<slug>/.
    • Nunca escreva dentro de uma pasta de produto fornecida a /motionable:project.
    • Se <slug>/ existir, pergunte: criar uma nova versão (<slug>-2/) ou continuar aquele filme?
  • Crie-o: execute bash ROOT/scripts/new.sh <film> "<Nome do produto>". Ele copia o motor para o filme e escreve os modelos.
  • Assets: copie as imagens para <film>/assets/ com nomes claros (logo.png, screen-home.png…). Um arquivo de fonte da marca, se o usuário tiver, vai em assets/fonts/.

2. Modo plano (interno: sem comando, sem menu de estilo)

Siga PLAN.md do início ao fim:

  1. Quadro de evidências e personalidade.
  2. História: promessa, momento marcante, 3 ganchos → 1.
  3. Cada dial definido, cada um com seu motivo.
  4. Singularidade em relação ao estúdio: leia o DIRECTION.md › Fingerprint dos outros filmes. Filmes feitos antes de v0.2 não têm nenhum; trate-os como house 120 BPM em Lá menor com títulos alinhados à esquerda sobre um card.
  5. Escreva DIRECTION.md e SCRIPT.md no andamento escolhido.

Não peça ao usuário para escolher um estilo. A direção vem das evidências.

3. Uma aprovação

Mostre o resumo de 4 linhas (Sensação · Som · Visual · Momento marcante) e uma grade compacta de batidas (tempo · imagem · palavras · junção). Em seguida, pergunte, com AskUserQuestion se disponível (caso contrário, no chat):

  1. O plano: aprovar ou alterar algo.
  2. Ilustrações: "Devo desenhar ilustrações para este filme?" Sim, ilustre / Alguns acentos / Não, apenas screenshots e texto. Recomende uma com um motivo (PLAN.md §5).
    • Desenhá-las é gratuito: Claude escreve SVGs.
    • Somente se a sessão tiver uma ferramenta de geração de imagens conectada, adicione-a como opção e diga que pode custar dinheiro.

Não escreva nenhum código de cena antes da aprovação. Uma mudança aqui é barata.

4. Construa

  1. Ilustrações (se sim): escreva os SVGs em assets/drawn/ nas cores da marca e uma espessura de linha (ENGINE.md › Ilustrações desenhadas). Observe cada uma renderizada em uma folha e redesenhe qualquer coisa desajeitada.
  2. scenes/Film.swift: substitua o esqueleto completamente. Cada valor vem de DIRECTION.md e SCRIPT.md:
    • os tempos vão em enum T;
    • clipes e junções vão em um Reel;
    • telas passam pelas chamadas de enquadramento (nunca cortadas em uma caixa fixa);
    • o momento marcante é redesenhado para animar exatamente como a UI real. Meça onde ele está primeiro: bash ROOT/scripts/inspect.sh <screenshot> find <sua cor> (ou row, column, pixel) dá anéis, barras e bordas de texto exatos.
    • Elementos personalizados que a direção precisa vão em seus próprios arquivos scenes/*.swift.
  3. Som: a Recipe da direção + Sections via s.compose, mais um s.cue para cada evento de imagem, usando os sons característicos.
  4. Verifique se compila: bash ROOT/scripts/run.sh <film> sheet (sem tempos: o filme inteiro mais cada junção). Corrija erros de compilação (ENGINE.md › Pegadinhas).

5. Rascunho, corrija, depois mostre ao usuário

Trabalhe em rascunhos e nunca faça loops infinitos:

  1. Rascunho 1 é a primeira compilação completa: cenas, música e cada cue. Revise-o a partir do próprio filme (os passos abaixo); você não precisa de um arquivo de vídeo para isso. (run.sh <film> draft renderiza um MP4 pequeno e rápido se o usuário quiser uma prévia.)
  2. Autoavaliação: uma passada, e cada verificação.
    • run.sh <film> check: cada ✗ é uma correção obrigatória. Segure a linha por mais tempo, comece-a mais cedo, corte palavras ou remova a linha. Uma linha digitada precisa de seu tempo de digitação mais seu tempo de leitura. Siga também seus conselhos ⚠ (quadro 1, ritmo), a menos que DIRECTION.md diga por que não.
    • run.sh <film> sheet: pontue cada categoria em checklist.md e corrija qualquer coisa abaixo de 8. Olhe para stills em tamanho real do gancho, do momento marcante e do cartão final: a UI é legível, algo colide, cada canto do quadro está fazendo algo ou deliberadamente vazio?
    • O que os espectadores punem (RESEARCH.md › verificação da comunidade): UI muito pequena para ler, oscilação em coisas grandes, planos de um comprimento só, música com som de stock, um momento de logotipo lento.
    • run.sh <film> audio, depois bash ROOT/scripts/compare.sh <film>: se outro filme for muito semelhante, altere a receita por um motivo.
    • Percorra o filme inteiro: run.sh <film> sheet $(seq 0.5 1 <duração>) (um quadro por segundo). Procure o que stills isolados escondem: uma cena que se esvazia, uma batida sem movimento, uma junção que choca, uma linha que aparece exatamente quando a cena sai.
  3. Rascunho 2. Corrija tudo encontrado em um lote, depois execute check e sheet novamente.
    • Se algo ainda falhar, permita no máximo mais uma passada de correção.
    • Se ainda falhar depois disso, não continue: diga ao usuário o que resta e por quê.
    • Mantenha um breve registro de crítica em SCRIPT.md: o que mudou e por quê.
  4. Renderize o arquivo real: run.sh <film> video, cerca de 45 s para 30 s.
  5. Mostre e pergunte (AskUserQuestion se disponível). Envie o MP4, o resumo de 4 linhas e o registro de crítica, depois faça 3–4 perguntas direcionadas sobre este corte. Cada uma precisa de uma opção recomendada, e "Outro" permite que o usuário diga qualquer coisa:
    • Ritmo: parece certo / mais lento, menos linhas / mais rápido, mais impacto.
    • Som: manter / mais energia / mais calmo / instrumentos diferentes.
    • Gancho: manter, ou o mais forte dos outros dois candidatos a gancho do modo plano, nomeado.
    • Final: manter / um final seguro para lançamento (por exemplo, sem selo de Download antes do app estar ao vivo) / adicionar o preço.
  6. Revise uma vez por rodada de respostas, executando novamente check, audio e compare, depois mostre o novo corte. Após duas rodadas do usuário, ofereça parar ou continuar; o usuário decide.

6. Armazene selos (apenas se o produto estiver ao vivo)

  • App Store ao vivo e o usuário quer um selo: peça permissão para baixar o selo oficial da Apple (cerca de 11 KB, preto, SVG em inglês; URL em rules.md) para assets/.
    • Desenhe-o com drawAppStoreBadge, parado e nunca animado; a ênfase vem de glowRing.
    • Se o usuário insistir em animá-lo, explique a regra da Apple uma vez. Se ele ainda quiser, faça disso uma variante separada e claramente nomeada.
  • Google Play: seu selo apenas se o app estiver ao vivo lá e o usuário aprovar o download. Caso contrário, no máximo uma linha de texto simples, e apenas se for verdade.

7. Entregue

A cada corte que você mostrar, inclua:

  • o resumo em algumas linhas;
  • o que a autoavaliação corrigiu;
  • o resultado da comparação e o veredito de check;
  • as afirmações a verificar antes de postar;
  • como alterá-lo: edite SCRIPT.md ou DIRECTION.md, ou apenas diga.

Depois que o usuário estiver satisfeito, ofereça as próximas coisas úteis:

  • um corte de 15 s, ou outro formato (1:1, 16:9);
  • variantes de gancho para um teste A/B: o mesmo filme aberto com os outros dois candidatos a gancho do modo plano;
  • um final seguro para lançamento (sem "Download" antes do app estar ao vivo);
  • uma versão apenas com efeitos (run.sh <film> video effects), para postar com um som de plataforma ou uma faixa licenciada.

Individual skills in this repo

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

Habilidades Relacionadas