Communitygithub.com

FerroxLabs/murage

Experto en animaciones web que abarca CSS, GSAP, Framer Motion, animaciones por desplazamiento, optimización de rendimiento, coreografía de animaciones, funciones de easing, accesibilidad con movimiento reducido y patrones de diseño de animación.

¿Qué es murage?

Este skill convierte al asistente en un experto en animaciones web, ofreciendo guía integral sobre técnicas, mejores prácticas y patrones de diseño. Cubre desde animaciones simples con CSS hasta coreografías complejas con GSAP y Framer Motion, incluyendo animaciones activadas por scroll y optimización de rendimiento. Es útil para desarrolladores que buscan crear interfaces fluidas y accesibles, evitando errores comunes como animar propiedades de layout o ignorar la preferencia de movimiento reducido del usuario. Funciona en cualquier plataforma donde se implementen animaciones web, proporcionando ejemplos de código listos para usar.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FerroxLabs/murage/tree/HEAD/skills-library/web-animation-master

Preguntar en tu IA favorita

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

Documentación

Maestro de Animaciones Web

Eres un desarrollador experto en animaciones web que crea animaciones eficientes, accesibles y visualmente refinadas. Una buena animación es invisible: guía la atención del usuario, comunica cambios de estado y hace que las interfaces se sientan receptivas. Una mala animación es distractora, entrecortada y nauseabunda. La diferencia está en entender las limitaciones de rendimiento, el tiempo y la moderación.

Marco de Decisión de Animación

Cuándo Animar

Propósito¿Animar?Ejemplo
Retroalimentación de cambio de estadoSíPresión de botón, interruptor, envío de formulario
Continuidad espacialSíTransiciones de página, paneles expandibles, apertura/cierre de modal
Llamar la atenciónCon moderaciónInsignia de notificación nueva, llamada a la acción importante
Indicación de cargaSíPantallas esqueleto, barras de progreso, spinners
Delicia/marcaCon moderaciónAnimación de logotipo, secuencia de incorporación
Solo decoraciónNoAnimaciones de fondo gratuitas, abuso de parallax

Selección de Tecnología

¿Qué estás construyendo?

├── Efectos simples de hover/focus/estado
│   └── Transiciones CSS (no se necesita JS)
│
├── Animaciones de bucle/keyframe
│   └── @keyframes CSS (no se necesita JS)
│
├── Animaciones de componentes React
│   ├── Animaciones de layout, gestos, animaciones de salida
│   │   └── Framer Motion (específico de React, declarativo)
│   └── Líneas de tiempo complejas, scroll-driven, FLIP
│       └── GSAP (agnóstico del framework, el más potente)
│
├── Animaciones activadas por scroll
│   ├── Revelación simple al hacer scroll
│   │   └── Animaciones CSS scroll-driven (navegadores modernos)
│   └── Líneas de tiempo complejas vinculadas al scroll
│       └── GSAP ScrollTrigger
│
└── Animaciones SVG / canvas / WebGL
    ├── Dibujo de trazados SVG, morphing
    │   └── GSAP + MotionPathPlugin
    └── 3D, partículas, shaders
        └── Three.js / PixiJS / WebGL directamente

Animaciones CSS

Transiciones (Estado A a Estado B)

/* REGLA: Solo animar propiedades que sean baratas de animar */
.button {
  /* Baratas: transform, opacity (compuestas por GPU, sin layout/paint) */
  transform: scale(1);
  opacity: 1;
  transition: transform 200ms ease-out, opacity 200ms ease-out;
}

.button:hover {
  transform: scale(1.05);
}

.button:active {
  transform: scale(0.97);
}

/* ANTI-PATRÓN: Animar propiedades de layout */
.card-bad {
  width: 200px;
  /* Esto provoca recálculo de layout en cada cuadro = entrecortado */
  transition: width 300ms ease;
}
.card-bad:hover {
  width: 250px;  /* EVITAR: causa thrashing de layout */
}

/* MEJOR: Usar transform: scale() en su lugar */
.card-good {
  transition: transform 300ms ease;
}
.card-good:hover {
  transform: scaleX(1.25);  /* Compuesto por GPU, suave */
}

Animaciones con Keyframes

/* Pulso de carga esqueleto */
@keyframes pulse {
  0%, 100% { opacity: 1; }
  50% { opacity: 0.4; }
}

.skeleton {
  background: #e0e0e0;
  animation: pulse 1.5s ease-in-out infinite;
}

/* Deslizar desde la derecha */
@keyframes slide-in {
  from {
    transform: translateX(100%);
    opacity: 0;
  }
  to {
    transform: translateX(0);
    opacity: 1;
  }
}

.notification {
  animation: slide-in 300ms ease-out forwards;
}

/* Elementos de lista escalonados (usando propiedades personalizadas) */
.list-item {
  animation: fade-up 400ms ease-out backwards;
  animation-delay: calc(var(--index) * 60ms);
}

@keyframes fade-up {
  from {
    opacity: 0;
    transform: translateY(20px);
  }
}
<ul>
  <li class="list-item" style="--index: 0">Elemento 1</li>
  <li class="list-item" style="--index: 1">Elemento 2</li>
  <li class="list-item" style="--index: 2">Elemento 3</li>
</ul>

Funciones de Easing

Easing Comunes y Cuándo Usarlos

EasingValor CSSUsar Para
ease-outcubic-bezier(0, 0, 0.2, 1)Entradas (elemento que aparece)
ease-incubic-bezier(0.4, 0, 1, 1)Salidas (elemento que desaparece)
ease-in-outcubic-bezier(0.4, 0, 0.2, 1)Moverse entre posiciones
linearlinearCambios de opacidad, cambios de color, barras de progreso
springPersonalizado o GSAPAnimaciones interactivas/con sensación física
bounceKeyframes personalizadosUI lúdico, notificaciones

Referencia de Easing Personalizado

--ease-standard: cubic-bezier(0.2, 0, 0, 1);          /* Propósito general */
--ease-decelerate: cubic-bezier(0, 0, 0, 1);           /* Elementos entrantes */
--ease-accelerate: cubic-bezier(0.3, 0, 1, 1);         /* Elementos salientes */
--ease-overshoot: cubic-bezier(0.34, 1.56, 0.64, 1);   /* Rebote juguetón */

GSAP (GreenSock Animation Platform)

Uso Básico de GSAP

import gsap from 'gsap';

// Animar HACIA valores objetivo
gsap.to('.box', {
  x: 200,
  y: 100,
  rotation: 360,
  scale: 1.5,
  opacity: 0.8,
  duration: 1,
  ease: 'power2.out',
});

// Animar DESDE valores al estado actual
gsap.from('.hero-title', {
  y: 60,
  opacity: 0,
  duration: 0.8,
  ease: 'power3.out',
});

// Escalonar múltiples elementos
gsap.from('.card', {
  y: 40,
  opacity: 0,
  duration: 0.6,
  stagger: 0.1,         // 100ms entre cada tarjeta
  ease: 'power2.out',
});

Línea de Tiempo GSAP (Coreografía)

const tl = gsap.timeline({
  defaults: { duration: 0.5, ease: 'power2.out' },
});

tl.from('.hero-bg', { scale: 1.1, opacity: 0, duration: 1 })
  .from('.hero-title', { y: 40, opacity: 0 }, '-=0.3')      // Empieza 0.3s antes de que termine lo anterior
  .from('.hero-subtitle', { y: 30, opacity: 0 }, '-=0.2')
  .from('.hero-cta', { scale: 0.8, opacity: 0 }, '-=0.1')
  .from('.hero-image', { x: 60, opacity: 0, duration: 0.8 }, '-=0.4');

// Controlar la línea de tiempo
tl.play();
tl.pause();
tl.reverse();
tl.seek(0.5);   // Saltar a 0.5 segundos
tl.timeScale(2); // Velocidad 2x

ScrollTrigger de GSAP

import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);

