Communitygithub.com

MBehtemam/montagent-skills

Cronometragem, easing e layout para qualquer vídeo Montagent: grades de batidas a partir da música, easing e durações de espera, áreas seguras, escala tipográfica, moderação. Carregue antes de julgar se uma peça parece correta.

O que é montagent-skills?

Este skill define os parâmetros numéricos precisos que sustentam qualquer peça Montagent, independentemente de sua função, formato ou taxa de quadros. Ele estabelece regras para sincronização com a batida musical (grade de batidas), durações e curvas de easing baseadas no papel do movimento, limites de velocidade para evitar vibração ou estroboscopia, e tempos de leitura mínimos para texto. O skill suporta plataformas como Claude Code, Cursor e Codex por meio da ferramenta Montagent, e é carregado automaticamente ao julgar a correção visual de uma peça. O documento SKILL.md atua como um guia de referência completo, abrangendo desde a detecção de tempo e cálculo de batidas até restrições de design como paletas de cores limitadas e um ponto focal por cena.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MBehtemam/montagent-skills/tree/HEAD/skills/montagent-craft

Perguntar na sua IA favorita

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

Documentação

Craft: cronometragem, easing e layout

Os números que sustentam cada peça Montagent, seja qual for sua função, formato ou taxa de quadros. Os tempos estão em milissegundos. Os tamanhos são frações do quadro, medidos em relação ao seu lado curto (a altura de um quadro largo, a largura de um quadro alto), para que se mantenham em qualquer tamanho e proporção. A receita de uma skill Job fornece seus próprios números para seu próprio movimento; dentro dessa receita, seus números prevalecem.

A verificação

Em cada etapa de verificação, confira os quadros que a etapa nomeia em relação a cada linha abaixo, e novamente o vídeo inteiro antes de renderizar. Julgue o que está no quadro, nunca o que você pretendia construir. Uma linha que você não pôde verificar a partir do que olhou conta como não verificada: olhe novamente.

  1. Na batida. Todo corte, entrada e mudança de seção está no quadro sorteado de sua batida, ou no máximo um quadro antes (Grade de batidas). query --from --to lista os cortes; compare-os com a grade.
  2. Dentro da área segura. Toda palavra está dentro da área segura para títulos, e todo rosto e produto dentro da área segura para ação (Áreas seguras). Para texto, query --at <t> --json fornece a caixa de tinta de cada elemento em pixels.
  3. Grande o suficiente. Nenhum texto destinado à leitura está abaixo de 3% do lado curto, e os níveis estão claramente separados (Tipografia).
  4. Legível. O texto contra o que está atrás dele atinge a taxa de contraste em Tipografia, em todos os quadros em que aparece. Sobre filmagens ou fotos, verifique o quadro mais claro e o mais movimentado.
  5. Um ponto focal. Em qualquer momento, uma coisa lidera: a mais nova, maior, mais brilhante ou acentuada. Tudo o mais foi embora, está parado ou está claramente atrás (Moderação).
  6. Suave. Em preview, nada estroboscópico, treme ou aparece como cópias de si mesmo (Limites de velocidade).
  7. Longo o suficiente para ler. Cada linha é mantida por seu tempo de leitura antes que qualquer coisa a mova (Esperas).
  8. O fim. O último quadro está completo e parado, e assim está há pelo menos 1 s. O som chega a 0 nesse quadro.

A verificação está concluída quando cada linha se sustenta em cada miniatura da folha de contato, e em cada quadro nomeado pela etapa. Corrija o que falha e depois volte para a etapa de verificação do montagent.

Grade de batidas

A música define o ritmo. Encontre o tempo e o primeiro tempo forte antes de posicionar qualquer coisa.

  • Tempo declarado no briefing ou nas notas do asset: use-o, com o tempo forte que ele declarar.
  • Tempo não declarado: execute python3 scripts/beat_grid.py <projeto> <especificação> (execute com --help para a especificação). Ele escuta a faixa, posiciona-a de modo que um tempo forte caia onde você deseja, e a desvanece no último quadro sorteado. Ele imprime o projeto na saída padrão, então redirecione para um novo arquivo, e a grade como JSON no erro padrão. Leia ambas as confianças: abaixo de 1,5, ou downbeat_by igual a first, a grade é um palpite. Forneça bpm (e downbeat) na especificação quando souber, e diga na sua entrega que a grade foi estimada.
  • Sem música: uma batida de 500 ms (120 BPM).

