Communitygithub.com

MotionSnip Studio

Construa motion graphics em código e revise-os no MotionSnip Studio, um player local onde o usuário assiste ao render, corrige palavras no lugar, troca música, circula problemas no quadro e envia um único prompt de volta. Use sempre que o usuário pedir um motion graphic, vídeo de lançamento, explicador, vídeo de produto, promo animada ou vídeo similar feito em código (Remotion ou qualquer outro renderizador), quando quiser revisar ou iterar em tal vídeo, ou quando colar uma linha como "Apply the MotionSnip Studio feedback in <caminho>" ou compartilhar um arquivo markdown "MotionSnip Studio feedback".

O que é MotionSnip Studio?

MotionSnip Studio é uma skill que cria um loop de revisão local e de alta velocidade para vídeos feitos em código (Remotion, ffmpeg, etc.). O agente constrói e renderiza o vídeo, descreve-o em um arquivo `reel.json` e abre um player local. O usuário assiste, faz anotações (clica em elementos, circula problemas, troca música) e clica em "Enviar para Claude", que retorna uma única linha de feedback. O agente aplica as alterações, re-renderiza e incrementa a versão, e o player recarrega automaticamente. Essa skill é ideal para iterar rapidamente em motion graphics, vídeos de lançamento, explicadores e outros conteúdos animados, suportando remoção de erros de digitação, ajustes de layout, troca de música e muito mais. O design mantém os ativos de código separados (por exemplo, arquivo de música separado do vídeo) para que as edições sejam baratas e rápidas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jishanpathan7/motionsnip-studio/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

O que MotionSnip Studio faz?

Você constrói o vídeo. O usuário o revisa em um player local. O loop é:

  1. Construa e renderize o vídeo.
  2. Descreva-o em reel.json.
  3. Abra o player.
  4. O usuário revisa e clica em Enviar para Claude. Você recebe uma linha: Apply the MotionSnip Studio feedback in <caminho absoluto>.
  5. Aplique o feedback, re-renderize, incremente a version. O player recarrega sozinho e ajuda o usuário a verificar suas alterações.

Neste arquivo, <diretório da skill> significa a pasta que contém este SKILL.md, geralmente ~/.claude/skills/motionsnip-studio.

1. Configure o projeto

Use uma pasta por vídeo:

<projeto>/
  reel.json        você escreve isso
  video.mp4        o render (qualquer nome; "src" em reel.json aponta para ele)
  assets/          música, imagens, logos (uploads do usuário também vão parar aqui)
  public/          opcional; ativos do Remotion staticFile()
  exports/         criado pela Exportação do player; nunca edite
  .motionsnip/     estado e histórico do player; nunca edite

Se o usuário ainda não tiver um renderizador, Remotion é um bom padrão (npx create-video@latest). Qualquer ferramenta que escreva mp4, webm ou mov funciona.

2. Construa para que as edições sejam baratas

  • Mantenha cópia, cores, fontes e temporizações em um único objeto de dados (defaultProps do Remotion ou um content.ts), não espalhados pelos componentes. Assim, uma edição de feedback é uma alteração de uma linha.
  • Dê a cada elemento na tela um id estável e use o mesmo id em reel.json.
  • Envie a música como seu próprio arquivo. Renderize o vídeo apenas com efeitos sonoros. Coloque a faixa em assets/ e aponte audio.music para ela, e defina audio.videoAudio como "effects". O player toca a música junto com o vídeo, para que o usuário possa trocar faixas, mover o início e definir níveis sem re-renderizar. A Exportação deles mistura com ffmpeg.
  • Só incorpore a música no vídeo quando o usuário pedir. Então defina videoAudio como "mix".

3. Renderize e verifique antes de mostrar

Renderize, depois verifique seu próprio trabalho com uma folha de contato:

ffmpeg -v error -y -i video.mp4 -vf "fps=1,scale=480:-1,tile=4x3" -frames:v 1 /tmp/sheet.png

Abra a imagem e olhe para ela. Corrija texto cortado, quadros vazios, cores erradas e lacunas de temporização antes de abrir o player. Para um quadro:

ffmpeg -v error -y -ss 12.4 -i video.mp4 -frames:v 1 /tmp/frame.png

Auto-revisão. Depois olhe novamente como um revisor exigente faria e anote o que ainda vê. Verifique:

  • Área segura. Algo importante dentro de uma margem interna de 10% de cada borda (título seguro)?
  • Tamanho. Texto do corpo com pelo menos cerca de 3% da altura do quadro, para que seja legível em um telefone.
  • Contraste. Texto e formas-chave claramente separados do que está atrás deles.
  • Erros de digitação e estouro. Cada palavra escrita corretamente, nada cortado ou saindo de sua caixa.
  • Cortes e temporização. Sem quadros flash em um corte, sem quadros vazios, nada desaparecendo antes de poder ser lido.

Corrija o que puder. Para o que sobrar, ou para qualquer coisa que seja uma questão de gosto, adicione um achado a review em reel.json (seção 4). O player desenha cada um como um anel azul tracejado rotulado C1, C2… naquele quadro, e o usuário o adiciona como sua própria nota ou o descarta. Escreva apenas o que você realmente viu em uma captura de quadro: dê o tempo e o ponto ou elemento, para que o anel caia sobre ele. Deixe review vazio quando não houver nada a dizer; não o preencha.

4. Escreva reel.json

reel.json é o contrato entre você e o player. Escreva JSON simples (sem comentários).

{
  "id": "acme-lancamento",              // estável; as edições salvas do usuário são vinculadas a ele
  "title": "Lançamento da Acme",
  "version": 1,                     // incremente a cada render; o player recarrega quando muda
  "path": "/caminho/abs/para/projeto",   // onde você trabalha; mostrado no prompt
  "src": "video.mp4",
  "w": 1920, "h": 1080, "fps": 30, "duration": 32.0,
  "reference": "opcional: no que o vídeo é modelado",
  "brand": {
    "colors": [{ "id": "accent", "name": "Destaque", "v": "#5B5BF7" }],
    "fonts":  [{ "id": "head", "name": "Títulos", "v": "Inter" }],
    "logo": "assets/logo.svg"       // ou null
  },
  "audio": {
    "music": "assets/track.mp3",    // tocado junto com o vídeo, ou null
    "videoAudio": "effects",        // "effects" = vídeo tem apenas efeitos sonoros; "mix" = música está incorporada
    "bpm": 120, "drop": 4.0,        // grade de batida opcional; drop = segundos onde o drop cai
    "musicVol": 1, "sfxVol": 1,     // 0..1
    "musicOffset": 0,               // segundos; + inicia a música mais tarde, - pula na faixa
    "musicFade": 0,                 // segundos de fade-out no final
    "note": "texto livre"
  },
  "assets": [{ "id": "assets/track.mp3", "name": "track.mp3", "type": "audio", "from": "Usuário" }],
  "scenes": [
    { "id": "S1", "name": "Gancho", "t": [0, 4.5], "els": [
      { "id": "headline", "label": "Título", "t": [0.3, 4.3],
        "box": [20, 38, 60, 24],    // x, y, w, h em % do quadro; null para voz, áudio, filmagem em tela cheia
        "src": "src/Hook.tsx:12",   // o arquivo (ou arquivo:linha) que o desenha
        "props": {
          "text":   { "type": "text",   "label": "Texto",   "v": "Conheça a Acme" },
          "color":  { "type": "color",  "label": "Cor",  "v": "brand.accent" },
          "motion": { "type": "motion", "label": "Movimento", "v": "Palavras aparecem com desfoque uma por uma" }
        } }
    ] }
  ],
  "notes": [],
  "review": [                       // opcional: seus próprios achados de auto-revisão (seção 3)
    { "id": "v1-1", "t": 1.5, "elId": "headline", "kind": "área segura",
      "title": "Título encosta na borda direita",
      "detail": "Aos 1,5 s, a última palavra termina a 2% da borda, fora da área segura de título.",
      "fix": "Estreite a caixa para 56% ou reduza o tamanho em um passo." }
  ],
  "outputs": [                      // opcional: outras formas e durações que você fez a partir dele (seção 9)
    { "id": "vertical", "label": "9:16", "kind": "re-enquadrar", "src": "out/vertical.mp4", "w": 1080, "h": 1920, "platform": "reels" }
  ],
  "live": "live.js",                // opcional: renderizador ao vivo (seção 7)
  "export": { "cwd": "/caminho/abs/pasta/build", "props": {}, "cmd": "npx remotion render ... \"$OUT\" --props=\\

Habilidades Relacionadas