Communitygithub.com

datassthou64-source/blue-motion-kit

Transforme áudio de narração de criadores em motion graphics visuais e pesquisados no estilo HyperFrames. Use quando houver um ou mais arquivos de áudio para um vídeo de criador e for solicitado a transcrever, analisar, pesquisar conceitos ou produtos online, construir ou revisar gráficos em movimento puros, visualizar localmente ou renderizar no estilo contínuo de gradiente azul.

O que é blue-motion-kit?

Este skill é uma ferramenta profissional para agentes de IA (como Claude Code, Cursor, Codex) que automatiza a criação de motion graphics visuais e factuais baseados em narração de criadores de conteúdo. Ele segue uma metodologia rigorosa: primeiro, a IA transcreve o áudio e identifica os beats semânticos; depois, pesquisa cada entidade nomeada (produtos, marcas, empresas, etc.) usando fontes oficiais, obtendo logotipos reais e capturas de interface; em seguida, adapta templates de motion graphics pré-aprovados (da biblioteca `library/scenes/` ou `library/patterns/`) para cada beat, respeitando as leis visuais de "visual primeiro, texto segundo" e "cada entidade nomeada merece um ativo real". O estilo visual é definido por um gradiente azul contínuo e regras detalhadas em `library/design.md`, que priorizam objetos reconhecíveis, transformações tangíveis (dividir, copiar, sincronizar, etc.) e proíbem legendas, cards de texto genéricos ou ativos fabricados. O skill suporta todo o fluxo de trabalho: transcrição com timestamps, pesquisa online, storyboard, preview local, e exportação via scripts Python que geram arquivos MP4 e XMLs de timeline compatíveis com Premiere e DaVinci Resolve. Ele é ideal para criadores que querem motion graphics pesquisados e consistentes sem intervenção manual repetitiva.

Funciona com✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/datassthou64-source/blue-motion-kit/tree/HEAD/.claude/skills/blue-motion

Perguntar na sua IA favorita

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

Documentação

Gráficos em Movimento Blue

Construa uma explicação visual factual para a narração. Priorize objetos reconhecíveis, linguagem visual de produtos, logotipos oficiais e transformações em vez de legendas ou cards de texto abstratos.

Carregue /motion-visual-sourcing primeiro. Ele possui as duas leis das quais este estilo depende — visual primeiro, texto segundo (apague cada palavra; a ideia ainda deve ser compreendida) e cada entidade nomeada ganha um ativo real e com fonte (busque o logotipo verdadeiro, a UI real ou uma captura de site para qualquer empresa, produto, site ou repositório que a narração mencionar — nunca uma caixa genérica ou o nome como texto simples). O gradiente azul deste skill governa a aparência; aquelas leis governam o que vai para a tela.

Onde tudo está

Todos os caminhos abaixo são relativos a KIT, a raiz do repositório blue-motion-kit. bash <pasta deste skill>/scripts/kit-root.sh mostra o caminho (ele resolve links simbólicos, então está correto quer o skill tenha sido carregado do repositório ou através de um link).

CaminhoO quê
library/design.mdA única especificação visual — paleta, tipografia, objetos, verbos de movimento, regras de honestidade e o mapa de cena argumento → forma. Vence qualquer conflito. Leia antes de storyboard.
library/scenes/13 templates orientados por configuração da construção aprovada do Grok Bot. Copie o .html + .motion.json para compositions/ e edite o bloco CFG no topo do <script>; a geometria é regenerada a partir dele.
library/patterns/Os primitivos estáticos anteriores. Ainda válidos.
library/PATTERNS.mdÍndice de ambos.
library/assets/logos/Marcas oficiais congeladas e verificadas (Grok, Grok Bot, xAI, X, Cursor, Claude, Slack, Instantly, HeyReach, HubSpot, GitHub…). SOURCES.md é a tabela de proveniência. Verifique aqui antes de buscar.
reference/grok-bot/A construção de referência aprovada: fonte das cenas, folhas de contato e duas renderizações finais. Olhe, não copie por inteiro.
brand/creator.mdQuem assiste e como o criador fala.
KIT/editor.local.mdPreferências do editor desta máquina, da entrevista de primeira execução (pasta de projetos, NLE, portões de aprovação). Leia se existir.
references/build-recipe.md (este skill)O contrato de composição e os bugs que passam na verificação check. Leia ao criar ou depurar.
references/scene-patterns.md (este skill)Dispositivos construídos manualmente que não são templates.
scripts/ (este skill)bootstrap-project.sh (novo projeto), render_passages.py (exportação), hlg_to_sdr.py (correção de filmagem HDR), fetch-logo.py (resolvedor de logotipos), kit-root.sh.

Um template fornece a coreografia, easing, paleta e segurança de busca. Ele não fornece nada sobre se é a ideia certa para este beat. Altere o texto e a metáfora para corresponder ao que foi realmente dito; pesquise novamente cada produto recém-nomeado e use seus ativos oficiais atuais. Nunca envie a marca placeholder de um template.