A aritmética:

  • Uma batida é 60000 / BPM ms, um compasso é quatro batidas, e uma frase é quatro compassos (às vezes oito).
  • Conte a partir do primeiro tempo forte, nunca somando. A n-ésima batida é downbeat + n × beat, então movida para seu quadro sorteado: floor(round(t * fps / 1000) * 1000 / fps). Somar uma batida arredondada repetidamente desvia um quadro a cada poucos compassos. measure --at confirma se um instante é sorteado.
  • A 90, 100 e 120 BPM, uma batida é um número inteiro de quadros a 30 e 60 fps (também 24 fps a 90 e 120, e 25 fps a 100). Em outros tempos, as batidas caem 14, 14, 15… quadros de distância. Isso é aceitável quando cada batida é contada a partir do tempo forte.

Onde as coisas vão:

  • Mudanças de seção em tempos fortes, e a maior virada da peça (a revelação, a marca) no primeiro tempo forte de uma frase.
  • Eventos principais nas batidas: um corte, uma palavra pousando, uma mudança de cor. Movimento secundário em meias ou quartas batidas: um acomodar, um escalonamento dentro de um grupo, um rótulo após sua barra.
  • Qual quadro está "na batida": um corte, um flash ou um pop está na batida em seu primeiro quadro. Um movimento com mais de meia batida, cuja chegada é o ponto, termina na batida.
  • Cedo, nunca tarde: espectadores notam uma imagem que atrasa em relação ao som a partir de cerca de 45 ms, que é um ou dois quadros. Um impacto um quadro antes é lido como na batida; um quadro depois é lido como atrasado.

Durações e easing

MovimentoDuraçãoQuadros a 30 fps
Um impacto: um quadro de flash, o impacto de uma batida, uma troca brusca70–130 ms (abaixo de 2 quadros parece uma falha)2–4
Um movimento pequeno: um pop, um empurrão, um rótulo aparecendo200–350 ms6–10
Um movimento padrão: um cartão entrando, um movimento por parte do quadro400–600 ms12–18
Um movimento pesado: uma revelação de herói, um grande impulso700–1000 ms21–30
Uma deriva: um zoom in, um flutuar lentotodo o tempo na tela
  • Saídas ocorrem a 60–70% da entrada que desfazem.
  • Escale itens em um grupo por 60–130 ms (2–4 quadros a 30 fps), e mantenha todo o escalonamento abaixo de 500 ms. Um grupo mais longo dá a cada item sua própria batida.
  • Curvas. Coisas que chegam desaceleram; coisas que partem aceleram; coisas se movendo entre dois lugares na tela suavizam em ambos os sentidos. Escolha uma curva por papel para a peça inteira e mantenha-a: a curva é parte da voz da peça.
PapelCurvaVelocidade de pico, × a média
Entrada com acomodação longa[0.16, 1, 0.3, 1]6.3
Entrada mais suave[0.25, 1, 0.5, 1]4.0
Pop com cerca de 10% de ultrapassagem[0.34, 1.56, 0.64, 1]4.6
Saídaease-in1.7
Entre dois lugares, transições, varreduras[0.65, 0, 0.35, 1]2.9
Rotação[0.3, 0.3, 0.5, 1]1.6
Deriva, fading de som, rotação constantelinear1.0

A coluna de pico alimenta a verificação de velocidade abaixo: o instante mais rápido de um movimento é sua velocidade média vezes esse número.

Limites de velocidade

Para um movimento rápido, defina motion_blur no elemento em movimento ("shutter": 180, "samples" 8–16) em vez de desacelerar o movimento. Não é padrão: coloque-o nos elementos que se movem rápido, não em tudo. Um elemento sem ele é desenhado como uma imagem nítida por quadro, então um movimento rápido aparece como cópias separadas, e os limites abaixo se aplicam a ele. Verifique o quadro mais rápido de cada movimento: distância × pico ÷ (duração em quadros).

  • Deslocamento: o passo de um movimento em seu quadro mais rápido fica abaixo da metade do tamanho da própria coisa em movimento ao longo do movimento. Acima de seu tamanho inteiro, o olho vê duas coisas.
  • Rotação: abaixo de 45° por quadro no quadro mais rápido. Algo que se repete ao girar (uma forma de quatro raios, um mostrador de doze marcas) deve permanecer abaixo da metade de seu ângulo de repetição por quadro, ou parece girar para trás: abaixo de 45° para quatro raios, abaixo de 15° para doze marcas. Três voltas em 1 s em [0.16, 1, 0.3, 1] atingem pico de cerca de 200° por quadro a 30 fps: isso estroboscópica.
  • Leitura em movimento: texto, um rosto ou uma captura de tela que continua se movendo enquanto é lido (uma legenda rolante, uma panorâmica sobre uma captura de tela, uma deriva longa) cruza no máximo 15% da largura do quadro por segundo. Essa é a regra do cinema de uma largura de quadro inteira em não menos de 7 s.
  • Flashes: no máximo três inversões de brilho em quadro inteiro ou grande em qualquer segundo, incluindo cortes de falha e estroboscopia.

