¿Qué hace UI?
Una habilidad para construir y restilar interfaces. Une las habilidades de Jakub Krehel, make-interfaces-feel-better, Impeccable y las propias referencias de Molveau (incluyendo una guía de gusto destilada del trabajo de Emil Kowalski) en un solo manual.
Comenzar aquí
Lee references/playbook.md primero, comenzando con su bloque "Haz esto primero"; abre los archivos de proveedores y las referencias de Molveau solo para profundizar o para ejemplos prácticos. El manual es la doctrina unificada (antes de empezar, dar forma, diseño, tipo, color, modo oscuro, superficies, iconos, componentes y estados, movimiento de feedback, responsive y nativo, revisiones, refinamientos, rendimiento, primero el mockup, indicaciones) con etiquetas de fuente y las decisiones tomadas cuando las fuentes discrepan. La tabla siguiente es el índice de profundidad.
Puerta de dirección
Haz esto antes de cualquier código para una nueva página, pantalla o restilo, incluso cuando la solicitud sea de una línea. El resto de esta habilidad elimina errores; no da carácter a una pantalla. Si se omite, el resultado es la página mediana que todo modelo produce: correcta en los detalles, pero sin dueño.
- Cinco líneas. Producto: qué hace, para quién. Carácter: dos o tres palabras concretas (
tranquilo, exacto, un poco cálido), nunca limpio, moderno, elegante, minimalista o premium. Mundo: el lugar o material al que pertenece el producto; tiñe los neutros y establece el acento. Momentos: los uno o dos lugares que reciben color y detalle ricos. Firma: un pequeño detalle que solo este producto tiene, usado de forma consistente. Un momento se dibuja con cuidado, no solo se limpia: un gráfico redibujado para lo que debe decir (líneas suaves, una comparación reflejada, una escala real), o el propio objeto del producto renderizado con peso y luz. - Inventario, luego la idea. Enumera de 8 a 12 cosas que ningún competidor comparte (nombre, calle, números en el resumen, materiales, herramientas, rituales, documentos que el oficio imprime). Escribe: "En esta pantalla, [un elemento] se convierte en [el dispositivo]". Ese dispositivo es el momento.
- Rechaza los valores predeterminados de segundo orden a menos que la marca ya los posea. Son lo que un modelo alcanza una vez que las pistas obvias están prohibidas:
- un fondo crema, piedra o blanco cálido con un acento naranja quemado, terracota, salvia o bosque, con o sin un titular serif (el aspecto de "papel y tinta" es el nuevo valor predeterminado, no una dirección);
- Fraunces, Instrument Serif, Playfair o Georgia como tipografía de titular por reflejo; system-ui como la única tipografía;
- Inter o Geist sobre blanco con un acento índigo o azul;
- héroe, tres características, testimonios, llamada a la acción, en ese orden, sin argumento; en una pantalla de aplicación, cuatro tarjetas de estadísticas iguales sobre un gráfico de barras;
- una ceja centrada, un titular y dos botones como toda la primera pantalla.
- Prueba de intercambio. Reemplaza el nombre y el oficio por los de un competidor. Si la pantalla sigue funcionando, cambia la propuesta, el momento y la firma, y prueba de nuevo.
- Muestra y espera. Muestra las cinco líneas y la idea, y espera al propietario. Si no puedes preguntar (el usuario dijo que lo construyas, o trabajas sin una persona), escríbelas como un comentario al principio del archivo principal y construye exactamente eso.
Profundidad: manual anti-slop §2 (dirección) y §12 (pantallas de aplicación); la habilidad design-inspiration-index para referencias reales.
Siempre activo
- Primero el proyecto. Sus tokens, componentes,
DESIGN.mdy pantallas hermanas deciden antes que cualquier valor predeterminado aquí. - Una autoridad de diseño a la vez. Termina una pasada antes de superponer otra.
- Un punto focal y una acción principal por pantalla, cada estado diseñado (manual §3, §9).
- Mockup antes de la implementación para pantallas nuevas o restiladas cuando el proyecto trabaja primero con mockups, el valor predeterminado de Molveau (
references/mockup-first.md); de lo contrario, el propio proceso de revisión del proyecto. - Antes de dar por terminada la UI: la habilidad
anti-slopy su detector, luego verificación de tipos, lint y pruebas.
Vecinas: la habilidad anti-slop posee las marcas de código generado por vibraciones y las pasadas de des-AI; motion posee la animación más allá del feedback de UI; ux posee el texto, formularios, foco, objetivos, profundidad de accesibilidad, errores, casos límite y onboarding. Profundidad de revisión: design-grill es la auditoría profunda (siete lentes, informe clasificado), las filas de crítica a continuación son la pasada única más ligera, y anti-slop es la pasada de aspecto-AI.
Qué leer para cada tarea
Todas las rutas son relativas a esta carpeta de habilidad.
| Tarea | Leer |
|---|---|
| Las reglas unificadas, valores y decisiones de conflicto | references/playbook.md |
| Pantalla nueva o restilada que necesita feedback (no un ajuste pequeño) | references/mockup-first.md |
| Valores predeterminados de gusto cuando un proyecto aún no tiene tokens | references/taste.md |
| Diseño, agrupación, alineación, espaciado | references/vendor/jakub/better-layout.md, luego references/vendor/impeccable/layout.md |
| Tipografía: fuentes, escala, longitud de línea, OpenType | references/vendor/jakub/better-typography.md y references/vendor/impeccable/typeset.md |
| Color: paleta, contraste, modo oscuro, tokens | references/vendor/jakub/better-colors.md, más references/vendor/impeccable/colorize.md para añadir color |
| Pulido final: radios, sombras, alineación óptica, estados de icono | references/vendor/feel/make-interfaces-feel-better.md y references/vendor/impeccable/polish.md; references/vendor/jakub/better-ui.md para valores exactos |
Revisión clasificada de pantalla completa (la accesibilidad y el texto están en la habilidad ux) | references/vendor/jakub/better-interface.md, el paraguas |
| Revisar una rama o PR para regresiones de UI | references/vendor/jakub/interface-review.md |
| Auditoría de diseño de lentes múltiples completa de un archivo, componente o ruta (pesado: varios agentes) | la habilidad design-grill |
| Referencias visuales o inspiración para un héroe, CTA, navbar, animación, iconos | la habilidad design-inspiration-index |
| Crítica o revisión de diseño de una pantalla | references/vendor/impeccable/critique.md (heurísticas, carga cognitiva, personas); desmontaje rápido: prompt 4 en references/prompts.md |
Auditoría: rendimiento, tematización, responsive (para accesibilidad, usa la habilidad ux) | references/vendor/impeccable/audit.md, references/vendor/impeccable/optimize.md |
| Demasiado recargado o pesado | references/vendor/impeccable/distill.md, references/vendor/impeccable/quieter.md |
| Demasiado insípido o tímido | references/vendor/impeccable/bolder.md, references/vendor/impeccable/colorize.md, references/vendor/impeccable/delight.md |
| Efectos técnicamente ambiciosos | references/vendor/impeccable/overdrive.md |
| Planificar un nuevo diseño desde cero | references/vendor/impeccable/shape.md; references/vendor/impeccable/new-work.md y los archivos de modo (references/vendor/impeccable/mode-operate.md, mode-persuade.md, mode-read.md) para una nueva identidad visual |
| Profundidad de aplicación, dashboard y configuración | references/vendor/impeccable/operate.md |
| Pantallas pequeñas, táctil, otras plataformas | references/vendor/impeccable/adapt.md; nativo: references/vendor/impeccable/ios.md, references/vendor/impeccable/android.md, references/vendor/impeccable/adapt.native.md |
Escribir o actualizar DESIGN.md, extraer tokens y componentes | references/vendor/impeccable/document.md, references/vendor/impeccable/extract.md |
| Recetas de movimiento de feedback (presionar, entrar y salir, intercambios de iconos, cambio de tema) | references/vendor/jakub/better-ui/animations.md, references/vendor/jakub/better-ui/enter-exit.md, references/vendor/jakub/better-ui/icon-transitions.md; los números de Emil en references/animation.md (flujo de trabajo completo: la habilidad motion). Algunas recetas allí duran más (una hoja de ~500ms, los 400ms de Sonner): en UI el manual limita las superposiciones a 300ms (§10) |
| Lista de verificación de componentes interactivos (toasts, cajones, menús) | references/components.md |
| Sitio de marketing público que debe ser citado por LLMs | references/discoverability.md |
| Indicaciones que fuerzan el gusto en la UI generada por IA | references/prompts.md |
| La filosofía detrás de las reglas | references/quotes.md |
| La UI se ve genérica o generada por vibraciones | la habilidad anti-slop |
| Texto, errores, estados vacíos, profundidad de accesibilidad | la habilidad ux |
El punto de entrada de Impeccable references/vendor/impeccable/impeccable.md describe un conjunto de comandos completo con sus propios archivos de configuración y scripts; léelo cuando quieras ese flujo de trabajo completo en lugar de una pasada única. Sus comandos clarify, harden y onboard están incluidos una vez, en la habilidad ux.
Notas sobre los archivos de proveedores
Los archivos en references/vendor/ se copian sin modificar de sus autores, por lo que los enlaces relativos y los nombres de comandos dentro de ellos (los comandos de barra de Impeccable, scripts/impeccable, modo en vivo, compuertas de componentes) pueden no existir en esta instalación. Toma la guía; omite lo que apunte a herramientas faltantes. Cuando un archivo de proveedor solicite capturas de pantalla del navegador, subagentes o pasadas visuales automatizadas, sigue la propia regla del proyecto (conflicto del manual 14). Las licencias y fuentes exactas están en cada carpeta de proveedor (LICENSE, SOURCE.md).
Créditos y licencias
references/vendor/jakub/son las habilidades de Jakub Krehel (https://github.com/jakubkrehel/skills), MIT.references/vendor/feel/es make-interfaces-feel-better de Jakub Krehel (https://github.com/jakubkrehel/make-interfaces-feel-better), MIT.references/vendor/impeccable/es Impeccable de Paul Bakaus (https://github.com/pbakaus/impeccable), Apache-2.0, con su LICENSE y NOTICE conservados. Archivos reubicados, SKILL.md renombrado,scripts/no incluido; consulta suSOURCE.md. El manual parafrasea y condensa la guía de Impeccable; esa adaptación es un cambio con respecto al original.- La guía de gusto (
references/taste.md,animation.md,components.md,quotes.md) está destilada del trabajo de diseño-ingeniería de Emil Kowalski (https://emilkowal.ski), etiquetado[Molveau/Emil]en el manual. Las palabras y la estructura son de Molveau (MIT); las ideas y los números son suyos.references/quotes.mdatribuye cada cita.references/animation.mdtambién se basa en devouringdetails.com de Rauno Freiberg. references/discoverability.mdestá destilado de la investigación de Suganthan Mohanadasan (suganthan.com).references/playbook.md,references/prompts.mdyreferences/mockup-first.mdson propios de Molveau (MIT), acreditando cada fuente por etiqueta.