Communitygithub.com

datassthou64-source/blue-motion-kit

As duas leis fundamentais para todo motion graphic do HyperFrames: (1) visual primeiro, texto depois e (2) toda entidade nomeada na narração merece um ativo real e verificado na tela. Use ao construir ou revisar qualquer motion graphic, storyboard ou cena a partir de narração, quando o locutor citar uma empresa, produto, ferramenta, site ou repositório GitHub, ao decidir o que vai na tela para uma linha, quando uma cena estiver deslizando para cartões de texto ou listas com marcadores, ou ao buscar logotipos, UI de produto ou capturas de site. Aplica-se em todo fluxo de trabalho do HyperFrames.

O que é blue-motion-kit?

Este skill define as duas leis fundamentais que governam a criação de motion graphics no HyperFrames: (1) visual primeiro, texto depois e (2) toda entidade nomeada na narração merece um ativo real e verificado na tela. A primeira lei enfatiza que motion graphics são imagens em movimento, não slides com animação — o visual deve comunicar a ideia mesmo sem palavras, cabendo ao texto apenas um papel de suporte. A segunda lei determina que quando a narração menciona qualquer entidade que existe online (empresas, produtos, ferramentas, sites, repositórios GitHub), o skill obriga a buscar o ativo real (logotipo, captura de tela, etc.) e colocá-lo na tela, nunca usando um placeholder genérico ou texto simples. O skill fornece comandos práticos como `fetch-logo.py` para resolver logotipos e `npx hyperframes capture` para capturar páginas reais, além de orientações sobre verificação manual, proveniência, legalidade e integração com o workflow de source selection, storyboard, construção e revisão. Ele é aplicável a qualquer fluxo HyperFrames e suporta todos os workflows da plataforma.

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

Perguntar na sua IA favorita

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

Documentação

Visual primeiro. Texto depois. Todo nome merece um ativo real.

Duas leis. Elas se aplicam a toda cena e todo fluxo de trabalho.


Lei 1 — Visual primeiro, texto depois

As pessoas não leem. Elas escaneiam. Um motion graphic é uma imagem que se move, não um slide com animação em cima dele. O mecanismo carrega o significado; as palavras apenas o rotulam.

O teste, aplicado a cada cena antes de construí-la:

Apague toda palavra do quadro. A ideia ainda se sustenta? Se não, o visual ainda não está cumprindo seu papel — corrija o visual, não adicione palavras.

O texto é um elemento de suporte. Ele nomeia o que o espectador já está vendo. Ele nunca carrega uma afirmação que a imagem já não faça.

Faça

  • Mostre o mecanismo em movimento: rota, transformação, preenchimento, contagem, ordenação, convergência, ramificação.
  • Use logotipos reais, UI de produto real, telas reais como evidência.
  • Um rótulo curto por objeto principal — 1–3 palavras.
  • Um número herói, apenas quando a narração o pronunciar.

Não faça

  • Cole a narração na tela. Legendas têm no máximo duas linhas, nunca parágrafos.
  • Monte uma lista com marcadores, um cartão de agenda ou uma parede de cartões de texto. Uma lista é uma constelação ou um hub convergente, não marcadores empilhados.
  • Use um cartão de texto porque a ideia foi difícil de visualizar. Esse é o momento de trabalhar mais no visual, não de desistir e digitar.
  • Deixe um rótulo afirmar algo que o mecanismo não mostra.

Proporção de atenção: reserve aproximadamente 80% do seu esforço de construção no objeto em movimento e 20% no texto. Se você gastou ao contrário, a cena está errada.


Lei 2 — Toda entidade nomeada merece um ativo real e verificado

Quando a narração nomear qualquer coisa que exista online — uma empresa, um produto, uma ferramenta, um site, um repositório GitHub, um modelo, um framework — vá buscar a coisa real e coloque na tela.

Entidades nomeadas são evidência. Um espectador que ouve "Clay" e vê a marca real da Clay acredita em você. Um espectador que ouve "Clay" e vê a palavra "Clay" em Inter não acredita.

