Communitygithub.com

ulasalyesil/personal-website-v2

Diseñar e implementar microinteracciones, diseño de movimiento, transiciones y patrones de retroalimentación de usuario. Úsalo para añadir pulido a las interacciones de la interfaz de usuario, implementar estados de carga o crear experiencias de usuario agradables.

¿Qué es personal-website-v2?

Esta habilidad está diseñada para ayudar a desarrolladores y agentes de IA a crear interacciones de usuario atractivas e intuitivas mediante animaciones, transiciones y patrones de retroalimentación. Es especialmente útil para mejorar la experiencia del usuario (UX) en aplicaciones web, añadiendo detalles como microinteracciones (botones que reaccionan al clic), estados de carga con esqueletos visuales, transiciones suaves entre páginas e incluso interacciones basadas en gestos como deslizar para descartar. La habilidad proporciona ejemplos de código prácticos y reutilizables utilizando bibliotecas modernas como Framer Motion y CSS estándar, y enfatiza principios de diseño como el movimiento con propósito (para dar retroalimentación o guiar la atención) y el respeto por las preferencias de reducción de movimiento del usuario. Se basa en el documento SKILL.md original, que actúa como una guía completa con mejores prácticas, pautas de tiempos de animación, funciones de aceleración y consideraciones de accesibilidad.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/interaction-design

Preguntar en tu IA favorita

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

Documentación

Diseño de Interacción

Crea interacciones atractivas e intuitivas a través del movimiento, la retroalimentación y transiciones de estado bien pensadas que mejoren la usabilidad y deleiten a los usuarios.

Cuándo Usar Esta Habilidad

  • Añadir microinteracciones para mejorar la retroalimentación del usuario
  • Implementar transiciones suaves de páginas y componentes
  • Diseñar estados de carga y pantallas esqueleto
  • Crear interacciones basadas en gestos
  • Construir sistemas de notificaciones y toasts
  • Implementar interfaces de arrastrar y soltar
  • Añadir animaciones activadas por desplazamiento
  • Diseñar estados de hover y focus

Principios Fundamentales

1. Movimiento con Propósito

El movimiento debe comunicar, no decorar:

  • Retroalimentación: Confirmar que las acciones del usuario ocurrieron
  • Orientación: Mostrar de dónde vienen y a dónde van los elementos
  • Enfoque: Dirigir la atención hacia cambios importantes
  • Continuidad: Mantener el contexto durante las transiciones

2. Pautas de Temporización

DuraciónCaso de Uso
100-150 msMicro-retroalimentación (hovers, clics)
200-300 msTransiciones pequeñas (toggles, desplegables)
300-500 msTransiciones medianas (modales, cambios de página)
500 ms+Animaciones coreografiadas complejas

3. Funciones de Aceleración

/* Aceleraciones comunes */
--ease-out: cubic-bezier(0.16, 1, 0.3, 1); /* Desacelerar - entrada */
--ease-in: cubic-bezier(0.55, 0, 1, 0.45); /* Acelerar - salida */
--ease-in-out: cubic-bezier(0.65, 0, 0.35, 1); /* Ambos - moverse entre */
--spring: cubic-bezier(0.34, 1.56, 0.64, 1); /* Sobreimpulso - juguetón */

Inicio Rápido: Microinteracción de Botón

import { motion } from "framer-motion";

export function InteractiveButton({ children, onClick }) {
  return (
    <motion.button
      onClick={onClick}
      whileHover={{ scale: 1.02 }}
      whileTap={{ scale: 0.98 }}
      transition={{ type: "spring", stiffness: 400, damping: 17 }}
      className="px-4 py-2 bg-blue-600 text-white rounded-lg"
    >
      {children}
    </motion.button>
  );
}

Patrones de Interacción

1. Estados de Carga

Pantallas Esqueleto: Preservar el diseño mientras se carga

function CardSkeleton() {
  return (
    <div className="animate-pulse">
      <div className="h-48 bg-gray-200 rounded-lg" />
      <div className="mt-4 h-4 bg-gray-200 rounded w-3/4" />
      <div className="mt-2 h-4 bg-gray-200 rounded w-1/2" />
    </div>
  );
}

Indicadores de Progreso: Mostrar progreso determinado

function ProgressBar({ progress }: { progress: number }) {
  return (
    <div className="h-2 bg-gray-200 rounded-full overflow-hidden">
      <motion.div
        className="h-full bg-blue-600"
        initial={{ width: 0 }}
        animate={{ width: `${progress}%` }}
        transition={{ ease: "easeOut" }}
      />
    </div>
  );
}

2. Transiciones de Estado

Toggle con transición suave:

