Communitygithub.com

omd:feel — Sensaciones de Interfaz Cuantificadas

Cuantifica y aplica o audita los detalles de interfaz que la industria solía manejar 'por intuición', basándose en una filosofía de 17 ejes y 113 reglas con niveles de procedencia, desde especificaciones W3C hasta tokens de diseño.

¿Qué es omd:feel — Sensaciones de Interfaz Cuantificadas?

omd:feel es un skill para agentes de IA (Claude Code, Cursor, Codex, etc.) que transforma los detalles subjetivos de una interfaz — velocidades, sombras, espaciados — en reglas cuantificables y verificables. Basado en la filosofía de Jakub Krehel de que 'las grandes interfaces son una colección de pequeños detalles que se acumulan', el skill expande esta idea con 17 ejes y 113 reglas clasificadas por nivel de procedencia: SPEC (normativo, p. ej. WCAG), DS (tokens de diseño), CONV (consenso de la industria), OP (opinión de un experto) y FOLK (folclore no verificado). El 85% de las reglas son forzables con evidencia sólida. Soporta dos modos principales: APPLY, para inyectar estas reglas al crear o modificar una UI (por ejemplo, 'haz que esto se sienta mejor'), y AUDIT, para inspeccionar código HTML/JSX/TSX/CSS existente y generar un informe con puntuación 'feel-score', bloqueos (BLOCK), advertencias (WARN) y sugerencias (FYI). Si el proyecto tiene un archivo `DESIGN.md`, el skill prioriza sus tokens de marca sobre las reglas por defecto. Es especialmente útil para pulir microinteracciones, asegurar accesibilidad y consistencia visual, y mantener estándares de rendimiento y diseño en interfaces de usuario.

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

Preguntar en tu IA favorita

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

Documentación

¿Qué hace omd:feel — Sensaciones de Interfaz Cuantificadas?

Un skill que convierte los detalles de interfaz que la industria manejaba por intuición — "esta velocidad", "esta sombra", "este margen" — en números verificables con niveles de procedencia para aplicarlos y auditarlos. Hereda la premisa de Jakub Krehel de que "las grandes interfaces son una colección de pequeños detalles que se acumulan", pero responde con cifras: qué números hay que cumplir / cuándo se incumplen.

Insight clave: la calidad es la integral de decenas de pequeñas restricciones confinadas dentro de su banda. Un checkbox que tarda 600ms, un focus ring de 1px, un contraste de texto de 2.85:1, un hover lift sin @media (hover:hover) — cada uno es una resta medible de la "sensación". Este skill evita esa resta.

Todas las reglas (17 ejes, 113 reglas) están en reference.md; el origen, nivel y metodología de cada número está en provenance.md. El cheat-sheet de abajo es el núcleo que se carga siempre; para auditorías profundas o ejes marginales, consulta la referencia.

Cuándo usarlo

  • APPLY — Inyecta reglas cuantitativas de "sensación" al crear o modificar una UI. ("mejora la sensación", "pule la interacción", "aplica los detalles")
  • AUDIT — Inspecciona HTML/JSX/TSX/CSS existente contra la tabla de reglas y genera un informe con feel-score + BLOCK/WARN/FYI. ("revisa la sensación", "audita esta pantalla")

No se activa si la tarea no es de UI. Trabajos que solo tratan copy o arquitectura de información no aplican.

0. Nivel de procedencia → Intensidad de aplicación (el corazón del skill)

Cada regla lleva un nivel (tier), y el tier determina la fuerza de aplicación. Así es como se cuantifica honestamente la intuición: los números de especificación son puertas obligatorias, los números de gusto son sugerencias.

BadgeTierAPPLYseveridad AUDIT
🟢 SPECspec-authoritative (W3C/WCAG·HIG·normativo)ForzosoBLOCK
🟢 DSds-token (tokens de sistema de diseño confirmados)Forzoso (si la marca no lo sobreescribe)BLOCK
🟡 CONVindustry-convention (≥2 profesionales independientes convergen)Se aplica por defectoWARN
⚪ OPsingle-opinion (1 persona de confianza)Solo sugerenciaFYI
⚪ FOLKfolklore-unverified (sin rastro de evidencia)Sugerencia + indicar tierFYI

