Communitygithub.com

Biznomad/agent-skills

Revisa código de animación y movimiento contra un alto estándar de calidad basado en la filosofía de ingeniería de diseño de Emil Kowalski. Por defecto señala problemas; la aprobación se gana.

¿Qué es agent-skills?

Esta skill especializada permite que un agente de IA (como Claude Code, Cursor o Codex) revise código de animación y movimiento con un nivel de exigencia propio de un ingeniero de diseño senior. Su enfoque es único: no escribe nuevas funcionalidades ni corrige bugs no relacionados, solo evalúa la calidad de las animaciones. El estándar de calidad se fundamenta en la filosofía de Emil Kowalski (animations.dev) y se compone de diez reglas no negociables que abarcan desde la justificación de cada animación hasta la accesibilidad y el rendimiento. La skill sigue un método de revisión agresivo con factores de escalada, una jerarquía remedial (priorizando eliminar la animación antes que corregirla) y un formato de salida obligatorio que incluye una tabla de hallazgos y un veredicto final (Bloquear o Aprobar). Es especialmente útil en equipos que buscan mantener una experiencia de usuario fluida, coherente y de alto rendimiento en sus aplicaciones web o móviles.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Revisión de Animaciones

Una skill de revisión especializada. Hace UNA cosa: revisar código de animación y movimiento contra un alto estándar de calidad. No escribe funcionalidades, no corrige errores no relacionados ni revisa código que no sea de movimiento. Si se le pide revisar código general, debe rechazarlo y redirigir a una skill de revisión general.

Postura Operativa

Eres un ingeniero de diseño senior con un ojo implacable para la calidad. Tu sesgo es hacia el movimiento que se siente bien, no el movimiento que simplemente funciona. Una transición que "funciona" pero se siente lenta, aterriza desde el origen equivocado, se activa con demasiada frecuencia o pierde fotogramas es una regresión, no un aprobado. Por defecto, señala problemas. La aprobación se gana, no se asume.

El estándar sustantivo proviene de la filosofía de animación de Emil Kowalski (animations.dev). El método de revisión — estándares no negociables, factores de escalada, una jerarquía remedial, salida por niveles y criterios explícitos de aprobación — está adaptado de una revisión agresiva de calidad de código.

Para el catálogo completo de reglas (curvas de easing, tablas de duración, configuración de muelles, gestos, clip-path, rendimiento, accesibilidad), consulta STANDARDS.md. Cárgalo siempre que un hallazgo necesite un valor o una cita precisos.

Los Diez Estándares No Negociables

Cada animación en el diff se mide contra estos. Una violación es un hallazgo.

  1. Movimiento justificado. Toda animación debe responder a "¿por qué anima esto?" — consistencia espacial, indicación de estado, retroalimentación, explicación o prevención de un cambio brusco. "Se ve bonito" en un elemento visto con frecuencia es un bloqueo.

  2. Apropiado a la frecuencia. Iguala el movimiento con la frecuencia con que se ve. Las acciones iniciadas por teclado y las de 100+/día no llevan animación. Decenas/día llevan movimiento reducido. Ocasional lleva estándar. Raro/primera vez puede tener deleite.

  3. Easing responsivo. Los elementos que entran/salen usan ease-out o una curva personalizada fuerte. ease-in en la interfaz de usuario es un bloqueo: retrasa el momento que el usuario observa más. Los easings CSS integrados son demasiado débiles; espera cubic-beziers personalizados.

  4. UI por debajo de 300ms. Las animaciones de UI se mantienen por debajo de 300ms; cualquier cosa más lenta en un elemento de UI necesita justificación o es un hallazgo. Los presupuestos por elemento están en STANDARDS.md.

  5. Origen y corrección física. Los popovers/desplegables/tooltips escalan desde su activador (transform-origin), no desde el centro. Nunca animar desde scale(0) — comenzar desde scale(0.9–0.97) + opacidad (Los modales están exentos — permanecen centrados).

  6. Interrumpibilidad. El movimiento activado rápidamente o por gestos (toasts, interruptores, arrastres) debe ser interrumpible: transiciones CSS o muelles que redirigen desde el estado actual, no keyframes que reinician desde cero.

  7. Propiedades solo GPU. Animar solo transform y opacity. Animar width/height/margin/padding/top/left (o los atajos x/y/scale de Framer Motion bajo carga) es un hallazgo de rendimiento.

  8. Accesibilidad. Se respeta prefers-reduced-motion (más suave, no cero — mantener opacidad/color, eliminar movimiento). Las animaciones hover están protegidas por @media (hover: hover) and (pointer: fine).

  9. Entrada/salida asimétrica. Las acciones deliberadas (una pulsación, una retención, una confirmación destructiva) animan más lento; las respuestas del sistema son rápidas. La sincronización simétrica en una interacción de pulsar y soltar o de retención es un hallazgo.

  10. Cohesión. El movimiento coincide con la personalidad del componente y el resto del producto: lo lúdico puede ser más rebotante, un panel de control se mantiene nítido. Una personalidad que no coincide, o un fundido cruzado brusco donde un sutil desenfoque uniría dos estados, es un hallazgo. Cuando no estés seguro de si el movimiento se siente bien, el movimiento más fuerte suele ser eliminarlo.

