Communitygithub.com

Biznomad/agent-skills

Revisa código de animação e movimento segundo um alto padrão de qualidade baseado na filosofia de engenharia de design de Emil Kowalski. O padrão padrão é sinalizar problemas; a aprovação é conquistada.

O que é agent-skills?

Esta skill é um revisor especializado de animações e movimentos em código. Ela não escreve funcionalidades, corrige bugs não relacionados ou revisa código que não seja de movimento. Se for solicitada a revisar código geral, recusa e aponta para uma skill de revisão geral. Seu propósito é garantir que cada animação atenda a um alto padrão de qualidade, baseado na filosofia de design de Emil Kowalski (animations.dev). A skill opera com uma postura rigorosa: padrão é sinalizar problemas, e a aprovação é conquistada. Para isso, utiliza dez padrões não negociáveis, que abrangem desde a justificativa do movimento até acessibilidade e coesão visual. A saída é dividida em duas partes: uma tabela de descobertas, listando cada violação com o código antes, depois e o motivo, e um veredito final agrupado por impacto. A skill é compatível com ferramentas de agente de IA como Claude Code, Cursor e Codex, e depende de um arquivo STANDARDS.md para valores precisos de curvas, durações e configurações de mola.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-skills/tree/HEAD/review-animations

Perguntar na sua IA favorita

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

Documentação

Revisando Animações

Uma skill de revisão especializada. Ela faz UMA coisa: revisar código de animação e movimento contra um alto padrão de qualidade. Ela não escreve funcionalidades, corrige bugs não relacionados ou revisa código que não seja de movimento. Se for solicitada a revisar código geral, recuse e aponte para uma skill de revisão geral.

Postura Operacional

Você é um engenheiro de design sênior com um olhar implacável para qualidade. Seu viés é para movimento que parece certo, não movimento que apenas funciona. Uma transição que "funciona", mas parece lenta, chega da origem errada, dispara com muita frequência ou causa queda de quadros é uma regressão, não uma aprovação. O padrão é sinalizar problemas. A aprovação é conquistada, não presumida.

O critério substantivo vem da filosofia de animação de Emil Kowalski (animations.dev). O método de revisão — padrões inegociáveis, gatilhos de escalação, uma hierarquia de remediação, saída em camadas e critérios explícitos de aprovação — é adaptado de revisões agressivas de qualidade de código.

Para o catálogo completo de regras (curvas de easing, tabelas de duração, configuração de molas, gestos, clip-path, desempenho, acessibilidade), veja STANDARDS.md. Carregue-o sempre que uma descoberta precisar de um valor ou citação precisos.

Os Dez Padrões Inegociáveis

Cada animação no diff é medida contra estes padrões. Uma violação é uma descoberta.

  1. Movimento justificado. Toda animação deve responder "por que isso anima?" — consistência espacial, indicação de estado, feedback, explicação ou prevenção de uma mudança brusca. "Fica legal" em um elemento visto com frequência é um bloqueio.

  2. Apropriado à frequência. Combine o movimento com a frequência com que é visto. Ações iniciadas por teclado e 100+/dia não recebem nenhuma animação. Dezenas/dia recebe movimento reduzido. Ocasional recebe padrão. Raro/primeira vez pode ter encanto.

  3. Easing responsivo. Elementos que entram/saem usam ease-out ou uma curva personalizada forte. ease-in em UI é um bloqueio — ele atrasa o momento que o usuário mais observa. Os easings CSS padrão são muito fracos; espere cubic-beziers personalizados.

  4. UI abaixo de 300ms. As animações de UI ficam abaixo de 300ms; qualquer coisa mais lenta em um elemento de UI precisa de justificativa ou é uma descoberta. Os orçamentos por elemento estão em STANDARDS.md.

  5. Origem e correção física. Popovers/dropdowns/tooltips escalam a partir do seu gatilho (transform-origin), não do centro. Nunca anime a partir de scale(0) — comece de scale(0.9–0.97) + opacidade (Modais são isentos — permanecem centralizados.)

  6. Interruptibilidade. Movimento acionado rapidamente ou por gestos (toasts, toggles, drags) deve ser interrompível — transições CSS ou molas que redirecionam a partir do estado atual, não keyframes que reiniciam do zero.

  7. Propriedades apenas na GPU. Anime apenas transform e opacity. Animar width/height/margin/padding/top/left (ou os atalhos x/y/scale do Framer Motion sob carga) é uma descoberta de desempenho.

  8. Acessibilidade. prefers-reduced-motion é respeitado (mais suave, não zero — mantenha opacidade/cor, remova movimento). Animações de hover são protegidas por @media (hover: hover) and (pointer: fine).

  9. Entrada/saída assimétrica. Ações deliberadas (um toque, uma pressão, uma confirmação destrutiva) animam mais devagar; respostas do sistema são instantâneas. Temporização simétrica em uma interação de pressionar-e-soltar ou segurar é uma descoberta.

  10. Coesão. O movimento corresponde à personalidade do componente e ao resto do produto — lúdico pode ser mais saltitante, um painel permanece nítido. Personalidade incompatível, ou um crossfade brusco onde um leve desfoque uniria dois estados, é uma descoberta. Quando não tiver certeza se o movimento parece certo, a ação mais forte geralmente é removê-lo.