Esperas

  • Tempo de leitura: 330 ms por palavra (cerca de três palavras por segundo), mais uma batida para notar que a linha chegou. Nunca abaixo de 1 s para uma linha, e arredondado para a próxima batida.
  • Muito longo: um quadro com nada se movendo por mais de cerca de 7 s parece travado. Dê a ele uma deriva, ou siga em frente.
  • O fim: o último quadro completo e parado por pelo menos 1 s (uma marca ou uma chamada para ação: 1,5 s ou mais).

Áreas seguras

As bordas da imagem são cortadas, cobertas ou ignoradas. Mantenha o que importa dentro dessas caixas. Fundos, sangramentos e planos de fundo vão até a borda e além.

QuadroSeguro para títulos: toda palavraSeguro para ação: rostos, produtos, a ação
Largo ou quadrado (16:9, 4:3, 1:1)5% para dentro de cada borda3,5% para dentro de cada borda
Alto (9:16, 4:5)5% para dentro das laterais, 12,5% do topo e da base3,5% para dentro de cada borda

Em 1920×1080, a área segura para títulos é x 96–1824, y 54–1026. Em 1080×1920, é x 54–1026, y 240–1680. Quando o briefing diz que o vídeo é reproduzido em um feed cujo player desenha seus próprios botões e legendas sobre a imagem, também mantenha o texto fora do quinto inferior.

Tipografia

Os tamanhos são o size da fonte como uma fração do lado curto.

NívelTamanhoEm 1080
Exibição: o gancho, a única palavra grande7–12%76–130 px
Título5–7%54–76 px
Corpo, legendas5–6,7%54–72 px
Rótulos, letras miúdas3,5–4,5%38–49 px
Nada destinado à leituraabaixo de 3%32 px
  • Degraus: dois níveis em um mesmo quadro diferem por pelo menos 1,25×; com menos, eles são lidos como um erro em vez de uma hierarquia.
  • Linhas: no máximo 42 caracteres, e no máximo duas linhas para qualquer coisa lida enquanto as coisas se movem. Um gancho tem seis palavras ou menos.
  • Fontes: uma família, em dois pesos distantes (negrito para exibição, regular para corpo). Uma segunda família apenas quando contrasta claramente: uma serifada ou mono ao lado de uma sem serifa.
  • Contraste (taxa do WCAG, a partir da luminância relativa das duas cores): pelo menos 4,5:1 para corpo, legendas e rótulos, e pelo menos 3:1 em tamanho de exibição. Sobre filmagens ou fotos, a taxa muda a cada quadro, então dê ao texto um fundo próprio: uma pílula, uma barra ou uma sombra.

Moderação

  • Uma ideia por toma, com espaço ao redor. Um quadro que precisa ser lido em partes são duas tomas.
  • Três cores: um fundo, uma tinta e um acento. O acento marca uma coisa de cada vez; um segundo uso rouba o peso do primeiro.
  • Um movimento focal por vez, mais no máximo uma deriva ambiente lenta abaixo dele.
  • Efeitos servem ao briefing. Brilhos, falhas, divisões cromáticas, tremores, chamas e explosões de partículas pertencem a um trailer que os pede; em um anúncio ou explicador, eles são lidos como ruído.
  • Sem cromados inventados. Rótulos de canto, timecodes, contadores de quadros, marcas "REC" e quadros HUD vão apenas quando o briefing os pede.
  • Material real em vez de substitutos. Use as capturas de tela, filmagens e marca do briefing; uma UI de produto redesenhada à mão parece errada ao lado da real.

Individual skills in this repo

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

Habilidades Relacionadas