function Toggle({ checked, onChange }) {
  return (
    <button
      role="switch"
      aria-checked={checked}
      onClick={() => onChange(!checked)}
      className={`
        relative w-12 h-6 rounded-full transition-colors duration-200
        ${checked ? "bg-blue-600" : "bg-gray-300"}
      `}
    >
      <motion.span
        className="absolute top-1 left-1 w-4 h-4 bg-white rounded-full shadow"
        animate={{ x: checked ? 24 : 0 }}
        transition={{ type: "spring", stiffness: 500, damping: 30 }}
      />
    </button>
  );
}

3. Transiciones de Página

Animaciones de diseño con Framer Motion:

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

function PageTransition({ children, key }) {
  return (
    <AnimatePresence mode="wait">
      <motion.div
        key={key}
        initial={{ opacity: 0, y: 20 }}
        animate={{ opacity: 1, y: 0 }}
        exit={{ opacity: 0, y: -20 }}
        transition={{ duration: 0.3 }}
      >
        {children}
      </motion.div>
    </AnimatePresence>
  );
}

4. Patrones de Retroalimentación

Efecto de onda en clic:

function RippleButton({ children, onClick }) {
  const [ripples, setRipples] = useState([]);

  const handleClick = (e) => {
    const rect = e.currentTarget.getBoundingClientRect();
    const ripple = {
      x: e.clientX - rect.left,
      y: e.clientY - rect.top,
      id: Date.now(),
    };
    setRipples((prev) => [...prev, ripple]);
    setTimeout(() => {
      setRipples((prev) => prev.filter((r) => r.id !== ripple.id));
    }, 600);
    onClick?.(e);
  };

  return (
    <button onClick={handleClick} className="relative overflow-hidden">
      {children}
      {ripples.map((ripple) => (
        <span
          key={ripple.id}
          className="absolute bg-white/30 rounded-full animate-ripple"
          style={{ left: ripple.x, top: ripple.y }}
        />
      ))}
    </button>
  );
}

5. Interacciones por Gesto

Deslizar para descartar:

function SwipeCard({ children, onDismiss }) {
  return (
    <motion.div
      drag="x"
      dragConstraints={{ left: 0, right: 0 }}
      onDragEnd={(_, info) => {
        if (Math.abs(info.offset.x) > 100) {
          onDismiss();
        }
      }}
      className="cursor-grab active:cursor-grabbing"
    >
      {children}
    </motion.div>
  );
}

Patrones de Animación CSS

Animaciones con Keyframes

@keyframes fadeIn {
  from {
    opacity: 0;
    transform: translateY(10px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

@keyframes pulse {
  0%,
  100% {
    opacity: 1;
  }
  50% {
    opacity: 0.5;
  }
}

@keyframes spin {
  to {
    transform: rotate(360deg);
  }
}

.animate-fadeIn {
  animation: fadeIn 0.3s ease-out;
}
.animate-pulse {
  animation: pulse 2s ease-in-out infinite;
}
.animate-spin {
  animation: spin 1s linear infinite;
}

Transiciones CSS

.card {
  transition:
    transform 0.2s ease-out,
    box-shadow 0.2s ease-out;
}

.card:hover {
  transform: translateY(-4px);
  box-shadow: 0 12px 24px rgba(0, 0, 0, 0.1);
}

Consideraciones de Accesibilidad

/* Respetar las preferencias de movimiento del usuario */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}
function AnimatedComponent() {
  const prefersReducedMotion = window.matchMedia(
    "(prefers-reduced-motion: reduce)",
  ).matches;

  return (
    <motion.div
      animate={{ opacity: 1 }}
      transition={{ duration: prefersReducedMotion ? 0 : 0.3 }}
    />
  );
}

Mejores Prácticas

  1. Rendimiento Primero: Usa transform y opacity para 60fps suaves
  2. Soporte para Reducir Movimiento: Respeta siempre prefers-reduced-motion
  3. Temporización Consistente: Usa una escala de temporización en toda la aplicación
  4. Física Natural: Prefiere animaciones de resorte sobre lineales
  5. Interrumpibles: Permite a los usuarios cancelar animaciones largas
  6. Mejora Progresiva: Funciona sin animaciones JS
  7. Pruebas en Dispositivos: El rendimiento varía significativamente

Problemas Comunes

  • Animaciones Entrecortadas: Evita animar width, height, top, left
  • Sobre-animación: Demasiado movimiento causa fatiga
  • Interacciones Bloqueantes: Nunca impidas la entrada del usuario durante las animaciones
  • Fugas de Memoria: Limpia los listeners de animación al desmontar
  • Destello de Contenido: Usa will-change con moderación para optimizar

Recursos

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Skills relacionados