Distribución: SPEC 61 · DS 24 · CONV 19 · OP 7 · FOLK 2 → 85/113 con evidencia especificativa o de token (forzables).

DESIGN.md siempre gana. Si los tokens de la marca en DESIGN.md chocan con una regla, los tokens de marca tienen autoridad. Estas reglas son valores por defecto cuando la marca calla, no una sobreescritura. Si existe DESIGN.md en la raíz del proyecto, primero se leen sus tokens con omd:apply y solo los ejes que queden vacíos se rellenan con reglas de feel.

1. Cheat-sheet — Núcleo de números que se aplican siempre

Indicación de tier: 🟢=forzoso, 🟡=por defecto, ⚪=sugerencia. En caso de conflicto: DESIGN.md > 🟢 > 🟡 > ⚪.

Movimiento y temporización

  • Transiciones de UI cotidianas ~200ms (hover ≤150 · popover ~200 · overlay/modal ~300). Rango 150–300ms, >400ms se ve lento. 🟡
  • La duración se cuantiza en cuadrícula de 50ms (prohibido 220/333ms). 🟢
  • salida ≈ 0.8 × entrada (más rápido al cerrar que al abrir). 🟢
  • Prohibido una duración global única — debe ser proporcional al área/distancia de movimiento. 🟢

Easing y muelles (springs)

  • entrada/desencadenada por usuario = ease-out cubic-bezier(0,0,0.2,1) · salida = ease-in/aceleración · morph ya visible = ease-in-out · spinner/progress = linear. Prohibido ease-in en entrada. 🟡
  • Apple = spring por defecto (response 0.55, damping 0.825, bounce 0), en UI funcional bounce <0.4. 🟢
  • Interrumpible: los estados interactivos usan transition/spring (pueden re-target), solo las animaciones de una sola vez usan @keyframes. 🟢

Espaciado · Radio · Ritmo

  • Base 8px, medio paso 4px (4·8·12·16·24·32·40·48·64). 🟢
  • padding interno ≤ gap externo entre hermanos. 🟡
  • Radio concéntrico: outer = inner + padding. 🟢
  • Escala tipográfica de UI ~1.25 (tercera mayor). 🟡

Sombra y profundidad

  • Sombras en capas de 3 a 5, una única fuente de luz arriba. Baja elevación = apretada+definida, alta elevación = difusa+amplia (rampa Tailwind md→lg). 🟡/DS
  • Modo oscuro: profundidad mediante superficies más claras en lugar de sombras. 🟡

Tipografía

  • line-height 1.5 para cuerpo, medida ~66ch (45–75). 🟢
  • tracking de display −0.02~−0.03em, todo mayúsculas +0.05~0.1em, cuerpo ~0. 🟡
  • Números variables: tabular-nums; títulos text-wrap: balance, cuerpo pretty; usos de layout antialiased. (seed/jakub) 🟡

Color y contraste

  • Texto 4.5:1 (grande 3:1) AA · no texto/límites UI 3:1 · focus ring 3:1 + 2px + offset ~2px. 🟢
  • Capas de estado M3: hover 8% · focus 10% · pressed 10% · dragged 16%. 🟢
  • deshabilitado ~38% de opacidad. 🟡

Estados y retroalimentación

  • Los componentes de datos deben definir los 5 estados (vacío/carga/error/contenido/esqueleto). 🟡
  • presionado: escala 0.96–0.97, 150ms ease-out (límite inferior 0.95). DS/⚪
  • Cambio de estado de iconos: escala+opacidad+blur 4px→0, spring ~0.3. 🟡

Objetivos y puntero

  • Objetivo táctil 44pt(iOS/WCAG AAA) / 48dp(Material) / 24px(WCAG AA mínimo), distancia entre objetivos adyacentes ≥8pt. 🟢
  • cursor: interactivo=pointer · deshabilitado=not-allowed · arrastre=grab→grabbing · edición=text. 🟡

Scroll y gestos

  • Superposiciones/scroll anidados: overscroll-behavior: contain (evita encadenamiento de scroll y PTR). 🟢
  • Umbral de liberación de swipe ~30% de distancia o velocidad flick. DS
  • scroll-snap: formularios largos=proximity · carrusel=mandatory. 🟢

Tiempo de respuesta y percepción de rendimiento

  • 100ms = instantáneo · 1s = límite del flujo mental · 10s = límite de atención (mostrar % de progreso). Techo de Doherty 400ms. 🟢
  • INP ≤200ms p75, presupuesto de frame 16.6ms. 🟢
  • Spinner solo si la espera prevista >1s; si se muestra, mantener al menos 500ms (evitar parpadeos). Si se conoce el layout, usar skeleton. 🟡/DS

Estabilidad del layout (CLS)

  • CLS ≤0.1 p75. Los medios deben reservar espacio con width/height o aspect-ratio. scrollbar-gutter: stable. font-display: optional (o swap) + metric override. Prohibido insertar contenido arriba fuera de la ventana de 500ms posterior a la entrada. 🟢

Modales · Superposiciones · Z-index

  • role=dialog + aria-modal=true, al abrir enfocar el diálogo, trampa de Tab, cierre con Esc, al cerrar restaurar el foco al elemento que lo abrió, fondo inert. scrim #000 ~32%. 🟢
  • light-dismiss: diálogos temporales/de información SÍ, entrada de datos/acciones destructivas NO. 🟢
  • Escalera z: dropdown 1000 / sticky 1100 / fixed 1200 / backdrop 1300 / modal 1400 / popover 1500 / toast 1600 / tooltip 1700. Las superposiciones usan portal. (relleno de huecos)

Rendimiento · Cristal · Accesibilidad

  • Animaciones solo con transform/opacity(+filter), prohibido transition: all; will-change es transitorio (eliminar al reposo). 🟢
  • Cristal: backdrop-filter: blur(16px) saturate(180%) + relleno semitransparente ~0.6 + 1px hairline + fallback opaco, texto ≥4.5:1. 🟡/🟢
  • prefers-reduced-motion: reduce → cross-fade/transición inmediata, eliminar grandes movimientos/parallax (pequeña opacidad se mantiene). ≤3 destellos/s. Prohibido eliminar focus outline sin alternativa (:focus-visible). 🟢

Validación de formularios

  • Validación primaria en blur, una vez que un campo tiene error, cambiar a on-change (en vivo) (el error se elimina al corregir). Debounce para validación asíncrona 300–500ms. 🟡

2. Flujo de trabajo APPLY

  1. Detección de contexto — ¿Existe DESIGN.md en la raíz del proyecto o en la carpeta de destino? Si existe, leer primero los tokens (color·radio·espaciado·movimiento·tipografía) con el procedimiento omd:apply. Los tokens de marca = autoridad.
  2. Rellenar ejes vacíos — Solo los ejes sobre los que DESIGN.md calla se llenan con los valores por defecto del cheat-sheet. Para ejes profundos (física de scroll·cristal·escalera z·CLS), consultar la sección correspondiente de reference.md.
  3. Respetar niveles — 🟢 se aplica tal cual, 🟡 es valor por defecto (cede si la marca o la solicitud lo sobreescriben), ⚪/FOLK se presentan como "esto es una heurística de gusto" y solo se sugieren.
  4. Dejar evidencia en la salida — Los números no obvios (p. ej., salida 0.8×, offset de focus 2px) se explican en una línea con el motivo + tier, ya sea en comentarios de código o en la descripción. No inventar números — si no está en el cheat-sheet/reference, leer la referencia o decir que no se sabe.
  5. prefers-reduced-motion siempre acompañante — si se añade movimiento, también se añade la rama reduce (la accesibilidad no es opcional).

3. Flujo de trabajo AUDIT

Patrón de asesoría (solo lectura) como omd:designer-review + eje feel. Cada llamada relee DESIGN.md (sin caché).

  1. Entrada: artifact_path (HTML/JSX/TSX/CSS) + (si existe) design_md_path + viewport.
  2. Escaneo machine_check — Aplica cada regla 🔍 machine_check de reference.md al artifact. Ejemplos:
    • transition: all / duración >400ms / duración fuera de cuadrícula → detectar
    • Objetivo táctil <44px, focus outline eliminado, contraste de texto <4.5:1
    • <img> sin aspect-ratio, modal sin aria-modal, superposición sin overscroll-behavior
  3. severidad = mapeo de tier — Incumplimiento de SPEC/DS = BLOCK, CONV = WARN, OP/FOLK = FYI. (Prohibido inflar/deflar la severidad.)
  4. feel-score — Proporción de ejes aplicables que están dentro de la banda: 🟢 in-band / 🟢 applicable como número principal; WARN/FYI son secundarios. "feel-score 18/22 SPEC in-band, BLOCK 2, WARN 5".
  5. Salida: <work_dir>/.reviews/feel-audit-round-<N>.md — cada incidencia con ref de línea + tier + evidencia de machine_check + corrección (actionable). Prohibido emitir incidencias sin ref de línea o hacer rubber-stamp "se ve bien".
### [BLOCK] Objetivo táctil por debajo del mínimo — botón de icono
- **Ubicación:** `components/Toolbar.tsx:31`
- **Regla:** §8 Objetivos — mínimo 44pt/48dp/24px (🟢 SPEC, WCAG 2.5.8)
- **Evidencia:** `<button className="w-6 h-6">` → 24px, sin hit-slop
- **Corrección:** Asegurar región de impacto 44×44 con padding (`p-2.5` + mantener icono visual de 24px)

4. Barreras de seguridad

  • ❌ Prohibido presentar folklore como especificación. ⚪/FOLK siempre indican su tier. (La lista de degradados del corpus Appendix B — Hick-Hyman 0.155s/bit, Fitts ms/bit, rubberband 0.7, pressed suelo 0.95, exit 0.8×, stagger 80/100ms, optical 2px, etc. — no deben forzarse como puertas numéricas, solo tomar la dirección.)
  • ❌ Prohibido inventar números. Si no está en el cheat-sheet/reference, leer la referencia o decir "no lo sé".
  • ❌ Prohibido ignorar DESIGN.md y sobreescribir con mejores prácticas genéricas. Los tokens de marca van primero.
  • ❌ Prohibido añadir movimiento sin incluir la rama prefers-reduced-motion.
  • ❌ En AUDIT, prohibido inflar severidad (todo BLOCK), deflarla (BLOCK a FYI), o emitir incidencias sin ref de línea.
  • ❌ Si es necesario cambiar un número, no editar reference.md a mano — regenerar desde corpus → generador.

5. Relaciones con el ecosistema omd

  • omd:apply — Aplica tokens de marca de DESIGN.md. omd:feel actúa encima, rellenando la capa de sensación donde los tokens callan.
  • omd:designer-review — Audita la coherencia de marca (tipografía/presupuesto de color/escala de radios). La auditoría de omd:feel es su contraparte del eje feel (temporización de movimiento·objetivos·CLS·accesibilidad).
  • omd:taste — Panel de gusto del usuario (concepto aparte). Las decisiones de feel que se repiten y se consolidan como gusto fluyen a través de omd:remember.

Verificación manual: Si AUDIT detecta transition: all 0.6s + <button class="w-5 h-5"> + un componente sin rama prefers-reduced-motion, deben aparecer al menos 3 BLOCK (transition all=GPU SPEC, objetivo 20px=WCAG SPEC, falta de reduced-motion=accesibilidad SPEC) con sus respectivas referencias de línea, y el feel-score debe reducirse en consecuencia.

Skills relacionados