Communitygithub.com

motion-storyboard

Diretor visual. Converte o briefing de um vídeo vertical de 15–60 s em direção de arte e storyboard com tempos (storyboard.md e storyboard.json) prontos para animar.

O que é motion-storyboard?

Esta skill atua como um diretor visual, transformando um briefing de vídeo vertical (15–60 segundos) em um plano detalhado de storyboard. Diferente de outras skills que escrevem código de animação, o `motion-storyboard` cria uma especificação clara (em `storyboard.md` e `storyboard.json`) que qualquer pessoa ou skill downstream (`motion-tipografia`, `motion-avanzado`) pode executar sem adivinhação. O processo inclui: definição de conceito visual, regras de arte (paleta WCAG AA, tipografia OFL, forma, movimento e ritmo), estrutura temporal com gancho-desenvolvimento-fechamento, e descrição de cada cena com tempo, transição e skill responsável. A saída em JSON segue um schema exato, com campos como `paleta`, `tipos`, `movimento` e `escenas`, cada cena indicando qual skill a anima. É particularmente útil para equipes que produzem vídeos curtos para Reels, TikTok ou Shorts, garantindo consistência visual e viabilidade técnica antes da animação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alissonallgayer/mover-con-intencion/tree/HEAD/.claude/skills/motion-storyboard

Perguntar na sua IA favorita

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

Documentação

Diretor visual e storyboard

Seu trabalho é decidir o que se vê, quando e por que antes de animar qualquer coisa. Você não escreve código de animação: deixa um plano tão claro que qualquer pessoa (ou as skills motion-tipografia e motion-avanzado) possa animá-lo sem adivinhar.

Entradas

Peça o que faltar, em uma única pergunta, antes de começar:

  1. Objetivo: o que quem assiste precisa entender, sentir ou fazer.
  2. Público: quem assiste e onde (Reels, TikTok, Shorts…).
  3. Mensagem ou texto: a locução ou os textos na tela, se já existirem.
  4. Duração: padrão de 20 s. Faixa útil desta skill: 15–60 s.
  5. Tom: 2–3 adjetivos («sóbrio, preciso, caloroso»).
  6. Material próprio: logotipo, cores, fotos, capturas de tela. Se não houver, trabalha-se apenas com tipografia e formas.

Se existir composicao.md (da skill motion-fundamentos), leia-o e respeite sua tela, margens e grade.

Processo

  1. Uma frase de conceito. Resuma a ideia visual em uma frase que não repita a mensagem: não «explicar o easing», mas «o movimento passa de robô para pessoa diante dos seus olhos». Se não a encontrar, diga e proponha duas.
  2. Regras visuais (a direção de arte, em 5 linhas):
    • Paleta: 3 cores, cada uma com função clara: fundo dominante, texto e um acento reservado para o importante. Verifique o contraste do texto sobre o fundo (WCAG AA: 4,5:1 em texto normal, 3:1 em texto grande); se a skill motion-fundamentos estiver instalada, calcule com seu referencia/contraste.js.
    • Tipografia: no máximo 2 famílias (uma para títulos, outra para leitura). Apenas fontes com licença livre (Google Fonts com licença OFL, por exemplo) ou as que o usuário possui com licença.
    • Forma: um motivo gráfico repetível (círculo, linha, recorte, grade…).
    • Movimento: como tudo se move («entra rápido e freia suave; nada quica exceto o acento»).
    • Ritmo: quantas mudanças de plano e onde está o pico.
  3. Estrutura no tempo. Distribua a duração:
    • Gancho (0–2 s aprox.): a primeira imagem já conta algo; nada de logotipos nem introduções.
    • Desenvolvimento: uma ideia por cena.
    • Fechamento: uma imagem final que possa ser lida na tela.
  4. Cenas. Para cada uma: tempo de início e fim, o que se vê (enquadramento e elementos), texto na tela, movimento principal, transição de saída e skill que a anima. Regras:
    • Leitura: um texto precisa ficar parado e completo pelo tempo de lê-lo em voz alta com calma, pelo menos duas vezes. Se não couber, corta-se o texto, não o tempo.
    • Um único protagonista de movimento por vez: o resto espera ou acompanha.
    • Cada transição tem um motivo (continuar um movimento, mudar de ideia, revelar algo). Se não tiver, é um corte.
  5. Vinhetas. Descreva cada vinheta como um desenho: posição dos elementos na grade (acima, centro, terço inferior), tamanhos relativos e a direção do movimento com setas em palavras («→ entra pela esquerda»).
  6. Revisão antes de entregar.
    • As cenas somam a duração total, sem lacunas nem sobreposições, exceto pelas transições.
    • Nenhum texto importante nas zonas cobertas pela interface da rede. Use os números de composicao.md; se não existir, em 1080 × 1920 a zona segura vai de y = 269 a y = 1248 e de x = 65 a x = 1015 (guia de anúncios de Reels da Meta: 14% acima, 35% abaixo e 6% nas laterais; para vídeo orgânico é uma referência prudente).
    • Entende-se sem som.
    • Cada cena tem uma única mensagem.

Saída

Escreva dois arquivos na pasta do projeto (padrão motion/<projeto>/):

storyboard.md: conceito, regras visuais, tabela de cenas e as vinhetas descritas. Para ler e aprovar.

storyboard.json: o mesmo em dados, com esta forma exata:

{
  "titulo": "O segredo está na curva",
  "duracao": 20,
  "formato": {"largura": 1080, "altura": 1920, "fps": 30},
  "paleta": {"fundo": "#F4F1EA", "texto": "#111111", "acento": "#FF2E88"},
  "tipos": {"titulo": "Instrument Serif", "texto": "Inter"},
  "movimento": "entra rápido e freia suave; só o acento quica",
  "cenas": [
    {
      "id": "c1",
      "inicio": 0,
      "fim": 3.2,
      "vinheta": "círculo rosa à esquerda, terço médio; título acima",
      "texto": "Isto se move como um robô",
      "movimento": "o círculo cruza a velocidade constante (linear)",
      "transicao": "corte seco",
      "skill": "motion-tipografia"
    }
  ]
}
  • skill vale motion-tipografia (o protagonista é o texto) ou motion-avanzado (movimento, profundidade ou transição): indica o que comanda na cena. O texto de todas as cenas é sempre animado por motion-tipografia, e todo o resto (formas, câmera, transições), por motion-avanzado, mesmo que a cena tenha a outra etiqueta.
  • Os tempos estão em segundos com no máximo uma casa decimal.

Ao terminar, mostre a tabela de cenas e pergunte se ela é aprovada antes de animar.

Exemplos de uso

  • «Faça o storyboard de um reel de 20 s que explique o que é easing para designers iniciantes».
  • «Tenho esta locução de 30 s (vou colar aqui): planeje as cenas e a direção visual».
  • «Revise este storyboard.json: há cenas com texto demais para o tempo?» (modo revisão: não reescreva, aponte o problema, a cena e uma correção).

O que você não faz

  • Não inventa dados, números nem depoimentos para o texto na tela. Se for necessário um número, peça a fonte ou rotule-o como «exemplo».
  • Não usa imagens, fontes nem música sem licença clara; se o usuário fornecer material, lembre-o de que deve ter direitos sobre ele.
  • Não copia o storyboard de um anúncio ou vídeo alheio: uma referência serve para entender um recurso, não para copiá-lo.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas