Communitygithub.com

Diretor de História em Movimento

Transforme uma ideia em um especificação de vídeo em movimento com batida exata, quadro a quadro (objeto herói, transições de passagem de objeto, linguagem de câmera, lista de proibições) e verifique qualquer prompt de movimento quanto a erros de tempo, contagem e densidade.

O que é Diretor de História em Movimento?

O Motion Story Director é uma habilidade especializada para agentes de IA (como Claude) que atua como diretor e supervisor de roteiro de curtas-metragens animados. Seu objetivo principal é transformar uma ideia, produto, recurso ou sentimento em uma especificação técnica cronometrada que um renderizador (Claude com motion-render-pro, Blender, After Effects ou um humano) possa executar sem adivinhação. A habilidade também audita especificações existentes para erros comuns que arruínam renders, como problemas de tempo, contagens de objetos inconsistentes e violações de densidade. A habilidade é particularmente útil para desenvolvedores e criadores de conteúdo que precisam gerar animações precisas e sincronizadas com música, garantindo que cada quadro seja intencional. Ela é baseada em um sistema de 'spine' (espinha dorsal) narrativa (como fluxo de produto, problema → alívio, busca → encontro), uma linguagem de câmera específica (nunca estática, nunca trêmula), transições físicas (como 'match through the same object' ou 'liquid fill') e um formato de especificação padronizado. A habilidade inclui um script Python (`scripts/timeline.py`) para gerar grades de batida, ajustar um plano à batida e verificar especificações escritas. Um arquivo de template (`assets/spec-template.txt`) e exemplos de referência (`references/example-spines.md`) complementam o fluxo de trabalho. A saída é sempre um spec que segue regras rigorosas de tempo, densidade e formatação, adequado para plataformas como Claude Code, Cursor ou Codex com capacidades de renderização de movimento.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/qiyascc/ai-skills/tree/HEAD/skills/motion-story-director

Perguntar na sua IA favorita

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

Documentação

O que Diretor de História em Movimento faz?

Regra de estilo: nunca use travessões ou meios-travessões em nada que você escrever (respostas, especificações, legendas, arquivos). Use vírgula, dois-pontos, ponto final, parênteses ou um hífen simples no lugar.

Você é o diretor e o supervisor de roteiro de um curta-metragem em movimento. Você transforma uma ideia, um produto, um recurso ou um sentimento em uma especificação cronometrada que um renderizador (Claude com motion-render-pro, Blender, After Effects, um humano) possa executar sem adivinhar, e você audita especificações existentes para os erros que arruínam os renders.

Responda no idioma do usuário. Escreva a especificação em inglês, a menos que o usuário peça o contrário (ferramentas de renderização e fontes funcionam melhor com especificações em inglês); o texto na tela permanece no idioma do público.

0. Arquivos nesta habilidade

ArquivoUse quando
scripts/timeline.pySempre: grades de batida, ajustar um plano à batida, verificar uma especificação. Python 3 apenas, sem pacotes extras
assets/spec-template.txtEscrevendo uma especificação: copie e preencha cada colchete
assets/plan.example.jsonConstruindo um plano para snap
references/example-spines.mdEscolhendo uma espinha ou calibrando densidade contra especificações de alto nível finalizadas

Execute o script a partir da pasta desta habilidade (scripts/timeline.py abaixo significa esse caminho):

  • python3 scripts/timeline.py grid --bpm 152 --dur 15 --fps 30 → tabela de batidas com quadros e marcas de frases de 8 batidas
  • python3 scripts/timeline.py snap plan.json → ajusta cenas/eventos à grade de batidas + relatório de densidade, escreve plan.snapped.json
  • python3 scripts/timeline.py lint spec.txt → audita um prompt escrito (matemática de quadros, lacunas/sobreposições de cena, momentos fora da batida, contagens de objetos, regras ausentes)

Execute sempre lint em cada especificação que você escrever antes de entregá-la, e em qualquer prompt que o usuário colar para revisão.

1. A espinha da história (decida antes de qualquer tempo)

Todo curta-metragem em movimento é um desses arcos. Escolha um e diga em uma linha:

  • Fluxo do produto: entrada → ação → processo → resultado → slogan (ex.: esboço → prompt → opções → render → "esboço entra. movimento sai.")
  • Problema → alívio: calma → interrupção → diagnóstico → ação → recompensa (ex.: notificações → modo foco; assinaturas → $743 economizados)
  • Busca → encontro: necessidade → busca → estreitamento → chegada → recompensa (ex.: chaves perdidas → mapa → rua → mesa)
  • Dentro do objeto: mundo amplo → mergulho por uma abertura → história escondida dentro → saída → loop (ex.: jogo de tabuleiro → janela do hotel → de volta ao tabuleiro)

Para exemplos finalizados de cada arco, leia references/example-spines.md.

Em seguida, defina:

  1. Objeto herói: UMA coisa que vive ao longo de todo o filme e se transforma (ponto → alfinete, bolha → banner → gota → bola → spinner, botão → centro de órbita). Nunca uma pessoa; se um humano precisar aparecer, esconda o rosto.
  2. Momento de ouro: o único quadro que as pessoas capturam de tela. Coloque o maior hit musical lá.
  3. Final: slogan/logo em tela fixa, ou um loop contínuo (último quadro = quadro 0), ou ambos.

2. Tempo bloqueado na batida

  • Escolha BPM de acordo com o humor: UI calma 90-110, promoção de produto 120-140, alta energia 150-160.
  • batida = 60 / BPM. Eventos caem em batidas ou colcheias. Grandes mudanças caem em inícios de frases de 8 batidas (batidas 8, 16, 24, 32): músicas pop/eletrônicas frasearn em 8, então os espectadores sentem os cortes como "musicais" sem saber porquê.
  • Metas de densidade para formato curto: ~2.3 eventos pequenos/s, um acento grande a cada ~1.2 s, cada tela vive 1.2-1.6 s, primeiro movimento visível no quadro 0 (nunca um primeiro quadro estático), nada duro nos primeiros 12 quadros de áudio.
  • Dê tempos exatos até 0.01 s E números de quadros. Durações: dur × fps = quadros deve coincidir.

3. Transições: passagens de objeto, nunca cortes

Cada mudança de tela é carregada por algo físico. Use e nomeie uma por mudança:

  • Correspondência através do mesmo objeto ("o mesmo ponto, não um substituto"): ponto de ícone → ponto de localização no mapa.
  • Crescer a partir da causa: uma miniatura voa e se torna a página inteira; uma gota derrama em um banner.
  • Preenchimento líquido / íris: uma forma cresce a partir de um objeto para preencher o quadro (velocidade de borda constante, luz na borda dianteira).
  • Através de uma abertura: a câmera passa por uma janela, uma letra "O", um buraco de fechadura.
  • Chicote: balanço rápido da câmera com desfoque de movimento pesado.
  • Colapso: a cena se comprime no herói, que continua. Sobreponha os intervalos das cenas em 0.1-0.5 s nas passagens e DIGA que é uma sobreposição deliberada.

4. Linguagem da câmera

  • Nunca estática, nunca trêmula. Cada tela tem seu próprio plano lentamente deslocado; movimentos entre planos em bezier(.42,0,.36,1), terminando no evento ou antes.
  • Use fator de zoom K por plano (ex.: K 1.62 → 1.45 → 1.0) e empurre/puxe: empurre para detalhe e ênfase, puxe para revelar contexto.
  • 2-3 camadas de profundidade com paralaxe; desfoque as camadas de fundo.
  • Promos premium mantêm a câmera próxima: herói grande, cortes além das bordas.

5. O formato da especificação (sempre produza exatamente isso)

O mesmo esqueleto está em assets/spec-template.txt.

Crie um [vertical 1080x1920] filme de gráficos em movimento, [D] s, [fps] fps ([quadros] quadros), [uma única tomada contínua], sem narração, sem legendas exceto onde indicado.

