Communitygithub.com

interface-feel

Úsalo cuando una aplicación o sitio web deba sentirse más pulido, rápido o premium, al auditar o corregir la sensación de la interfaz, la animación, las transiciones o la calidad de interacción, o al aplicar leyes de UX, principios de animación o trucos de UI (Fitts, Hick, Doherty, actualizaciones optimistas, esqueletos, menú de comandos, toasts de deshacer, área de impacto, triángulo seguro, transiciones de vista) a un proyecto web o móvil.

¿Qué es interface-feel?

Interface-feel es una skill para agentes de IA (como Claude Code, Cursor o Codex) que audita y corrige la sensación de movimiento y respuesta de una interfaz de usuario en proyectos web y móviles. La skill revisa el código y la interfaz contra una lista de 40 elementos que incluye 12 principios de animación, 8 leyes de UX y 20 técnicas de UI, genera un informe y luego aplica correcciones siguiendo patrones específicos. Funciona mediante dos pases principales: primero realiza una auditoría sin cambios (usando un censo de código fuente y una sonda en vivo), y luego arregla los hallazgos clasificados como "construir" (cambios de comportamiento) o "elegir" (cambios visuales). Es útil para desarrolladores que buscan mejorar la velocidad percibida, la facilidad de uso, la confiabilidad y la calidad de la interacción, respetando el sistema de diseño existente del proyecto. Soporta herramientas como ripgrep para el censo rápido y se ejecuta en el navegador para la sonda.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/groseljgal/interface-feel/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

Sensación de interfaz

El pase maestro de cómo una interfaz se mueve y responde. Audita lo que la aplicación hace hoy contra cuarenta elementos (doce principios de animación, ocho leyes de UX, veinte técnicas de UI) y un sistema de movimiento, escribe un informe y luego corrige cada hallazgo según el patrón de ese elemento. La mayoría de las aplicaciones ya tienen la mitad de la lista; la auditoría lo indica en lugar de agregarlo dos veces. Velocidad, objetivos y confianza siempre se aplican; la decoración es moderada en una herramienta de trabajo.

El propio sistema de diseño del proyecto, tokens de movimiento y reglas tienen prioridad sobre cualquier cosa aquí. Los presupuestos de rendimiento (LCP, INP, tamaño del paquete), accesibilidad y copia son pases independientes al lado de este.

Archivos en esta skill

ArchivoUso
reference.mdcada uno de los 40 elementos: cómo verificarlo, el patrón de corrección, cuándo omitirlo, qué encontró una auditoría real
motion.mdel sistema de movimiento: tokens, doce reglas, patrones de CSS, cómo auditar el movimiento
audit/census.shcenso de código: cuenta los patrones detrás de cada elemento, con referencias archivo:línea
audit/probe.jssonda de página en vivo: objetivos reales, duraciones, easing, figuras, encabezados, campos de código, marcadores de posición
report-template.mdla plantilla del informe de auditoría: una fila de veredicto por elemento, orden de trabajo, lo que no se verificó

Pase 1: auditoría (sin cambios)

  1. Lee primero el sistema de diseño del proyecto, los tokens de movimiento y las reglas de UI.
  2. Ejecuta el censo desde la raíz del proyecto: bash <ruta de esta skill>/audit/census.sh . --show 5. Lee solo la superficie enviada (se excluyen dependencias, builds, copias vendidas, pruebas, benchmarks, archivos generados y líneas de comentario; agrega más con CENSUS_EXCLUDE="dir1,dir2"). Instala ripgrep para una ejecución rápida; sin él, el script recurre a perl. Un conteo es una pista para abrir, no un veredicto.
  3. Ejecuta la aplicación. En cada página clave ejecuta audit/probe.js (pégalo en la consola o usa await en el ejecutor de JavaScript de una herramienta del navegador) a 1440 píxeles de ancho y a 375, en cada tema que tenga la aplicación. Desplaza toda la página una pantalla a la vez y restaura la posición. Una pestaña oculta no tiene ancho ni pinta fotogramas: muéstrala primero. Lee su resultado con criterio: un objetivo marcado como spaced (su espacio hasta el siguiente control llega al piso) tiene menor gravedad; las figuras solo necesitan tabular-nums cuando cambian; marca las ventanas decorativas falsas con aria-hidden o ignora sus filas.
  4. Prueba manualmente lo que ningún script puede ver, con eventos de puntero reales (un clic de herramienta de navegador, no un .click() sintético): presiona cada acción paga o irreversible dos veces rápido y cuenta los efectos en el servidor; estrangula la red y una escritura a 600 ms y presiona; abre y cierra cada capa rápidamente y vuélvela a abrir a mitad de la salida, muestreando su opacidad (motion.md, "Midiendo una reapertura"); presiona dentro de un menú que se cierra; escribe una consulta con acentos y mayúsculas diferentes; muévete en diagonal hacia un submenú hover; botón de retroceso de Android con una capa abierta; desliza una hoja de teléfono.
  5. Escribe el informe a partir de report-template.md: las 40 filas, cada una presente, ausente, incorrecta o omitir con una razón, evidencia como archivo:línea o un número, y construir o elegir. Muéstralo antes de corregir.

Pase 2: corregir según la lista de verificación

  1. Confianza primero: elemento 39 y cualquier cosa que pueda duplicar un cargo o perder datos, con una prueba que falle antes de la corrección.
  2. Los elementos construir cambian el comportamiento sin una nueva apariencia (área de impacto, triángulo seguro, gesto de retroceso, plegado de acentos, atajos, entradas de menú de comandos, escrituras optimistas, esqueletos, tokens de movimiento, transiciones reversibles). Corrige cada uno según su patrón en reference.md y motion.md, a través de los componentes y tokens propios del proyecto, con una prueba para cualquier lógica.
  3. Los elementos elegir cambian la apariencia o el producto (esquinas, marcadores de posición borrosos, deshacer en lugar de confirmación, un latido de error, un nuevo latido de movimiento, una transición de vista). Evalúa cada uno como antes y después a escala 1 en ambos temas, numerados y separables; construye solo lo que el propietario elija.
  4. Nunca intercambies decoración eliminada por nueva decoración.

Pase 3: verificar

Vuelve a ejecutar el censo y la sonda y compara los números con el informe. Prueba cada interacción corregida como lo haría un usuario, en ambos temas, y por separado en ancho de teléfono. Informa construido, probado, aprobado visualmente y desplegado como hechos separados, y nombra lo que no se pudo medir (sin teléfono físico, sin build de producción).

La lista de verificación

Los números coinciden con reference.md y el informe.

#ElementoFallo cuando
APrincipios de animación (motion.md)
1Estirar y encogeruna insignia, punto o perilla de aterrizaje se detiene en seco
2Anticipaciónuna pulsación no tiene estado dentro de un fotograma (escala alrededor de 0.97, alrededor de 100 ms)
3Puesta en escenauna capa abierta deja poco claro el elemento principal
4Pose a poseun botón ocupado, etiqueta o intercambio de icono salta en ancho o contenido
5Seguimientoel contenido de una capa llega soldado a su contenedor
6Entrada lenta, salida lentalinear o ease predeterminado en movimiento de UI; más de tres easings
7Arcosalgo viaja lejos en línea recta
8Acción secundariauna acción completada no tiene un segundo latido de confirmación
9Tiempo rápidouna respuesta de UI superior a 300 ms; una superficie fuera de sus pares; las salidas no más cortas
10Retroalimentación exageradaun envío inválido muestra solo una sacudida, sin latido de color
11Dibujo sólidolas sombras y las capas no coinciden en luz y profundidad
12Atractivoun flujo real, recorrido a escala 1, muestra una costura
BLeyes de UX
13Fittsun objetivo real de menos de 32 píxeles en escritorio o 44 píxeles en teléfono
14Áreas de impacto más grandesobjetivos agrandados al ampliar la imagen, o hermanos superpuestos
15Hickmás de cinco elementos en un bloque de menú
16Millermás de aproximadamente siete elementos de nivel superior no agrupados
17Dohertydesde la pulsación hasta el siguiente pintado superior a 400 ms sin nada que responda primero
18Posteluna variante de acento, mayúsculas o espaciado de una consulta no encuentra nada
19Jakobun patrón se comporta de manera diferente a su plataforma (submenú hover, retroceso cierra una capa)
20Frecuencia de usouna acción diaria está a más de un paso o un comando de distancia
CVelocidad y retroalimentación
21Cargadores esqueletouna ruta pinta en blanco o un spinner en el fotograma del clic
22Actualizaciones optimistasuna escritura reversible barata no muestra nada hasta que el servidor responde
23Menú de comandosun destino es alcanzable haciendo clic pero no escribiendo
24Sugerencias de atajosun control con un atajo no lo muestra en su tooltip
25Toasts de deshacerun borrado restaurable no tiene deshacer (el propietario decide si reemplaza una confirmación)
26Stale-while-revalidateuna página revisitada espera en lugar de pintar sus últimos datos
27Pre-renderizadouna página probable siguiente no se precarga en la intención (juzgar en producción)
28Marcadores de posición borrososuna imagen cargando es una caja gris
29Transiciones de vistauna apertura de cuadrícula a detalle no tiene morph de elemento compartido
30Deslizar para descartaruna hoja o cajón de teléfono no se puede cerrar deslizando
31Animaciones interrumpiblesvolver a abrir durante una salida reproduce desde cero
DPlataforma y detalle
32Retroceso predictivoRetroceso de Android con una capa abierta abandona la página
33Área de impactocontroles de icono pequeños no llevan crecimiento de objetivo invisible
34Inserción de área seguraflotantes inferiores ignoran env(safe-area-inset-*) bajo viewport-fit=cover
35Autocompletado de código únicoun campo de código carece de autocomplete="one-time-code" y inputmode="numeric"
36Números tabularesfiguras cambiantes saltan (sin tabular-nums)
37Encabezados equilibradosun encabezado corto de varias líneas deja un huérfano (sin text-wrap: balance)
38Esquinas continuasesquinas de squircle no consideradas (una decisión estética: evaluarlo)
EConfianza
39Claves de idempotenciados pulsaciones rápidas de una acción paga o irreversible causan dos efectos en el servidor
40Triángulo seguroun submenú hover se cierra en un movimiento diagonal hacia él

Errores comunes

  • Agregar lo que ya existe: los esqueletos, el almacenamiento en caché y los tokens de movimiento a menudo ya están; el veredicto es presente.
  • Desduplicación del cliente como guardia de dinero: dos clics llegan antes de que un re-render deshabilite el botón. Protege en el servidor (actualización condicional, clave determinista, bloqueo) y mantén la pulsación en una ref.
  • Agrandar la imagen en lugar del objetivo; verificar objetivos solo en ancho de escritorio mientras una regla de escritorio elimina el piso del teléfono.
  • Keyframes para abrir y cerrar: no se pueden revertir. Usa transiciones en un atributo de estado, y haz que una capa saliente sea inert.
  • Tratar deshacer, esquinas o tono de error como decisiones de ingeniería. Pertenecen al propietario.
  • Juzgar precarga o sincronización en un servidor de desarrollo o una pestaña de fondo.

Skills relacionados