Communitygithub.com

ComeOnOliver/skillshub

Revisa una funcionalidad y mejórala con animaciones con propósito, micro-interacciones y efectos de movimiento que aumenten la usabilidad y el deleite.

¿Qué es skillshub?

Este skill (ComeOnOliver/skillshub) guía a un agente de IA (como Claude Code, Cursor o Codex) en el proceso de añadir animaciones y micro-interacciones estratégicas a una funcionalidad existente. Su objetivo es mejorar la comprensión del usuario, proporcionar retroalimentación clara y crear una experiencia agradable, evitando la decoración vacía. El skill comienza con una fase obligatoria de preparación de contexto (audiencia, casos de uso, personalidad de marca y restricciones de rendimiento), y exige que el agente consulte al usuario si la información no es clara. Luego, analiza oportunidades de animación en áreas estáticas como falta de retroalimentación, transiciones bruscas o relaciones poco claras. Proporciona una estrategia detallada de implementación con categorías (entradas, micro-interacciones, transiciones, navegación, retroalimentación y momentos de deleite), incluyendo ejemplos concretos de código CSS y JavaScript, curvas de aceleración recomendadas, duraciones precisas y pautas de rendimiento. Finalmente, enfatiza la accesibilidad (respetando `prefers-reduced-motion`) y una verificación de calidad rigurosa. Está diseñado para plataformas de frontend modernas (React, CSS, Web Animations API) y es ideal para desarrolladores que buscan pulir la experiencia de usuario sin caer en animaciones excesivas o inapropiadas.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/pbakaus/animate

Preguntar en tu IA favorita

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

Documentación

Analiza una funcionalidad y añade estratégicamente animaciones y micro-interacciones que mejoren la comprensión, proporcionen retroalimentación y creen deleite.

PREPARACIÓN OBLIGATORIA

Recopilación de Contexto (Haz esto primero)

No puedes hacer un buen trabajo sin tener el contexto necesario, como la audiencia objetivo (crítico), los casos de uso deseados (crítico), la personalidad/tono de la marca (lúdico vs serio, enérgico vs calmado) y las restricciones de rendimiento.

Intenta obtener esta información del hilo actual o del código base.

  1. Si no encuentras información exacta y tienes que inferir a partir del diseño y la funcionalidad existentes, DEBES DETENERTE y {{ask_instruction}} para confirmar si acertaste.
  2. De lo contrario, si no puedes inferir completamente o tu nivel de confianza es medio o inferior, DEBES {{ask_instruction}} preguntas aclaratorias primero para completar tu contexto.

No continúes hasta que tengas las respuestas. Adivinar lleva a animaciones inapropiadas o excesivas.

Usa el skill de diseño frontend

Usa el skill de diseño frontend para obtener principios de diseño y anti-patrones. NO continúes hasta que se haya ejecutado y conozcas todos los QUÉ HACER y QUÉ NO HACER.


Evalúa las Oportunidades de Animación

Analiza dónde el movimiento mejoraría la experiencia:

  1. Identifica áreas estáticas:

    • Falta de retroalimentación: Acciones sin reconocimiento visual (clics en botones, envío de formularios, etc.)
    • Transiciones bruscas: Cambios de estado instantáneos que se sienten abruptos (mostrar/ocultar, cargas de página, cambios de ruta)
    • Relaciones poco claras: Relaciones espaciales o jerárquicas que no son obvias
    • Falta de deleite: Interacciones funcionales pero sin alegría
    • Oportunidades de guía perdidas: Oportunidades para dirigir la atención o explicar el comportamiento
  2. Comprende el contexto:

    • ¿Cuál es la personalidad? (Lúdico vs serio, enérgico vs calmado)
    • ¿Cuál es el presupuesto de rendimiento? (¿Móvil primero? ¿Página compleja?)
    • ¿Quién es la audiencia? (¿Usuarios sensibles al movimiento? ¿Usuarios avanzados que quieren velocidad?)
    • ¿Qué es lo más importante? (¿Una animación estrella vs muchas micro-interacciones?)

Si algo de esto no está claro en el código base, {{ask_instruction}}

CRÍTICO: Respeta prefers-reduced-motion. Proporciona siempre alternativas no animadas para los usuarios que las necesiten.

Planifica la Estrategia de Animación

Crea un plan de animación con propósito:

  • Momento estrella: ¿Cuál es la ÚNICA animación emblemática? (¿Carga de página? ¿Sección principal? ¿Interacción clave?)
  • Capa de retroalimentación: ¿Qué interacciones necesitan reconocimiento?
  • Capa de transición: ¿Qué cambios de estado necesitan suavizado?
  • Capa de deleite: ¿Dónde podemos sorprender y deleitar?

IMPORTANTE: Una experiencia bien orquestada supera a las animaciones dispersas por todas partes. Concéntrate en los momentos de alto impacto.

Implementa las Animaciones

Añade movimiento sistemáticamente en estas categorías:

Animaciones de Entrada

  • Coreografía de carga de página: Revelaciones escalonadas de elementos (retardos de 100-150 ms), combinaciones de desvanecimiento y desplazamiento
  • Sección principal: Entrada dramática para el contenido primario (escala, paralaje o efectos creativos)
  • Revelaciones de contenido: Animaciones activadas por desplazamiento usando Intersection Observer
  • Entrada de modal/panel deslizante: Deslizamiento suave + desvanecimiento, desvanecimiento de fondo, gestión del foco