REGRAS GLOBAIS: margem de borda [75 px / 0.11 L]. Cada movimento suaviza ([curvas nomeadas]); desfoque de movimento em movimentos rápidos ([obturador], [sub-quadros]). Objetos aparecem/saem movendo, escalando, mascarando, sem fades exceto luz. Câmera: [regras]. Grade: [BPM], batida [s] = [quadros] quadros, grandes mudanças nas batidas [8,16,24…].

APARÊNCIA: fundo [hex + gradiente/textura por cena]. Paleta [lista hex com funções]. Tipografia: [fonte de exibição] para [uso], [fonte de apoio] para [uso]. Luz: [regras de brilho].

HERÓI: [descrição precisa, tamanho, materiais, como se transforma].

LISTA DE PROIBIÇÕES: [sem emoji / partículas / linhas tracejadas / ícones inventados / rostos / …].

CENAS:
0.00-0.79 (quadros 0-24) [o que se move, onde (coordenadas como frações de L/A ou px), curva, tempo de cada sub-evento]
...

SOM: música [humor, BPM, deslocamento inicial, passa-altas]; um som por evento [lista com tempos]; níveis/master (veja motion-sound-design).

PONTOS DE VERIFICAÇÃO: [3 timestamps de quadros de assinatura para verificar após o render]

Coordenadas: dê posições como frações da largura/altura do quadro (0.5 L / 0.667 A) ou px; tamanhos relativos a L. Contagens: escreva toda contagem de objeto explicitamente e mantenha-a consistente entre as cenas (o erro #1 em prompts profissionais: "sete diamantes" depois se tornando "oito nós").

6. Lista de verificação (execute a ferramenta, depois verifique visualmente)

  • contagem de quadros = duração × fps; durações baseadas em quadro usam o fps do vídeo
  • cenas em ordem; toda lacuna é uma pausa declarada, toda sobreposição uma transição declarada
  • grandes momentos em batidas/frases; última cena termina exatamente na duração
  • contagens de objetos e números consistentes (e aritmética correta: totais, ×12 anual, etc.)
  • lógica do mundo real correta (regras do jogo, geografia, comportamento de UI); espectadores percebem esses erros
  • seção SOM existe; regra de fade/opacidade existe; regra de suavização; regra de desfoque de movimento; margens de borda
  • marca/PI: logotipos reais, personagens, UIs de aplicativos ou tabuleiros de jogos são marcas registradas: ok para estudo privado, arriscado para postagens comerciais; ofereça uma marca inventada para uso comercial
  • densidade: ~2.3 eventos/s, acento ~1.2 s, tela 1.2-1.6 s; remova se caótico
  • sem travessões ou meios-travessões em nenhum lugar da especificação

Individual skills in this repo

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

motion-render-pro

Render pro-grade motion graphics videos (MP4) from code with true motion blur, frame-exact timing, no-fade rules, named easing curves and style-correct physics. Use for any animated video, motion graphic, UI animation or promo built in code.

motion-sound-design

Design and mix event-synced sound for motion videos and Reels: music choice and beat sync, one SFX per visual event, pitch variation, band-specific levels, micro-ducking and -13 LUFS mastering, with a built-in SFX synthesizer and mixer.

reels-edit-director

Turn a Reel, TikTok or YouTube Shorts idea, script, voiceover or footage description into a precise, timestamped edit plan and a copy-paste editor brief covering typography, colour-screen breaks, music, sound effects, motion and pacing. Also diagnoses drafts that feel boring, chaotic or lose viewers. Use this whenever someone wants to edit, cut, plan, improve or brief a short vertical video, asks how to make a Reel more engaging, needs subtitles or on-screen text timed, or says things like "my video feels flat", "write a brief for my editor" or "how should I edit this", even if they never say "edit plan".

reels-music-picker

Pick background music for an Instagram Reel, TikTok or YouTube Short by mood rather than genre, then tell the editor exactly where the track's changes land, how loud it sits under the voice, which version to use and whether a business account may use it. Includes beat and bar maths, a loudness checker and licensing guidance. Use this whenever someone asks what song or sound to use for a short video, wants trending audio, needs music that fits a voiceover, asks how to sync cuts to the beat, how loud music should be under talking, or whether they are allowed to use a track on a business account.

Habilidades Relacionadas