Fluxo de trabalho

  1. Leia brand/creator.md e editor.local.md se presente.

  2. Use os skills obrigatórios HyperFrames, motion-graphics, media-use e CLI.

  3. Inspecione apenas o áudio fornecido. Ignore trabalhos anteriores para aquele áudio, a menos que o editor peça explicitamente para reutilizá-lo.

  4. Estruture o projeto: bash SKILL_DIR/scripts/bootstrap-project.sh PROJECTS_DIR/<video-slug> AUDIO... (PROJECTS_DIR vem de editor.local.md; padrão KIT/projects). Ele copia o starter, gradiente, logotipos e ambas as gerações de templates, e imprime a duração de cada arquivo de áudio.

  5. Transcreva cada arquivo com timestamps de palavras (npx hyperframes transcribe assets/audio-01.<ext> --dir . ou o caminho atual de media-use). Leia para verificar e corrija erros óbvios de nomes próprios (Clay, n8n, Instantly, HeyReach, Prospeo, Apify, Grok, Cursor, Claude Code, Codex, MCP).

  6. Para múltiplos arquivos, preserve os originais e coloque-os sequencialmente em uma única linha do tempo. Use ffprobe para offsets exatos.

  7. Transforme a transcrição em beats semânticos: intervalo de tempo, significado, assunto visual, ação e necessidade de pesquisa.

  8. Pesquise conceitos desconhecidos e branding atual do produto antes de desenhar. Prefira fontes oficiais, salve ativos resolvidos localmente e registre fontes em RESEARCH.md. Logotipos: python3 SKILL_DIR/scripts/fetch-logo.py --manifest logos.txt assets/logos, depois abra cada arquivo que ele retornar.

  9. Faça o storyboard do áudio completo antes de criar (STORYBOARD.md). Aponte para uma cena visual completa a cada 4–8 segundos. Se editor.local.md solicitar aprovação do storyboard, pare aqui e mostre-o.

  10. Coloque o vídeo com gradiente azul na linha do tempo pai, um clipe ininterrupto por passagem de motion graphics, e mantenha cada cena transparente para que o fundo nunca reinicie nos cortes.

  11. Adapte o padrão semanticamente mais correspondente. Não force um tópico em um template meramente porque ele existe.

  12. Execute npx hyperframes check, depois capture o frame de payoff de cada cena e observe as imagens. Bugs de geometria — um objeto pousando em coordenadas erradas, um elemento deslizando sobre outro — passam no check silenciosamente e só aparecem em um frame.

  13. Abra o preview local (npm run dev) e forneça a URL ao editor. Não renderize até que o editor aprove explicitamente (a menos que editor.local.md diga renderização automática).

  14. Após aprovação, exporte com o script padrão. Não execute uma renderização de linha do tempo completa.

    python3 SKILL_DIR/scripts/render_passages.py PROJECT_DIR
    

    Ele renderiza cada passagem de motion graphics para renders/MGNN-<label>.mp4. Ele converte qualquer filmagem HLG para SDR primeiro, e verifica cada arquivo para 1920×1080, 30 fps, contagem de frames, áudio e SDR BT.709. Em seguida, escreve premiere-cuts.xml, que coloca cada arquivo em sua posição real na linha do tempo da narração (importável no Premiere e DaVinci Resolve). Use --dry-run para listar passagens, --only 3,8 para re-renderizar algumas, e --xml-only para reconstruir o XML. Depois, observe um frame de cada arquivo; as verificações do script não conseguem ver uma camada ausente. Detalhes e porquê: references/build-recipe.md §7.

  15. Finalize com uma breve entrega: caminho do projeto, as renderizações, o XML e quaisquer ativos que você não pôde verificar.

SKILL_DIR é a pasta deste skill: KIT/.claude/skills/blue-motion.

Velocidade e disciplina de tokens

  • Reutilize o gradiente exato, tokens de estilo e primitivos de cena verificados.
  • Pesquise apenas substantivos que afetam visuais factuais: produtos, logotipos, interfaces, fluxos de trabalho ou objetos físicos.
  • Prefira uma fonte autoritativa para um fato simples; adicione mais apenas quando ambíguo.
  • Mantenha BRIEF.md, RESEARCH.md e STORYBOARD.md compactos.
  • Reutilize geometria precisa para laptops, janelas de repositórios, tiles de aplicativos e rotas.
  • Mostre snapshots ou o preview local em vez de narrar escolhas CSS.

Inegociáveis

A aparência e as regras de honestidade são library/design.md §9–10: sem câmera no rosto, sem legendas ou cards de frases, etiquetas de 1–3 palavras, marcas reais com fonte em placas, e nada fabricado. Além disso:

  • Telas de laptop permanecem próximas a 16:9 e dispositivos finalizados nunca pulsam ou mudam de dimensões.
  • Objetos em movimento viajam continuamente. Não pause no meio a menos que a narração descreva uma parada. Use movimento ping-pong suave para ideias de vai e vem.
  • Faça cada cena uma ideia visual dominante com uma mudança de estado clara, usando um verbo tangível: dividir, copiar, sincronizar, puxar, empurrar, pesquisar, montar, rotear, desbloquear, comparar, transformar.

Modificando o Kit em si

Uma nova regra durável (um estilo, um ativo padrão, uma nova armadilha) vai para seu único lar — aparência em library/design.md, armadilha/procedimento neste skill, fatos do criador em brand/creator.md — nunca para as notas de um projeto ou a memória do agente. Em seguida, faça commit para que todo editor receba (veja CONTRIBUTING.md na raiz do kit).

Individual skills in this repo

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

Habilidades Relacionadas