Communitygithub.com

storyboard-director (Diretor de Storyboard)

Constrói storyboards de produção onde cada batida registra texto, posição, visuais, movimento, som, tempo e sua ligação com o roteiro.

O que é storyboard-director (Diretor de Storyboard)?

O **Diretor de Storyboard** é uma skill especializada que transforma roteiros em storyboards de produção completos e rigorosamente estruturados. Diferente de um simples rabisco visual, cada 'batida' do storyboard deve conter campos obrigatórios como texto (narração e texto na tela), visuais descritivos, posicionamento exato com coordenadas normalizadas (0..1), movimento/câmera, som (incluindo silêncio deliberado), tempo em quadros a 60 FPS e a ligação direta com o roteiro original. A skill garante que todos os elementos sejam explícitos e codificáveis, eliminando ambiguidades como 'texto no meio' ou 'som aproximadamente'. Ela é útil para profissionais de animação, motion design, game design e produção de vídeo que precisam de um documento único e preciso para a equipe de produção. A skill opera sobre um template markdown, seguindo um workflow de 8 etapas, e impõe regras rigorosas de continuidade, legibilidade em mobile, uso de metáforas visuais e validação final com uma checklist de qualidade. O formato de saída inclui tabelas de batidas, mapeamento frase-para-imagem, folha de referência de áudio e especificação de cartão final personalizado, com suporte para assets marcados como PLACEHOLDER e listagem de requisitos de licenciamento.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/achmdfzn/motionforge-atelier/tree/HEAD/.claude/skills/storyboard-director

Perguntar na sua IA favorita

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

Documentação

DIRETOR DE STORYBOARD

Obrigatório

Um storyboard não é apenas uma lista de imagens. Cada cena e batida deve declarar: texto/narração, visuais, posição/layout, movimento, som e tempo. Use o template docs/templates/STORYBOARD_TEMPLATE.md.

Fluxo de Trabalho

  1. Feche o briefing, o formato vertical 1080×1920, 60 FPS, duração, público, bíblia de estilo e mensagem principal.
  2. Divida o roteiro em sentenças/batidas atômicas; atribua IDs estáveis (S01-B01, etc.). Não mescle sentenças diferentes sem motivo.
  3. Para cada batida, escreva o texto exato de VO, o texto exato na tela, o que é visível, o sujeito/ativo e a ação.
  4. Defina posições com coordenadas normalizadas 0..1 (x, y, w, h), âncora, alinhamento, camada/z-order, área segura e direção de leitura. Inclua tamanhos/posições em pixels quando necessário.
  5. Defina enquadramento, câmera, transições, movimento de entrada/saída, duração, quadro inicial/final e sobreposição.
  6. Grave áudio: clipe de VO, música, ambiência, SFX, quadro de sinal, duração, ganho relativo, fade e pausas/silêncio.
  7. Associe cada sentença de VO a um ou mais visuais/planos que esclareçam seu significado. Evite visuais literais repetitivos; use metáfora quando funcionar melhor.
  8. Valide continuidade, legibilidade em mobile, área segura, tempo e se a duração total corresponde.

Saída obrigatória por batida

  • ID, cena, quadro inicial/final, duração em quadros e segundos.
  • ID da sentença de VO + texto.
  • Texto na tela + posição.
  • Visual/ativo + composição e posição.
  • Movimento/câmera + easing.
  • Sinal de áudio: tipo, arquivo/placeholder, início/fim, nível relativo, fade.
  • Transição de entrada/saída e notas de continuidade.

Regras

  • Todo texto visível deve ser escrito literalmente, não "adicione um título".
  • Todas as posições devem ser explícitas, não "aproximadamente no meio".
  • Todo som deve ser registrado, incluindo a decisão de ter nenhum som/silêncio.
  • Não invente ativos que ainda não existam; marque-os como PLACEHOLDER e liste os requisitos do ativo.
  • Duração da batida a 60 FPS: durationInFrames = endFrame - startFrame com limite final exclusivo.
  • Um logotipo final + CTA é obrigatório e deve ser específico do vídeo, não genérico.

Convenções de ID e tempo

  • ID da batida: S<cena>-B<batida> com dois dígitos (S01-B01). Os IDs não mudam quando uma batida se move; uma batida inserida recebe um novo ID (S02-B03) em vez de renumerar tudo.
  • Intervalo semi-aberto [startFrame, endFrame): o quadro endFrame já pertence à próxima batida.
  • Converta de segundos apenas uma vez, em um só lugar: frame = round(segundos × fps). A partir daí, todo número no storyboard é um quadro inteiro.
  • Batidas consecutivas devem ser contíguas: o endFrame da batida N = o startFrame da batida N+1. Sobreposição só é permitida para janelas de transição registradas na coluna Transição.
  • Total: o endFrame da última batida = o durationInFrames da composição.

Formato de saída

  • Cabeçalho: ID do projeto, canvas, FPS, duração (segundos + quadros), caminhos para a bíblia de estilo e plano de áudio.
  • Tabela de batidas seguindo docs/templates/STORYBOARD_TEMPLATE.md.
  • Notas por batida para batidas complexas (movimento em múltiplos estágios, personagens, 3D).
  • Mapeamento frase-para-plano quando há VO, ou uma única linha "não aplicável — sem VO".
  • Folha de referência de áudio, incluindo silêncio intencional.
  • Especificação de cartão final personalizado.
  • Lista de ativos PLACEHOLDER com requisitos e status de licenciamento.

Checklist de QA

  • Cada batida tem um ID, quadro entrada/saída, texto literal (ou "—"), visual, posição normalizada, movimento, som e transição.
  • As batidas são contíguas a partir do quadro 0; a soma das durações = durationInFrames.
  • Texto importante está na área segura e pode ser lido em uma tela de telefone (tamanho, contraste, tempo na tela).
  • O texto permanece na tela tempo suficiente para ser lido; sentenças longas são divididas ou recebem mais tempo.
  • Cada sentença de VO tem um plano emparelhado; cada plano tem um propósito editorial.
  • O silêncio é escrito explicitamente, não deixado em branco.
  • O movimento é descrito como uma função do quadro (de/para, intervalo de quadros, easing), pronto para ser traduzido por frame-time-engineering.
  • O cartão final continua o motivo do vídeo e sua CTA é literal.
  • Todo ativo que ainda não existe está marcado como PLACEHOLDER.

Mini exemplo

Uma batida de gancho textual de 2 segundos:

ID da batidaQuadrosVOTexto na telaVisualPosiçãoMovimentoSomTransição
S01-B010–120—Por que seu vídeo parece genérico?Fundo escuro lisox .08, y .40, w .84; alinhado à esquerda; z 2Cada palavra entra a cada 10 quadros, slide-up 24 px, duração de 14 quadros, ease-outSilêncio 0–30, SFX-001 whoosh em 30corte

Movimento pronto para codificar: palavra i começa no quadro i × 10; opacity 0→1 e translateY 24→0 durante [i×10, i×10+14].

Modos de falha

  • "Texto aparece no meio" → não pode ser codificado; escreva x/y/w/h, âncora e alinhamento.
  • Batidas com diferença de um quadro (0–119 e depois 120–240) → a convenção exclusiva não foi usada; mude tudo para semi-aberto.
  • Texto alterado no código mas não no storyboard → o storyboard é a fonte da verdade para o texto; atualize o storyboard primeiro.
  • Duração total não corresponde à composição → recalcule a partir da tabela; não remende no código.
  • Visuais muito literais por sentença → use uma demonstração, diagrama ou metáfora; registre o motivo.
  • Cartão final é um logotipo + "Siga-nos" → não personalizado; construa uma ponte visual a partir do motivo do vídeo.

Individual skills in this repo

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

Habilidades Relacionadas