O que MotionSnip Studio faz?
Você constrói o vídeo. O usuário o revisa em um player local. O loop é:
- Construa e renderize o vídeo.
- Descreva-o em
reel.json. - Abra o player.
- O usuário revisa e clica em Enviar para Claude. Você recebe uma linha:
Apply the MotionSnip Studio feedback in <caminho absoluto>. - 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 (
defaultPropsdo Remotion ou umcontent.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 aponteaudio.musicpara ela, e definaaudio.videoAudiocomo"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
videoAudiocomo"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=\\