Micro-interacciones

  • Retroalimentación de botones:
    • Hover: Escala sutil (1.02-1.05), cambio de color, aumento de sombra
    • Clic: Escala rápida hacia abajo y luego hacia arriba (0.95 → 1), efecto de onda
    • Cargando: Estado de spinner o pulso
  • Interacciones de formularios:
    • Foco en campo: Transición de color de borde, escala o resplandor ligero
    • Validación: Sacudida en error, marca de verificación en éxito, transiciones de color suaves
  • Interruptores: Deslizamiento suave + transición de color (200-300 ms)
  • Casillas de verificación/botones de opción: Animación de marca, efecto de onda
  • Me gusta/favorito: Escala + rotación, efectos de partículas, transición de color

Transiciones de Estado

  • Mostrar/ocultar: Desvanecimiento + deslizamiento (no instantáneo), temporización adecuada (200-300 ms)
  • Expandir/contraer: Transición de altura con manejo de desbordamiento, rotación de icono
  • Estados de carga: Desvanecimiento de pantalla esqueleto, animaciones de spinner, barras de progreso
  • Éxito/error: Transiciones de color, animaciones de icono, pulso de escala suave
  • Activar/desactivar: Transiciones de opacidad, cambios de cursor

Navegación y Flujo

  • Transiciones de página: Fundido cruzado entre rutas, transiciones de elementos compartidos
  • Cambio de pestañas: Indicador deslizante, desvanecimiento/deslizamiento de contenido
  • Carrusel/deslizador: Transformaciones suaves, puntos de ajuste, momentum
  • Efectos de desplazamiento: Capas de paralaje, encabezados fijos con cambios de estado, indicadores de progreso de desplazamiento

Retroalimentación y Guía

  • Indicaciones al pasar el cursor: Aparición gradual de tooltips, cambios de cursor, resaltados de elementos
  • Arrastrar y soltar: Efecto de elevación (sombra + escala), resaltado de zona de destino, reposicionamiento suave
  • Copiar/pegar: Destello breve de resaltado al pegar, confirmación "copiado"
  • Flujo de enfoque: Resaltado del camino a través de un formulario o flujo de trabajo

Momentos de Deleite

  • Estados vacíos: Animaciones flotantes sutiles en ilustraciones
  • Acciones completadas: Confeti, floritura de marca de verificación, celebraciones de éxito
  • Huevos de pascua: Interacciones ocultas para descubrir
  • Animación contextual: Efectos climáticos, temas según la hora del día, toques estacionales

Implementación Técnica

Usa técnicas apropiadas para cada animación:

Temporización y Curvas de Aceleración

Duraciones por propósito:

  • 100-150 ms: Retroalimentación instantánea (presión de botón, interruptor)
  • 200-300 ms: Cambios de estado (hover, apertura de menú)
  • 300-500 ms: Cambios de diseño (acordeón, modal)
  • 500-800 ms: Animaciones de entrada (carga de página)

Curvas de aceleración (usa estas, no las predeterminadas de CSS):

/* Recomendadas - deceleración natural */
--ease-out-quart: cubic-bezier(0.25, 1, 0.5, 1);    /* Suave, refinado */
--ease-out-quint: cubic-bezier(0.22, 1, 0.36, 1);   /* Ligeramente más rápido */
--ease-out-expo: cubic-bezier(0.16, 1, 0.3, 1);     /* Firme, decisivo */

/* EVITAR - se sienten anticuados y de mal gusto */
/* bounce: cubic-bezier(0.34, 1.56, 0.64, 1); */
/* elastic: cubic-bezier(0.68, -0.6, 0.32, 1.6); */

Las animaciones de salida son más rápidas que las de entrada. Usa aproximadamente el 75% de la duración de entrada.

Animaciones CSS

/* Preferir para animaciones simples y declarativas */
- transiciones para cambios de estado
- @keyframes para secuencias complejas
- solo transform + opacity (aceleradas por GPU)

Animaciones con JavaScript

/* Usar para animaciones complejas e interactivas */
- Web Animations API para control programático
- Framer Motion para React
- GSAP para secuencias complejas

Rendimiento

  • Aceleración por GPU: Usa transform y opacity, evita propiedades de diseño
  • will-change: Añadir con moderación para animaciones costosas conocidas
  • Reducir pintado: Minimiza repintados, usa contain cuando sea apropiado
  • Monitorear FPS: Asegura 60 fps en los dispositivos objetivo

Accesibilidad

@media (prefers-reduced-motion: reduce) {
  * {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}

NUNCA:

  • Uses curvas de aceleración con rebote o elásticas: se sienten anticuadas y atraen la atención hacia la animación misma
  • Animes propiedades de diseño (width, height, top, left): usa transform en su lugar
  • Uses duraciones superiores a 500 ms para retroalimentación: se siente lento
  • Animes sin propósito: cada animación necesita una razón
  • Ignores prefers-reduced-motion: esto es una violación de accesibilidad
  • Animes todo: la fatiga de animación hace que las interfaces se sientan agotadoras
  • Bloquees la interacción durante las animaciones a menos que sea intencional

Verifica la Calidad

Prueba las animaciones a fondo:

  • Suave a 60 fps: Sin tirones en los dispositivos objetivo
  • Se siente natural: Las curvas de aceleración se sienten orgánicas, no robóticas
  • Temporización adecuada: Ni demasiado rápido (brusco) ni demasiado lento (lento)
  • Movimiento reducido funciona: Animaciones deshabilitadas o simplificadas adecuadamente
  • No bloquea: Los usuarios pueden interactuar durante/después de las animaciones
  • Añade valor: Hace la interfaz más clara o más agradable

Recuerda: El movimiento debe mejorar la comprensión y proporcionar retroalimentación, no solo añadir decoración. Anima con propósito, respeta las restricciones de rendimiento y considera siempre la accesibilidad. Una gran animación es invisible: solo hace que todo se sienta bien.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados