Ir a la guía de uso
make-interfaces-feel-betterpor Jakub Krehel

Make Interfaces Feel Better Skill.

Un skill de Claude Code y Codex para investigación UX: principios de ingeniería de diseño para hover, sombra, borde, icono, tipografía y pulido de microinteracciones.

  • UX & Research
jakubkrehel/make-interfaces-feel-better · skills/make-interfaces-feel-better/SKILL.mdSKILL.md
--- name: make-interfaces-feel-better description: - Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, typography, icons, micro-interactions, enter/exit animations, or any visual detail work. Supports quick and full review modes. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border … --- ## Core Principles ## Common Mistakes ## Review Output Format
Encabezados de sección y metadatos leídos del archivo original el 14 de septiembre de 2026 · 11 798 caracteres en total

01 Qué hace

Qué hace la Skill make-interfaces-feel-better en Claude Code y Codex

Resumen, flujo de trabajo y resultados, todo leído del SKILL.md del skill.

Del SKILL.mdLeído 2026-09-14 · no es una ejecución registrada

En los propios términos del Skill

Principios de ingeniería de diseño para lograr que las interfaces se perciban pulidas, escritos para cualquiera que construya componentes de UI o revise código frontend: estados hover, sombras, bordes, tipografía, iconos, microinteracciones y animaciones de entrada/salida.

Incluye diecinueve principios centrales numerados con valores predeterminados estrictos: radio de borde concéntrico, alineación óptica, sombras en capas (box-shadow) en lugar de bordes de falsa elevación, transiciones CSS interrumpibles, escalonado de alrededor de 100ms, texto suavizado (antialiased), números tabulares, contornos de imagen en negro o blanco puro, scale(0.96) al pulsar, áreas de contacto de 44×44px y grosor de trazo de icono equiparado al del texto. Dos modos de revisión, rápido y completo, producen una tabla de Severidad/Ubicación/Antes/Después/Por qué agrupada por principio, con un máximo de 5 o 15 hallazgos, que termina en Bloquear, Necesita cambios o Aprobar.

Qué produce

  • Un informe de revisión que indica desde el principio qué se inspeccionó y que nunca da a entender que una superficie no inspeccionada fue cubierta.
  • Hallazgos agrupados por principio dentro de una tabla de Severidad, Ubicación, Antes, Después, Por qué que enumera cada cambio realizado o propuesto en lugar de un subconjunto.
  • Una tabla de Considerado pero Rechazado con 1–3 candidatos reales en modo rápido y 2–5 en modo completo, cada uno con el motivo por el que se descartó.
  • Una sección de verificación que enumera los comandos o interacciones exactos ejecutados y sus resultados observados, seguida del veredicto.
Ver el ejemplo de prompt ↗

Cómo funciona

  1. 01
    Expresar las correcciones en el propio sistema de estilos del proyecto

    Antes de proponer o escribir cualquier corrección, identifique cómo el proyecto ya aplica estilos y formule el cambio dentro de ese sistema: Tailwind en un proyecto Tailwind, CSS plano en un proyecto CSS, o el enfoque de CSS-in-JS ya establecido.

  2. 02
    Ralentice la interfaz

    Al revisar, reproduzca el movimiento al 10% de velocidad en el panel Animations del navegador, porque lo que se ve mal al 10% de velocidad es lo que está sutilmente mal a velocidad normal.

  3. 03
    Por defecto, modo completo

    El modo full se usa siempre que no se indique un modo de revisión; el modo quick debe solicitarse explícitamente.

  4. 04
    Escriba los hallazgos en un formato de tabla fijo

    Agrupe los hallazgos por principio en una tabla markdown con las columnas Severity, Location, Before, After y Why; la ubicación cita path/to/file:line.

  5. 05
    Tenga en cuenta las cinco categorías

    La tabla de alcance debe incluir las cinco categorías del Quick Reference, y nunca debe darse a entender que una superficie no inspeccionada fue revisada.

  6. 06
    Cierre con verificación y un veredicto

    El veredicto es Block cuando queda un hallazgo HIGH, Needs changes cuando solo quedan hallazgos MEDIUM o LOW, y Approve solo cuando no queda nada procesable.

02 Encuentra tu caso de uso

Cuándo Usar el Skill make-interfaces-feel-better

Usa el skill make-interfaces-feel-better en Claude Code o Codex cuando el trabajo sea investigación UX de este tipo. El ajuste y los límites a continuación están tomados del propio archivo del skill.

Buen caso de uso

  • Construir o revisar componentes de UI donde el trabajo de detalle visual importa: animaciones, estados hover, sombras, bordes, tipografía, iconos, microinteracciones y transiciones de entrada/salida.
  • Un repaso rápido de la ruta principal del usuario y los estados de mayor tráfico, informando solo problemas HIGH y MEDIUM.
  • Una auditoría exhaustiva de todo el alcance solicitado que abarca tipografía, superficies, animaciones, iconos y rendimiento.
  • Proyectos que ya tienen una convención de estilos, de modo que las correcciones de pulido se apliquen en Tailwind, CSS plano o CSS-in-JS según corresponda.