Nunca desenhe uma caixa genérica, invente uma marca, aproxime um logotipo de memória ou deixe o nome como texto simples quando existe um ativo real.

O que buscar, em ordem de valor

Entidade nomeadaObtenha isso
Uma empresa ou ferramentaSeu logotipo real em cores completas
Um produto com UIUma tela real daquela UI, mais o logotipo
Um siteUma captura do site real — npx hyperframes capture <url>
Um repositório GitHubO avatar/marca do próprio repositório, e o README ou superfície do repositório
Um modelo / frameworkA marca do fornecedor (Anthropic, OpenAI, …)
Uma pessoaSomente com um ativo fornecido. Não raspe a foto de alguém.

Como buscar

Verifique a biblioteca congelada primeiro. Marcas verificadas vivem em library/assets/logos/ (proveniência em seu SOURCES.md). Nunca reobtenha o que já está congelado e verificado.

Logotipos — use o resolvedor, não caçe manualmente:

cat > logos.txt <<'EOF'
clay      clay.com
anthropic wikipedia:Anthropic
linkedin  commons:LinkedIn icon
acme      https://acme.com/press/logo.svg
EOF
python3 KIT/.claude/skills/blue-motion/scripts/fetch-logo.py --manifest logos.txt <project>/assets/logos

Escada: URL explícita → Wikipedia → Wikimedia Commons → o próprio ícone do app do site → simple-icons → favicon. Prefira as quatro primeiras; simple-icons é monocromático e a maioria dos estilos padrão quer cores completas.

Sites e superfícies de produto — capture a página real:

npx hyperframes capture https://<site> --json --max-screenshots 12

As capturas de tela vão parar localmente como cenas em camadas com ativos baixados. Trate uma saída não zero, ok:false ou um BLOCKED.md como uma parada obrigatória — nunca infira o design de uma marca a partir de uma captura parcial.

Verifique antes de construir — sempre

  • Abra cada ativo que voltar. Um logotipo errado é pior do que nenhum logotipo.
  • O buscador avisa abaixo de 6 KB, e uma busca no Commons pode retornar algo próximo (empresa errada, marca antiga, arte de fã). Olhe para ele.
  • Prefira a marca atual. Empresas mudam de marca; a Wikipedia fica desatualizada.
  • Registre a proveniência. fetch-logo.py anexa a assets/logos/SOURCES.md automaticamente — mantenha-o.

Mantenha local e legal

  • Copie cada ativo para o próprio assets/ do clipe. Sem CDN, sem rede no momento da renderização, jamais.
  • Marcas de terceiros são usadas de forma nominativa — para se referir à coisa sendo discutida. Não reestilize um logotipo, implique endosso ou use uma marca como sua própria identidade visual.
  • Se nenhum ativo real puder ser encontrado ou verificado, diga isso e use o visual da classe de objeto. Não invente uma marca para preencher o buraco.

Onde isso impacta no fluxo de trabalho

  1. Seleção de fonte — para cada janela, registre quais entidades a linha nomeia. Essa lista é o manifesto de busca. Uma janela nomeando uma entidade sem ativo planejado é uma seleção incompleta.
  2. Storyboard — cada quadro declara sua tese visual e os ativos reais de que precisa. Se a tese de um quadro só é expressável como uma frase na tela, repense o quadro.
  3. Construção — ativos vão em assets/, referenciados localmente, verificados a olho.
  4. Revisão — aperte os olhos para a captura. Se você só consegue dizer o que a cena significa lendo, a Lei 1 está quebrada. Se uma marca nomeada aparece como texto simples, a Lei 2 está quebrada.

O estilo padrão ainda vence

Estas leis regem o que vai na tela. Como fica é library/design.md: busque o ativo real, então encene-o no estilo padrão (em uma bandeja, sob a vinheta de poço profundo, dentro de um cartão de vidro).

Individual skills in this repo

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

Habilidades Relacionadas