Communitygithub.com

motion-language

Mostra a um agente como planejar, construir ou editar uma "linguagem de movimento" para que o resultado final seja um texto ou roteiro utilizável. O procedimento percorre a Linguagem de Movimento, a única distinção que importa e o vocabulário. Use quando uma nova tarefa exigir essa arte.

O que é motion-language?

Esta skill fornece a um agente de IA um sistema completo para criar animações de movimento curtas e impactantes ("stingers") para vídeos explicativos ou conteúdo de cabeça falante. O cerne da skill é a distinção entre uma cena (que explica e carrega um argumento) e um stinger (que gestualiza uma ideia já ouvida, durando de 2 a 4 segundos). A skill define um vocabulário visual de cinco elementos (ground, glass, sheen, path, state) e uma biblioteca de tipos de stingers (como converge, overload, steps, swap) que podem ser combinados e usados em arquivos `composition.json`. A documentação detalha regras de design (como a animação de entrada escalonada entre 120-160ms e a proibição de loops), instruções para usar imagens externas (B-roll) ou citações, e faz referência a bibliotecas maiores de animação (hyperframes-animation e o block registry) para quando os stingers padrão não forem suficientes. A skill é implementada via scripts Python (`scripts/stingers.py`, `scripts/build_stinger_gallery.py`) e inclui verificações automáticas para validar a consistência visual e evitar defeitos comuns, como o uso incorreto de pseudo-elementos ou caminhos de arquivo quebrados.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/lucasaerb/workless-video-editor/tree/HEAD/skills/motion-language

Perguntar na sua IA favorita

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

Documentação

Linguagem de Movimento

Herda de skills/00-house-rules/SKILL.md. A implementação está em scripts/stingers.py; a galeria que renderiza tudo está em scripts/build_stinger_gallery.py.


A única distinção que importa

Uma cena explica. Um stinger gestualiza.

cenastinger
duração8–15s2–4s
carregaum argumento que precisa ser lidouma ideia que você já ouviu
faceoculta ou PiPoculta — você corta PARA ele
quantidade3–6 em um vídeo de 10 minutosum a cada 20–40s
se removê-loo ponto deixa de ser compreendidoo vídeo fica mais chato, não errado

Errar isso é a falha comum. Uma lista de três itens com conteúdo real é uma cena compare; a mesma lista como steps é decoração. Se o espectador precisar ler, não é um stinger.

Stingers são cortados para, não sobrepostos. Eles dominam o quadro por seus poucos segundos. Um gráfico em tela cheia com o orador ainda visível atrás parece um erro, e 3 segundos sem o rosto dele não custam nada.


O vocabulário

Cinco elementos. Tudo na biblioteca é uma combinação deles, que é o que faz animações não relacionadas serem lidas como um sistema único.

groundQuase preto com uma elevação radial suave. Nunca #000 puro — um quadro preto verdadeiro parece uma falha, não um design.
glassPreenchimento translúcido ~4.5% de tinta, borda de 1px ~14%, raio 26. A profundidade vem da borda e de um destaque interno, nunca uma sombra projetada no cartão.
sheenUm brilho especular de baixo ângulo sobre um cartão quando ele se estabiliza. Este é o movimento característico — é o que faz um retângulo plano parecer um objeto físico.
pathCurvas tracejadas finas com ~10% de tinta. As coisas viajam ao longo dos caminhos. Nada teletransporta.
stateUma linha de pequenos pontos carregando o estado do sistema. Mudança de cor nessa linha diz "e então quebrou" sem uma palavra de texto.

O escalonamento de entrada é de 120–160ms. Abaixo de 100ms, os elementos irmãos são lidos como um único objeto; acima de 200ms, o espectador começa a esperar.

Cada stinger mantém seu último quadro. Ele é cortado contra a fala, portanto terminar em qualquer quadro após o payoff deve ser seguro. Nada faz loop; nada termina em um palco vazio.


A biblioteca