Conozca los límites

  • No añadirá un segundo sistema de estilos a un proyecto solo para entregar una corrección de pulido.
  • Rechaza la animación personalizada en interacciones de alta frecuencia, ya que el costo de atención se repite en cada activación.
  • No escalona las interacciones rutinarias, solo las entradas escalonadas poco frecuentes.
  • Los bordes mantenidos solo para simular elevación deben reemplazarse por valores box-shadow transparentes en capas; los bordes estructurales y de estado se mantienen.

Qué proporcionar

  • package.jsonNecesario para decidir la ruta de animación del icono: comprobar si motion o framer-motion está instalado, y ajustarse a la ruta de importación establecida.
  • Archivos fuente o pantallas exactasLos hallazgos citan path/to/file:line; cuando el artefacto no tiene archivos fuente, se cita en su lugar la pantalla y el componente exactos.
  • Modo, alcance y contexto del frameworkIndique el modo, el alcance exacto, el framework, las convenciones de estilos y cualquier límite de revisión para que el informe muestre lo que realmente se inspeccionó.

03 Dentro del skill

Reglas que el Skill make-interfaces-feel-better da a Claude Code y Codex

8 instrucciones concretas, valores por defecto y límites que SKILL.md fija para el agente: la parte del archivo que cambia el resultado.

  1. Calcule radios concéntricos

    Las esquinas anidadas deben ser concéntricas: el radio exterior es igual al radio interior más el padding.

  2. Siempre pulsar a 0.96

    La escala del clic está fijada en scale(0.96) y nunca por debajo de 0.95; cualquier valor menor se percibe como exagerado. Una prop estática la desactiva cuando el movimiento distraería.

  3. Los contornos de imagen se mantienen neutros puros

    El contorno de imagen de 1px con baja opacidad debe ser negro puro en modo claro y blanco puro en modo oscuro; nunca un neutro con tinte como slate o zinc, que adquiere el color de la superficie y se percibe como suciedad.

  4. Nunca aplicar transition a todo

    Enumere las propiedades exactas, como transition-property: scale, opacity. El transition-transform de Tailwind cubre transform, translate, scale y rotate.

  5. Ajustar el grosor del trazo del icono al peso del texto

    Un trazo de 1.5px acompaña al texto regular 400, y uno de 2px al semibold 600. Mantenga un solo grosor de trazo por conjunto de iconos y nunca mezcle bibliotecas de iconos en una misma superficie.

  6. Usar los valores exactos de animación de iconos

    Los cambios contextuales de icono se animan mediante scale, opacity y blur —no visibility— y esos valores son fijos, no improvisados.

  7. Escalonar solo las entradas poco frecuentes

    Divida una entrada escalonada en bloques semánticos y escalónelos aproximadamente 100ms en lugar de animar un solo contenedor. Las interacciones rutinarias y de alta frecuencia no deben escalonarse.

  8. Dimensionar las áreas táctiles de forma deliberada

    Prefiera un área táctil de 44×44px para touch o mobile, y al menos 40×40px en interfaces de escritorio densas, extendiendo los elementos visibles más pequeños con un pseudo-elemento.

04 Ponlo a trabajar

Instala make-interfaces-feel-better en Claude Code o Codex

Un comando npx skills add, luego una primera tarea en tu agente y una lista de verificación para el resultado.

Agrega make-interfaces-feel-better a Claude Code, Codex o Tu Agente

Ejecútelo en su proyecto; el instalador pregunta a qué agente añadirlo.

Terminal
npx skills add https://github.com/jakubkrehel/make-interfaces-feel-better --skill make-interfaces-feel-better

Forma genérica de la CLI skills para skills/make-interfaces-feel-better/SKILL.md; el repositorio puede documentar su propia ruta.

Dale al Skill una Primera Tarea de Investigación UX

Redactado en los términos del propio skill; sustituya las partes entre corchetes por su material.

Starter prompt
Review [src/components/] in full mode. The card and its inner button both use rounded-xl, the counter shifts when the value changes, and the outline-to-fill icon swap exits with a jarring fade. Express every fix in [our existing styling system] and give me a Severity/Location/Before/After/Why table.

Fuente: redactado a partir del SKILL.md en los términos del propio skill.

Revisa el primer resultado

Lo que el propio SKILL.md indica que debe ser un resultado correcto:

  • Recorra todos los estados de la interfaz —hover, focus, active, loading y empty— como parte de la revisión.
  • Enumere junto al veredicto cada comprobación que no se realizó como No verificado, indicando qué queda pendiente.
  • Cuando se aplique initial={false}, confirme que no rompe las animaciones de entrada intencionadas.
  • No rellene el informe para alcanzar el límite de hallazgos, y omita los principios sin hallazgos.

En OpenDesign importe make-interfaces-feel-better desde su enlace de SKILL.md: Plugins → Add → Skill → Import from link, y luego selecciónelo en la barra superior.

05 Código abierto, rastreable