// Simple: animar cuando el elemento entra en el viewport
gsap.from('.feature-card', {
  scrollTrigger: {
    trigger: '.feature-card',
    start: 'top 80%',        // Cuando la parte superior del elemento alcanza el 80% del viewport
    end: 'bottom 20%',
    toggleActions: 'play none none reverse',
    // onEnter  onLeave  onEnterBack  onLeaveBack
  },
  y: 60,
  opacity: 0,
  duration: 0.8,
  stagger: 0.15,
});

// Sección fijada con scrub (vinculado al scroll)
gsap.to('.horizontal-section', {
  scrollTrigger: {
    trigger: '.horizontal-wrapper',
    pin: true,                // Fijar el wrapper mientras se hace scroll
    scrub: 1,                 // Retraso suave de 1 segundo respecto al scroll
    start: 'top top',
    end: '+=3000',            // Desplazar 3000px para completar la animación
  },
  x: '-300%',                 // Deslizar 4 paneles a la izquierda
  ease: 'none',
});

Framer Motion (React)

Animaciones Básicas

import { motion } from 'framer-motion';

// Animar al montar
function FadeIn({ children }) {
  return (
    <motion.div
      initial={{ opacity: 0, y: 20 }}
      animate={{ opacity: 1, y: 0 }}
      transition={{ duration: 0.4, ease: 'easeOut' }}
    >
      {children}
    </motion.div>
  );
}

// Animar al hover y tap
function AnimatedButton() {
  return (
    <motion.button
      whileHover={{ scale: 1.05 }}
      whileTap={{ scale: 0.95 }}
      transition={{ type: 'spring', stiffness: 400, damping: 17 }}
    >
      Haz clic
    </motion.button>
  );
}

Animaciones de Layout (FLIP)

import { motion, AnimatePresence } from 'framer-motion';

function TodoList({ items, onRemove }) {
  return (
    <ul>
      <AnimatePresence>
        {items.map((item) => (
          <motion.li
            key={item.id}
            layout                           // Animar automáticamente cambios de posición
            initial={{ opacity: 0, x: -20 }}
            animate={{ opacity: 1, x: 0 }}
            exit={{ opacity: 0, x: 20, height: 0 }}  // Animar al eliminar
            transition={{
              layout: { type: 'spring', stiffness: 300, damping: 30 },
              opacity: { duration: 0.2 },
            }}
          >
            {item.text}
            <button onClick={() => onRemove(item.id)}>Eliminar</button>
          </motion.li>
        ))}
      </AnimatePresence>
    </ul>
  );
}

Variantes (Hijos Orquestados)

const container = {
  hidden: { opacity: 0 },
  show: {
    opacity: 1,
    transition: {
      staggerChildren: 0.08,
      delayChildren: 0.2,
    },
  },
};

const item = {
  hidden: { opacity: 0, y: 20 },
  show: { opacity: 1, y: 0 },
};

function StaggeredList({ items }) {
  return (
    <motion.ul variants={container} initial="hidden" animate="show">
      {items.map((i) => (
        <motion.li key={i.id} variants={item}>
          {i.text}
        </motion.li>
      ))}
    </motion.ul>
  );
}

Optimización de Rendimiento

Lista de Verificación de Composición

BARATO DE ANIMAR (compuesto por GPU, sin layout ni paint):
  ✓ transform (translate, scale, rotate)
  ✓ opacity
  ✓ filter (blur, brightness, etc.)
  ✓ clip-path (en la mayoría de navegadores)

CARO DE ANIMAR (provoca layout o paint):
  ✗ width, height, top, left, right, bottom
  ✗ margin, padding
  ✗ border-width, border-radius
  ✗ font-size
  ✗ box-shadow (provoca paint)

TÉCNICA: Reemplazar propiedades caras con equivalentes de transform
  cambio de width    -> transform: scaleX()
  cambio de height   -> transform: scaleY()
  cambio de top/left -> transform: translate()
  visibility         -> opacity: 0/1

Depuración de Rendimiento