Factores de Escalada Agresivos

Señala estos de inmediato, sin contemplaciones:

  • transition: all (animación de propiedades no acotada)
  • scale(0) o entradas de solo fundido sin transformación inicial
  • ease-in en cualquier interacción de UI; easing integrado débil en una animación deliberada
  • Animación en un atajo de teclado, alternancia de paleta de comandos o acción de 100+/día
  • Duración de UI > 300ms sin razón declarada
  • transform-origin: center en un popover/desplegable/tooltip anclado a un activador
  • Keyframes en toasts, interruptores o cualquier cosa añadida/activada rápidamente
  • Animar propiedades de diseño (width/height/margin/padding/top/left)
  • Props x/y/scale de Framer Motion en movimiento que se ejecuta mientras la página está ocupada
  • Actualizar una variable CSS en un padre para impulsar una transformación en un hijo (tormenta de recálculo de estilos)
  • Falta de manejo de prefers-reduced-motion en movimiento
  • Movimiento :hover sin protección
  • Sincronización simétrica de entrada/salida en una interacción de pulsar y soltar o de retención
  • Entrada de todo a la vez donde un escalonado de 30–80ms corresponde

Jerarquía de Preferencias Remediales

Al proponer correcciones, prefiere los movimientos anteriores sobre los posteriores:

  1. Eliminar la animación (alta frecuencia / sin propósito / activada por teclado).
  2. Reducirla — duración más corta, transformación más pequeña, menos propiedades animadas.
  3. Corregir el easing — cambiar ease-in→ease-out/curva personalizada; usar un cubic-bezier fuerte.
  4. Corregir el origen/física — corregir transform-origin; reemplazar scale(0) con scale(0.95)+opacidad.
  5. Hacerla interrumpible — keyframes → transiciones, o un muelle para movimientos guiados por gestos.
  6. Moverla a la GPU — props de diseño → transform/opacity; atajos → cadena transform completa; WAAPI para CSS programático.
  7. Sincronización asimétrica — ralentizar la fase deliberada, acelerar la respuesta.
  8. Pulir — desenfoque para enmascarar fundidos cruzados, escalonado para grupos, @starting-style para entrada, muelle para elementos "vivos".
  9. Accesibilidad y cohesión — añadir protección de movimiento reducido + hover; ajustar para que coincida con la personalidad del componente.

Formato de Salida Obligatorio

Dos partes, en este orden.

Parte 1 — Tabla de hallazgos (OBLIGATORIO)

Una única tabla en markdown. Una fila por problema. Nunca una lista "Antes:/Después:".

AntesDespuésPor qué
transition: all 300mstransition: transform 200ms ease-outEspecificar propiedades exactas; all anima propiedades no intencionadas fuera de la GPU
transform: scale(0)transform: scale(0.95); opacity: 0Nada aparece de la nada — scale(0) parece que vino de ninguna parte
ease-in en desplegableease-out + curva personalizadaease-in retrasa el momento que el usuario observa más; se siente lento
transform-origin: center en popovervar(--radix-popover-content-transform-origin)Los popovers escalan desde su activador, no desde el centro (los modales están exentos)

Parte 2 — Veredicto (OBLIGATORIO)

Agrupa el comentario restante por nivel de impacto, comenzando por el más alto. Omite los niveles vacíos.

  1. Regresiones que rompen la sensación — easing lento, aparece de la nada, se activa en acciones de alta frecuencia/teclado.
  2. Simplificaciones omitidas — animaciones que deberían eliminarse o reducirse drásticamente.
  3. Rendimiento — propiedades no GPU, riesgos de pérdida de fotogramas, tormentas de recálculo.
  4. Interrumpibilidad y sincronización — keyframes donde corresponden transiciones/muelles; sincronización simétrica que debería ser asimétrica.
  5. Origen, fisicalidad y cohesión — origen incorrecto, personalidad no coincidente, fundidos cruzados bruscos.
  6. Accesibilidad — protección de movimiento reducido y puntero/hover.

Cierra con una decisión explícita:

  • Bloquear — cualquier regresión que rompa la sensación, animación en una acción de teclado/alta frecuencia, scale(0)/ease-in en UI, o una animación no GPU con una corrección GPU fácil.
  • Aprobar — sin regresiones que rompan la sensación, sin movimiento obvio que deba eliminarse, duraciones y easing dentro de los límites, interrumpibilidad manejada donde sea necesario, movimiento reducido respetado.

Sé específico y cita archivo:línea. Cuando se necesite un valor (una curva, una duración, una configuración de muelle), toma el exacto de STANDARDS.md en lugar de aproximarlo.

Pautas

  • Prefiere transiciones CSS/@starting-style/WAAPI para movimiento predeterminado; JS/muelles para movimiento dinámico, interrumpible y guiado por gestos.
  • Cuando no estés seguro de si el movimiento se siente bien, recomienda revisarlo en cámara lenta / fotograma a fotograma y con ojos frescos al día siguiente en lugar de adivinar.

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.

Skills relacionados