{ "kind": "converge", "from": "tudo alimenta um único lugar", "dur": 3.4,
  "chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
kinda frase à qual pertencedur
converge"Tudo isso alimenta um único lugar." Chips viajam por caminhos tracejados até um núcleo brilhante; os pontos de estado se preenchem conforme ele assume a carga.3.0–3.6
overload"E então parou de funcionar." O mesmo núcleo racha em vermelho. Compartilha a geometria de converge para que os dois sejam cortados juntos como uma única história.2.4–3.0
steps"Existem três desses." Cartões de vidro numerados, escalonados, brilho em cada um. O mais reutilizável e o mais usado em excesso.2.6–3.2
swap"Isso, não aquilo." A é riscado e se aposenta para cima; B chega abaixo dele. Ambos permanecem legíveis.3.0–3.6
countup"Era quarenta e três por cento." Um número sobe, o tamanho crescendo com o valor, sobre uma linha de origem visível.2.6–3.4
beatsTrês frases curtas, percussivas. Cada uma recebe uma entrada diferente em uma grade de batidas compartilhada.2.4–3.2
surround"Você está enterrado em ferramentas." Chips rotulados circundam um centro mantido e depois se fecham. O centro nunca se move.3.2–4.0
photoUma imagem encontrada, tratada. Cartão de vidro, Ken Burns lento, legenda, linha de crédito.2.8–4.0
clipO mesmo cartão segurando filmagem em vez de uma imagem estática. Sem Ken Burns — ela já se move.2.4–3.0

Use-os em composition.json exatamente como uma cena — mesma ancoragem from / at / dur, mesmo erro grave se a frase não resolver.


B-roll: o stinger photo / clip

Dois tratamentos, e full escolhe entre eles. full é opt-in; omita-o e você obtém o cartão.

full: true — B-ROLLfull: false — CITAÇÃO
quadrosangria total, sem cartãocartão de vidro, brilho, deriva lenta
texto no quadroum terço inferior nomeando o que é a imagemlegenda e linha de crédito
origem no quadronuncaobrigatório
uso parafilmagens e imagens estáticas que carregam um momentouma captura de tela, um gráfico, uma página de preços, um documento

B-roll é tela cheia e não carrega referência de origem. Instrução permanente do humano, 14/08/2026. Ele ocupa todo o quadro da mesma forma que o B-roll faz em qualquer edição que alguém já assistiu. O único texto permitido sobre ele é um terço inferior dizendo o que a imagem é, nunca de onde veio. A atribuição ainda acontece — no _FINAL/ATTRIBUTION.md do drop, que fetch_stock.py escreve no momento do download e nenhuma edição pode pular. O Pexels e o Pixabay tornam o crédito no quadro opcional, portanto o ledger satisfaz a licença por si só e o quadro permanece limpo.

Isso substitui o parágrafo que costumava viver aqui para B-roll, que dizia que um clipe de sangria total "parece um vídeo diferente" e colocava tudo em um cartão. Esse raciocínio ainda vale para o caso de citação e apenas para ele: quando o espectador deve ler o ativo como evidência que você está citando, full: false e a linha de origem volta ao quadro.

O construtor ainda usa o cartão como padrão, e isso é deliberado. Inverter o padrão reataria silenciosamente cada cena photo já escrita contra ele — o working/stingers/plan.json do drop-005 entre elas — e uma especificação que renderizava um cartão ontem deve renderizar o mesmo cartão hoje. Trabalhos novos pedem "full": true; skills/executive-animator sempre faz. A mudança de uma palavra em st_photo é tudo o que é necessário se o cartão for um dia aposentado definitivamente.

Uma nota de geometria: sangria total usa object-fit: cover, então forneça uma origem que já seja 16:9. Um corte 2.19:1 mostrado em tela cheia perde 221px de cada lado, que é como um diagrama termina com sua primeira e última coluna cortadas enquanto cada porta reporta uma caixa correta.

Um construtor, dois nomes. photo para uma imagem estática, clip para filmagem; ele ramifica com base na extensão do arquivo, então o nome só existe para tornar uma especificação legível. O que realmente muda:

photoclip
elemento<img><video muted playsinline> com temporização do framework
Ken Burnssim, 1.00 → 1.07 sobre o cartãonenhum

A filmagem não recebe Ken Burns. O clipe fornece seu próprio movimento, e uma rampa de escala sobre movimento real é precisamente o que faz um estoque parecer estoque. Uma imagem estática é imóvel e precisa da deriva para permanecer viva; um clipe não precisa.

// B-roll. Tela cheia, terço inferior diz o que é, sem origem no quadro.
{ "kind": "clip", "from": "tudo está se movendo ao mesmo tempo", "dur": 3.0,
  "src": "broll/cut-data-flow.mp4", "caption": "Tudo se movendo ao mesmo tempo" }

// Citação. Um documento que o espectador lê como evidência, então o cartão e o crédito voltam.
{ "kind": "photo", "full": false, "from": "a página de preços mudou", "dur": 3.2,
  "src": "assets/pricing.png", "caption": "Preços da Anthropic, ago 2026",
  "credit": "ANTHROPIC.COM · BUSCADO 2026-08-13" }

O terço inferior fica em cap_left / cap_bottom, padrão de 96 / 186 — paisagem, que limpa os 96 à esquerda e 132 embaixo do youtube_long. Um chamador 9:16 deve passar seu próprio cap_bottom: reels reserva 520 na parte inferior e a banda de karaokê ocupa y 1150-1400, então o padrão paisagem coloca uma legenda sob a barra de progresso. Não há par que esteja certo em ambos os quadros.

src resolve relativo ao arquivo de especificação e o construtor o copia para o assets/ do projeto, portanto um caminho errado falha ruidosamente na construção em vez de como um cartão vazio. Obtenha ambos de scripts/fetch_stock.py, que imprime o bloco pronto para colar.

A atribuição é uma obrigação do ledger, não uma obrigação do quadro. Cada ativo de nível 3 recebe sua linha no _FINAL/ATTRIBUTION.md do drop, escrita por fetch_stock.py no momento do download — é o que config/broll-policy.md exige e não é opcional. Se o crédito também aparece no quadro é uma decisão de design, e para B-roll a resposta é não. Em um cartão de citação ele permanece, renderiza em WCAG AA, e uma atribuição que ninguém pode ler não é uma atribuição.

Resolva cada imagem na ordem de nível primeiro. Uma foto é nível 3: recorra a ela apenas quando sua própria filmagem e uma sobreposição de nível 2 genuinamente não tiverem nada. O Ken Burns é executado no <img> dentro do cartão de recorte, nunca no próprio cartão.

⚠ Não copie o padrão longo de inserção de vídeo de terceiros. A referência da qual esta linguagem veio tem 50 segundos de filmagem de entrevista de outra pessoa. config/broll-policy.md proíbe isso explicitamente, e nenhuma quantidade de bom design de movimento torna isso nosso. Fotos com atribuição são aceitáveis; pegar metade de um vídeo não é.


O menu mais amplo — o que usar quando nada acima se encaixa

Dois corpora upstream existem e ambos são maiores que esta biblioteca. Leia deles em vez de inventar movimentos.

Skill hyperframes-animation — 48 regras atômicas + 22 blueprints de cena. Carregue-a com Skill(hyperframes-animation), depois abra rules-index.md e leia a regra que você precisa em rules/<name>.md. O padrão da casa é compor 2–4 regras atômicas em uma linha do tempo pausada; um blueprint é para quando você quer uma tomada completa de 4 a 5 fases.

O registro de blocos — 373 blocos instaláveis: npx hyperframes catalog --query "<conceito>", depois npx hyperframes add <bloco>.

Situação → regra

Curado para um explicador de cabeça falante. Estas são as regras que sobrevivem ao nosso formato; o restante das 48 pressupõem principalmente uma UI de produto ou um cursor dirigido que não temos.

quando a frase é…regrapor que se encaixa
um número, uma estatística, uma porcentagemcounting-dynamic-scale, stat-bars-and-fillsjá implementado como countup; use as regras diretamente para barras, anéis, preenchimentos de estrela
uma lista incisiva, de ritmo rápidokinetic-beat-slam, waterfall-entryimplementado como beats; waterfall-entry é a cascata mais suave
uma definição ou um termo sendo apresentadogradient-text-sweep, depth-scatter-assembleos glifos nunca se movem na primeira; a segunda os monta a partir da profundidade
"aqui está o formato disso" (um diagrama)svg-path-drawo contorno se desenha sozinho. Meça com getTotalLength() na configuração
"está cercado / enterrado / conectado"radial-surround, avatar-cloud-network, orbit-3d-entryimplementado como surround; os outros dois adicionam linhas de conexão e entrada 3D
uma ideia substituindo outrascale-swap-transition, card-morph-anchor, morph-swapimplementado como swap; card-morph-anchor transforma o próprio contêiner
"olhe mais de perto para isso"depth-of-field-blur, coordinate-target-zoom, viewport-changefoco seletivo, ou uma câmera virtual em um wrapper .world
ênfase em uma palavra faladaasr-keyword-glow, css-marker-patternsbrilho sincronizado com timestamps de palavras — já temos tempos de palavras medidos
um acento percussivo fortechromatic-glitch, particle-burst, motion-blur-streakuse com moderação; no máximo um por vídeo
uma batida de aterrissagem calmatitlecard-reveal (blueprint), ambient-glow-bloommovimento baixo é o payload, não uma deficiência
qualquer entradaspring-pop-entranceo pop canônico. Em caso de dúvida, este

Blueprints que valem a pena conhecer

A maioria dos 22 são formas de anúncio de lançamento de produto. Quatro mapeiam o que realmente fazemos:

  • kinetic-type-beats — o cavalo de batalha. As palavras carregam a tomada, sem cenário, sem superfície.
  • dataviz-countup — quando os dados carregam o argumento.
  • comparison-split — duas capacidades pesadas ao mesmo tempo (nossa cena compare é uma prima simplificada).
  • titlecard-reveal — a batida de respiro, exatamente um movimento contido.

Pule cursor-ui-demo, device-surface-showcase, cta-morph-press, prompt-type-submit-generate e o resto da família de demonstração, a menos que estejamos realmente mostrando uma UI de produto. Eles são excelentes e não são nosso formato — um explicador de cabeça falante que de repente performa uma demo de aplicativo falsa parece um anúncio.

O contrato que toda regra upstream assume

Vale a pena saber antes de copiar uma, porque quebrar isso não falha na verificação — falha na renderização:

  • UMA linha do tempo GSAP pausada em window.__timelines. Nunca reprodução automática, nunca uma segunda linha do tempo.
  • Seguro para busca em ambas as direções — fromTo com estados from explícitos, valores absolutos, nunca += relativo. O estado deve ser uma função pura do tempo da linha do tempo.
  • Determinístico — sem Math.random(), sem Date.now(). Apenas pseudo-aleatório derivado de índice. Repetições finitas, nunca repeat: -1.
  • Apenas transformações e pintura. Tweens de width / height / top / left são proibidos; use proxies de escala/translado ou máscaras.
  • Escalonamentos de grupo limitados para que uma chegada seja lida como uma única batida — itens × escalonamento ≤ ~0.5s.
  • Pré-calcular constantes de layout. Nunca derivar uma posição no momento do tween; o renderizador amostra em paralelo e a medição dessincroniza.

Adicionando um novo conceito

  1. Pesquise o registro primeiro — npx hyperframes catalog --query "<conceito>". 373 blocos existem. radial-surround, morph-swap, split-tilt-cards e particle-image-reveal são primos próximos de coisas nesta biblioteca e podem ser um ponto de partida melhor do que código novo.
  2. Construa-o a partir dos cinco elementos acima. Um conceito que precisa de um sexto elemento é ou uma cena, ou um sinal de que o vocabulário precisa de uma extensão deliberada — não uma exceção.
  3. Adicione-o a KINDS em scripts/stingers.py.
  4. Renderize a galeria e olhe para todos juntos. Essa é a única maneira de saber se um novo se juntou à família ou apenas pousou ao lado dela.
python3 scripts/build_stinger_gallery.py <out> --photo <image>
cd <out> && npx hyperframes check
python3 scripts/probe_frames.py <out> --plan --grid sheet.png

Três defeitos que esta biblioteca já pegou

Cada um passou por uma verificação hyperframes check limpa antes de alguém olhar para um quadro:

  1. GSAP não consegue animar ::after. Ele resolve alvos com querySelector, que nunca retorna um pseudo-elemento, então todo brilho silenciosamente não fazia nada. O brilho agora é um elemento filho real (SHEEN_EL). Se você adicionar um cartão, coloque-o dentro.
  2. GSAP r…

… [truncado para tradução]

Individual skills in this repo

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

Habilidades Relacionadas