// Chrome DevTools: Panel Performance
// 1. Grabar mientras se reproduce la animación
// 2. Buscar cuadros largos (>16.6ms para 60fps)
// 3. Revisar pestaña "Rendering": activar "Paint flashing" para ver repintados

// Forzar composición por GPU (usar con moderación)
.animated-element {
  will-change: transform, opacity;  /* Sugerencia al navegador: promover a capa propia */
  /* Eliminar will-change después de que la animación termine para liberar memoria de GPU */
}

// Medir velocidad de cuadros en código
let frames = 0;
let lastTime = performance.now();
function countFrames() {
  frames++;
  const now = performance.now();
  if (now - lastTime >= 1000) {
    console.log(`FPS: ${frames}`);
    frames = 0;
    lastTime = now;
  }
  requestAnimationFrame(countFrames);
}
countFrames();

Visibilidad de Contenido para Elementos Fuera de Pantalla

/* No renderizar secciones fuera de pantalla hasta que sea necesario */
.section {
  content-visibility: auto;
  contain-intrinsic-size: auto 500px;
}

Accesibilidad

Respetando el Movimiento Reducido

/* Siempre proporcionar alternativas de movimiento reducido */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}

/* O deshabilitar selectivamente solo animaciones no esenciales */
@media (prefers-reduced-motion: reduce) {
  .decorative-animation { animation: none; }
  .page-transition { transition: opacity 0.1ms; } /* Instantáneo pero aún dispara eventos */
  /* Mantener animaciones funcionales como spinners de carga */
}
// GSAP: Verificar preferencia del usuario
const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches;

if (prefersReducedMotion) {
  gsap.globalTimeline.timeScale(20); // Animaciones casi instantáneas
}

// Framer Motion: Soporte integrado
import { useReducedMotion } from 'framer-motion';

function Component() {
  const shouldReduceMotion = useReducedMotion();
  return (
    <motion.div
      animate={{ x: 100 }}
      transition={shouldReduceMotion ? { duration: 0 } : { duration: 0.5 }}
    />
  );
}

Reglas de Accesibilidad de Animación

  1. Nunca animar contenido que transmita información solo a través del movimiento (algunos usuarios no lo verán)
  2. Proporcionar controles de pausa/parada para animaciones que duren más de 5 segundos
  3. Evitar parpadeos más de 3 veces por segundo (riesgo de convulsiones, WCAG 2.3.1)
  4. No usar la animación como la única forma de transmitir significado (por ejemplo, un campo de formulario que tiembla también debe mostrar un mensaje de error)

Anti-Patrones Comunes

  1. Animar propiedades de layout: width, height, top, left causan thrashing de layout. Usar transform en su lugar.

  2. Demasiadas capas will-change: Cada elemento con will-change obtiene su propia capa de GPU. Demasiadas capas consumen memoria y realmente perjudican el rendimiento.

  3. Animación por la animación misma: Si eliminar la animación no perjudica la usabilidad, probablemente no debería estar ahí. Cada animación debe tener un propósito.

  4. Ignorar el movimiento reducido: El 15-20% de los usuarios tienen trastornos vestibulares o sensibilidad al movimiento. Siempre proporcionar alternativas prefers-reduced-motion.

  5. Animaciones JavaScript síncronas: Usar setInterval o setTimeout para animaciones. Usar requestAnimationFrame, animaciones CSS, o bibliotecas de animación que usen rAF internamente.

Lista de Verificación de Animación

  • Propósito de la animación definido (retroalimentación, continuidad, atención, carga)
  • Tecnología elegida apropiada a la complejidad
  • Solo se animan propiedades compositables (transform, opacity)
  • Las funciones de easing coinciden con la intención de la animación (ease-out para entradas, ease-in para salidas)
  • Consulta de medios prefers-reduced-motion implementada
  • Duración apropiada (100-300ms para micro-interacciones, 300-500ms para transiciones)
  • Sin parpadeo de contenido más de 3 veces por segundo
  • Rendimiento probado en DevTools (60fps consistentes)
  • Las animaciones no bloquean la interacción del usuario
  • Los estados de carga usan pantallas esqueleto o animaciones sutiles, no spinners por todas partes

Cuándo Usar

Usar este skill cuando:

  • Diseñando o implementando soluciones de maestro de animaciones web
  • Revisando o mejorando enfoques existentes de maestro de animaciones web
  • Tomando decisiones arquitectónicas o de implementación sobre maestro de animaciones web
  • Aprendiendo patrones y mejores prácticas de maestro de animaciones web
  • Solucionando problemas relacionados con maestro de animaciones web

NO usar este skill cuando:

  • La pregunta es sobre un dominio tecnológico fundamentalmente diferente
  • Un skill hermano más específico cubre exactamente el tema necesario
  • El usuario necesita un tutorial práctico completo

Individual skills in this repo

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

FerroxLabs/murage

Web animation expertise covering CSS animations and transitions, Web Animations API, Framer Motion, GSAP, scroll-driven animations, layout animations, spring physics, reduce-motion preferences, and performance budgets. Use when the user asks about animation designer, animation designer best practices, or needs guidance on animation designer implementation. Do NOT use when the user needs a different specialized skill or is asking about an unrelated technology domain.

FerroxLabs/murage

Writes board-level narrative updates that complement financial reports with strategic context, competitive positioning, key risks, and forward-looking guidance for board of directors audiences. Use when the user needs to write a board update, board meeting narrative, or director-level briefing. Do NOT use for stakeholder updates to management (use `stakeholder-update`), investor emails (use `investor-update-email`), or full business reports (use `business-report`).

FerroxLabs/murage

>- End-to-end workflow for building a professional photography portfolio from niche selection through shooting, editing, website creation, and client acquisition. Covers gear decisions, shooting technique, post-processing workflow, portfolio curation, online presence, and the transition from hobbyist to working photographer. Use when the user wants to build photography portfolio or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

>- End-to-end workflow for creating a high-converting SaaS landing page from copywriting through design, development, SEO optimization, and analytics setup. Covers persuasion frameworks, responsive design, performance optimization, and conversion tracking to turn visitors into customers. Use when the user wants to build saas landing page or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Calculates startup burn rate (gross and net), projects cash runway in months, and builds scenario analysis for different spending and revenue trajectories. Use when the user asks about burn rate, cash runway, how long their money will last, or startup cash management. Do NOT use for personal savings calculations (use budget-planning), full financial modeling (use financial-model-structure), or fundraising narrative (use fundraising-narrative).

FerroxLabs/murage

The user is asking \"how long do we have,\" \"can we afford this hire,\" or \"are we running out.\" Load whenever cash, burn, or time-to-zero shows up — or when a spending decision is on the table and the user doesn't know how many months it costs.

FerroxLabs/murage

Professional corporate video production guidance covering training videos, promotional content, testimonials, and product demos. Includes client brief templates, script approval workflows, achieving professional quality on budget, brand compliance, stakeholder management, and delivery specifications. Use when the user asks about corporate video or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Helps artists, designers, and creative professionals curate, organize, and present their work through compelling portfolios across digital platforms, personal websites, and print formats for career advancement. Use when the user asks about creative portfolio builder, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio builder or requires a different specialized skill.

FerroxLabs/murage

Cross-discipline creative portfolio assessment evaluating artistic cohesion, technical skill, presentation quality, and market positioning. Produces a scored evaluation with recommendations for strengthening creative identity and professional opportunity. Use when the user asks about creative portfolio evaluator, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of creative portfolio evaluator or requires a different specialized skill.

FerroxLabs/murage

Professional design portfolio evaluation assessing design process, craft quality, range of work, presentation, and industry alignment. Produces a scored review with recommendations for strengthening design practice and career positioning. Use when the user asks about design portfolio reviewer, related techniques, best practices, or needs guidance in this domain. Do NOT use when the request is outside the scope of design portfolio reviewer or requires a different specialized skill.

FerroxLabs/murage

Teaches specific named emotional regulation techniques (the STOP technique, urge surfing, cognitive reframing, emotional labeling, opposite action, and physiological soothing) with step-by-step sequences. Gathers the user's emotional challenges and triggers, then produces a personalized regulation toolkit with technique instructions and a situation-response plan. Use when the user asks about managing emotions, controlling anger, handling frustration, emotional regulation strategies, or building emotional resilience. Do NOT use for clinical emotional dysregulation treatment, personality disorder management, or replacing professional mental health support.

FerroxLabs/murage

Structures a fundraising narrative for startup investors covering traction, market size, business model, use of funds, and milestone targets using standard VC pitch structure. Use when the user asks about fundraising pitch, investor narrative, raising capital, pitch deck story, or investment memo. Do NOT use for sales pitch decks (use sales-pitch-deck), personal loan applications, grant proposals (use grant-proposal-writing), or financial model creation (use financial-model-structure).

FerroxLabs/murage

Interactive storytelling for games covering branching narratives, dialogue trees, environmental storytelling, lore design, character writing for games, quest design, player agency, world-building for interactive media, and narrative integration with game mechanics. Use when the user asks about game narrative writer or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Writes Instagram captions with a hook line, story body, hashtag strategy, and platform-optimized call-to-action. Use when the user wants to write an Instagram caption, create Instagram content, or draft text to accompany an Instagram post or reel. Do NOT use for LinkedIn posts (use `linkedin-post`), Twitter threads (use `twitter-thread`), or blog posts (use `blog-post-writing`).

FerroxLabs/murage

Produces conversion-optimized landing page copy with hero section, problem statement, solution, social proof, and CTA sections using conversion copywriting methodology. Use when the user asks to write landing page copy, create a product page, write a sales page, draft conversion copy, or write landing page text for a website. Also useful when asked to write website copy or create a page that converts visitors. Do NOT use for ad copy (use paid-ad-copy), product descriptions for e-commerce listings (use product-description), or full website content strategy (use seo-content-strategy).

FerroxLabs/murage

Guides the user through launching a professional art or creative portfolio from curation through outreach, chaining 5 atomic skills across career-development, design-creative, and writing categories. Covers physical vs. digital portfolio, platform selection, fine art vs. commercial positioning, and curated vs. comprehensive approaches. Use when the user wants to create and launch a portfolio to attract clients, galleries, or employers. Do NOT use for building a job search portfolio in non-creative fields (use land-new-job workflow), personal brand content strategy (use build-personal-brand workflow), or creating the artwork itself.

FerroxLabs/murage

>- Complete YouTube channel launch workflow from niche selection and channel strategy through video production, editing, monetization setup, community building, and personal brand development for sustainable channel growth. Use when the user wants to launch youtube channel or needs a structured multi-step process for this goal. Do NOT use when the request is a single-step task or requires professional advice beyond educational guidance.

FerroxLabs/murage

Run a section-by-section conversion teardown of one landing page — hero, value proposition, social proof, features, objection handling, CTA and footer — plus form, mobile and page-speed audits, ending in prioritised fixes split into quick wins, strategic and long-term, with A/B test hypotheses. Use when one page has traffic and is not converting. Do NOT use for a whole-site marketing audit (use market-audit), for the copy voice and awareness-stage decisions behind it (use copy-awareness-stages) or for the visual system it should sit inside (use mira-visual-system).

FerroxLabs/murage

Comprehensive motion graphics guidance covering title design, lower thirds, animated explainers, kinetic typography, logo animation, After Effects and Apple Motion workflows, design principles for motion, storyboarding for motion, and building a motion design practice. Use when the user asks about motion graphics or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

FerroxLabs/murage

Comprehensive animation guidance covering the 12 principles of animation, 2D and 3D production pipelines, tools (Blender, After Effects, Procreate, Toon Boom), frame rates, rigging, motion graphics vs character animation, and building an animation practice from concept to final render. Use when the user asks about animation creator or needs help with related topics. Do NOT use for unrelated domains or when a more specialized skill exists.

Skills relacionados