Fuente, Licencia y Verificación

De dónde provienen los datos de esta página y cuándo se verificaron por última vez.

Archivo de skill
skills/make-interfaces-feel-better/SKILL.md Checksum de contenido registrado en la verificación; commit 35545ea
License
MIT De LICENSE.
Estrellas del repositorio
3,433 Instantánea de GitHub tomada el 2026-09-14 para todo el repositorio jakubkrehel/make-interfaces-feel-better. No es una calificación ni un conteo de uso para make-interfaces-feel-better.
Verificado por OpenDesign
14/09/2026 Se verificaron el archivo fuente, la ruta, el texto de licencia y el recuento de estrellas. No incluido en OpenDesign principal (verificado el 28/08/2026); no se ha registrado una ejecución en vivo en esta página.

Dentro del SKILL.md

  1. Referencia rápidaCinco categorías —tipografía, superficies, animaciones, iconos, rendimiento— cada una asociada a cuándo usarla.
  2. Principios fundamentalesDiecinueve reglas numeradas, desde el radio de borde concéntrico hasta la moderación del movimiento, con valores por defecto exactos.
  3. Errores comunesTabla que asocia cada error frecuente con su solución, como transition: all y áreas táctiles diminutas.
  4. Formato de salida de la revisiónModos, cobertura, límites de hallazgos, definiciones de severidad y la estructura de informe requerida.
  5. Alcance y coberturaIndique el modo, el alcance, el framework y las convenciones; enumere las cinco categorías con la evidencia inspeccionada y el resultado.
  6. HallazgosAgrupe por principio en una tabla de Severidad, Ubicación, Antes, Después y Por qué que cubra cada cambio.
  7. EjemploTablas resueltas para radio de borde concéntrico, números tabulares y escala al pulsar.
  8. Considerado pero rechazadoTabla de candidatos límite reales que fueron rechazados, con el motivo indicado.
  9. Verificación y veredictoEnumere los comandos o interacciones ejecutados, marque las comprobaciones no verificadas y luego indique Bloquear, Necesita cambios o Aprobar.
La descripción propia del Skill
"- Principios de ingeniería de diseño para hacer que las interfaces se sientan pulidas. Usa cuando construyas componentes de UI, revises código frontend, implementes animaciones, estados hover, sombras, bordes, tipografía, íconos, microinteracciones, animaciones de entrada/salida o cualquier trabajo de detalle visual. Soporta modos de revisión rápida y completa. Se activa con pulido de UI, detalles de diseño, "hazlo sentir mejor", "se siente raro", animaciones escalonadas, border radius, alineación óptica, font smoothing, números tabulares, contornos de imagen, box shadows, íconos, grosor de trazo de ícono, estados de ícono, restricción de movimiento."

Descripción del encabezado de SKILL.md. El archivo completo tiene aproximadamente 11,798 caracteres. Lee el archivo completo en GitHub.

06 Antes de instalar

Preguntas sobre el skill make-interfaces-feel-better

Las respuestas provienen del SKILL.md tal como se leyó el 2026-09-14, no de una ejecución registrada.

¿Necesito una librería de animación para las animaciones de iconos contextuales?

No. Si no hay ninguna librería de animación instalada, el archivo mantiene ambos iconos en el DOM, con uno posicionado de forma absoluta, y los funde con transiciones CSS, lo que proporciona animaciones de entrada y salida sin ninguna dependencia.

Se reproduce una animación de entrada al cargar la página; ¿cómo se maneja eso?

El archivo lo evita con initial={false} en AnimatePresence, lo que detiene las animaciones de entrada en el primer renderizado, y luego le pide que confirme que esto no rompe animaciones de entrada intencionales.

¿Una revisión también cubre el rendimiento además de lo visual?

Sí, el rendimiento es una de las cinco categorías de la Referencia rápida, centrada en la especificidad de las transiciones y el uso de will-change. will-change se limita a transform, opacity y filter —las propiedades que la GPU puede componer— y will-change: all nunca se utiliza.

Make Interfaces Feel Better

Ejecuta make-interfaces-feel-better en una Tarea de Investigación UX Real.

Descarga OpenDesign, importa make-interfaces-feel-better desde su enlace SKILL.md, pega el prompt de arriba y lee el plan antes del resultado.

Terminal
npx skills add https://github.com/jakubkrehel/make-interfaces-feel-better --skill make-interfaces-feel-better

OpenDesign Desktop

Un sistema de diseño. Tu marca, coherente en cada resultado

En el Vibe Design Workspace completo, aplica las mismas reglas de marca a sitios web, presentaciones, prototipos interactivos, dashboards, imágenes y vídeo HTML. Conecta Codex, Claude Code, Cursor y otros agentes de código locales y crea gratis.

  • Web, presentaciones, prototipos, dashboards, imágenes y vídeo
  • Más de 140 sistemas de diseño y la biblioteca completa de plantillas y skills
  • Codex local y más de 21 agentes de código · Gratis
Descargar gratis

Disponible para macOS y Windows