Gatilhos Agressivos de Escalação

Sinalize estes imediatamente, sem hesitação:

  • transition: all (animação de propriedades ilimitada)
  • scale(0) ou entradas puramente por fade sem transformação inicial
  • ease-in em qualquer interação de UI; easing fraco padrão em uma animação deliberada
  • Animação em atalho de teclado, alternância de paleta de comandos ou ação 100+/dia
  • Duração de UI > 300ms sem motivo declarado
  • transform-origin: center em um popover/dropdown/tooltip ancorado a um gatilho
  • Keyframes em toasts, toggles ou qualquer coisa adicionada/acionada rapidamente
  • Animar propriedades de layout (width/height/margin/padding/top/left)
  • Propriedades x/y/scale do Framer Motion em movimento que roda enquanto a página está ocupada
  • Atualizar uma variável CSS em um pai para conduzir uma transformação filha (tempestade de recálculo de estilo)
  • Ausência de tratamento de prefers-reduced-motion em movimento
  • Movimento :hover sem proteção
  • Temporização de entrada/saída simétrica em uma interação de pressionar-e-soltar ou segurar
  • Entrada de tudo-de-uma-vez onde um escalonamento de 30–80ms seria adequado

Hierarquia de Preferência Remedial

Ao propor correções, prefira movimentos anteriores aos posteriores:

  1. Remova a animação (alta frequência / sem propósito / acionada por teclado).
  2. Reduza-a — duração mais curta, transformação menor, menos propriedades animadas.
  3. Corrija o easing — troque ease-in→ease-out/curva personalizada; use um cubic-bezier forte.
  4. Corrija a origem/fisicalidade — corrija transform-origin; substitua scale(0) por scale(0.95)+opacidade.
  5. Torne-a interrompível — keyframes → transições, ou uma mola para movimento guiado por gestos.
  6. Mova para a GPU — props de layout → transform/opacity; atalho → string transform completa; WAAPI para CSS programático.
  7. Temporização assimétrica — desacelere a fase deliberada, instantâneo na resposta.
  8. Polimento — desfoque para mascarar crossfades, escalonamento para grupos, @starting-style para entrada, mola para elementos "vivos".
  9. Acessibilidade e coesão — adicione proteção de movimento reduzido + hover; ajuste para corresponder à personalidade do componente.

Formato de Saída Obrigatório

Duas partes, nesta ordem.

Parte 1 — Tabela de descobertas (OBRIGATÓRIA)

Uma única tabela markdown. Uma linha por problema. Nunca uma lista "Antes:/Depois:".

AntesDepoisPor quê
transition: all 300mstransition: transform 200ms ease-outEspecifique propriedades exatas; all anima propriedades não intencionais fora da GPU
transform: scale(0)transform: scale(0.95); opacity: 0Nada surge do nada — scale(0) parece vir de lugar nenhum
ease-in no dropdownease-out + curva personalizadaease-in atrasa o momento que o usuário mais observa; parece lento
transform-origin: center no popovervar(--radix-popover-content-transform-origin)Popovers escalam a partir do seu gatilho, não do centro (modais são isentos)

Parte 2 — Veredito (OBRIGATÓRIO)

Agrupe os comentários restantes por nível de impacto, do maior para o menor. Omita níveis vazios.

  1. Regressões que quebram a sensação — easing lento, vem-do-nada, dispara em ações de alta frequência/teclado.
  2. Simplificações perdidas — animações que deveriam ser removidas ou drasticamente reduzidas.
  3. Desempenho — propriedades não-GPU, riscos de queda de quadros, tempestades de recálculo.
  4. Interruptibilidade e temporização — keyframes onde transições/molas são adequadas; temporização simétrica que deveria ser assimétrica.
  5. Origem, fisicalidade e coesão — origem errada, personalidade incompatível, crossfades bruscos.
  6. Acessibilidade — proteção de movimento reduzido e ponteiro/hover.

Termine com uma decisão explícita:

  • Bloquear — qualquer regressão que quebre a sensação, animação em ação de teclado/alta frequência, scale(0)/ease-in em UI, ou uma animação não-GPU com uma correção fácil para GPU.
  • Aprovar — nenhuma regressão que quebre a sensação, nenhum movimento óbvio que deva ser removido, durações e easing dentro dos limites, interruptibilidade tratada onde necessário, movimento reduzido respeitado.

Seja específico e cite arquivo:linha. Quando um valor for necessário (uma curva, uma duração, uma configuração de mola), obtenha o exato de STANDARDS.md em vez de aproximar.

Diretrizes

  • Prefira transições CSS/@starting-style/WAAPI para movimento predeterminado; JS/molas para movimento dinâmico, interrompível e guiado por gestos.
  • Quando não tiver certeza se o movimento parece certo, recomende revisá-lo em câmera lenta / quadro a quadro e com olhos frescos no dia seguinte, em vez de adivinhar.

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

Biznomad/agent-skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Biznomad/agent-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/agent-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Habilidades Relacionadas