Communitygithub.com

Motion Director

Use quando o usuário pedir para criar, revisar ou renderizar um vídeo curto – um vídeo explicativo, promoção de produto ou anúncio, demonstração de software, gráfico em movimento, cartão de título, gráfico animado, clipe para redes sociais. Define o visual com o usuário (ou a partir de um estilo que ele fornece: um pacote de design, um site, capturas de tela, uma frase), escreve um roteiro de movimento, constrói uma composição HyperFrames, visualiza e corrige, e renderiza um MP4.

O que é Motion Director?

Motion Director é uma skill para agentes de IA (como Claude Code, Cursor, Codex) que capacita o usuário a criar vídeos curtos e dinâmicos diretamente a partir de descrições ou estilos de referência. A skill utiliza a biblioteca HyperFrames, que converte composições HTML + GSAP em arquivos MP4, permitindo que o agente escreva e ajuste a composição do vídeo de forma autônoma. O fluxo de trabalho é completo: desde entender o objetivo do vídeo e definir o visual (com diferentes níveis de envolvimento do usuário), passando pela elaboração de um roteiro de movimento detalhado, construção e visualização da composição, até a renderização final e até mesmo a criação de um GIF otimizado. É particularmente útil para desenvolvedores e criadores que precisam de prototipagem rápida de vídeos explicativos, demonstrações de software, clipes promocionais e conteúdo para redes sociais, sem precisar de ferramentas profissionais de edição de vídeo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PilCAki/motion-director/tree/HEAD/plugins/motion-director/skills/make-video

Perguntar na sua IA favorita

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

Documentação

O que Motion Director faz?

Você dirige e constrói um vídeo curto. HyperFrames renderiza HTML + GSAP para MP4. Você escreve essa composição por conta própria, da forma que funcionar para este vídeo.

Fluxo de trabalho

  1. Entenda a solicitação. Para que é o vídeo, quem assiste, duração, proporção de tela. Pergunte apenas sobre o que a solicitação deixar em aberto.

  2. Defina o visual. Se o usuário forneceu um estilo (um pacote de design, um site, capturas de tela, uma frase), trabalhe a partir dele e não pergunte. Caso contrário, ofereça o nível de envolvimento desejado:

    • Você decide.
    • Descreva resumidamente. Eles dão uma ou duas frases; você preenche o restante.
    • Designer de tema. Combine cores, fontes e formas; mostre um ou dois quadros de estilo para aprovação.
    • Designer de storyboard. Mostre quadros de exemplo para cada batida; combine tamanhos, posições e movimento batida por batida.

    Independentemente de como chegar lá, o visual deve estar definido o suficiente para decidir cada escolha visual. Anote da forma que for mais adequada para você.

  3. Escreva o roteiro de movimento em motion-script.md (obrigatório). Escreva as batidas em ordem temporal: o que está na tela, o que se move e como, e quando. O formato fica a seu critério.

  4. Construa a composição HyperFrames. Leia references/hyperframes-quirks.md primeiro. Ele lista os fatos que causam quadros errados ou falhas na renderização.

  5. Visualize, veja, corrija. Capture quadros em cada batida e compare-os com o roteiro de movimento e o visual. Verifique o tamanho de tudo no tamanho em que o vídeo será assistido: tudo visível e legível, nada grande demais ou pequeno demais. Corrija e recapture até que estejam certos.

  6. Renderize, depois extraia quadros do MP4 nos seus tempos de visualização e compare-os com as prévias. A renderização busca de forma diferente da captura de quadros, então os dois podem discordar.

    Se o usuário quiser um GIF (para um README, um chat, qualquer lugar onde o vídeo não seja reproduzido automaticamente), crie-o a partir do MP4 com o palette de dois passos do ffmpeg (palettegen, depois paletteuse) em uma largura e taxa de quadros que o mantenham pequeno, e também veja um quadro dele.

  7. Entregue o caminho do MP4 (e o do GIF, se tiver criado um), com uma breve nota sobre o que você fez e o que assumiu.

Habilidades Relacionadas