Impeccable — Habilidad de Diseño Frontend
Diseña e itera interfaces frontend de grado de producción. Código real funcionando, decisiones de diseño comprometidas, artesanía excepcional.
Basado en pbakaus/impeccable (Apache 2.0), que a su vez se basa en la habilidad de diseño frontend de Anthropic.
Configuración
Antes de cualquier trabajo de diseño o edición de archivos:
- Lee el contexto — Revisa si hay PRODUCT.md / DESIGN.md en la raíz del proyecto. Si PRODUCT.md falta o es un marcador de posición (<200 caracteres), sugiere al usuario ejecutar
impeccable:teachprimero. - Identifica el registro — Cada tarea de diseño es brand (marketing, landing, campaña, portafolio: el diseño ES el producto) o product (UI de app, admin, dashboard, herramienta: el diseño SIRVE al producto). Identifícalo antes de diseñar.
- Carga la referencia del registro — Usa la referencia de brand o producto de los archivos de referencia de esta habilidad, según el registro.
Comandos
Cuando el usuario invoque un comando específico de impeccable (ej. "audita esta página", "pule el checkout"), sigue el patrón: impeccable:<comando> [objetivo]. Cada comando tiene un archivo de referencia en el directorio de referencia de esta habilidad.
| Comando | Categoría | Descripción |
|---|---|---|
impeccable:craft [característica] | Construir | Flujo completo de dar forma y luego construir con iteración visual |
impeccable:teach | Construir | Configuración única: recopilar contexto de diseño, escribir PRODUCT.md y DESIGN.md |
impeccable:document | Construir | Generar DESIGN.md a partir del código del proyecto existente |
impeccable:extract [objetivo] | Construir | Extraer componentes y tokens reutilizables hacia el sistema de diseño |
impeccable:shape [característica] | Construir | Planificar UX/UI antes de escribir código |
impeccable:critique [objetivo] | Evaluar | Revisión de diseño UX: jerarquía, claridad, resonancia emocional |
impeccable:audit [objetivo] | Evaluar | Ejecutar verificaciones de calidad técnica (a11y, rendimiento, responsive) |
impeccable:polish [objetivo] | Refinar | Pase final, alineación con el sistema de diseño y preparación para lanzamiento |
impeccable:bolder [objetivo] | Refinar | Amplificar diseños aburridos |
impeccable:quieter [objetivo] | Refinar | Atenuar diseños demasiado llamativos |
impeccable:distill [objetivo] | Refinar | Reducir a la esencia |
impeccable:harden [objetivo] | Refinar | Manejo de errores, i18n, desbordamiento de texto, casos extremos |
impeccable:onboard [objetivo] | Refinar | Flujos de primera ejecución, estados vacíos, caminos de activación |
impeccable:animate [objetivo] | Mejorar | Añadir movimiento con propósito |
impeccable:colorize [objetivo] | Mejorar | Introducir color estratégico |
impeccable:typeset [objetivo] | Mejorar | Corregir elecciones tipográficas, jerarquía, tamaño |
impeccable:layout [objetivo] | Mejorar | Corregir diseño, espaciado, ritmo visual |
impeccable:delight [objetivo] | Mejorar | Añadir momentos de deleite |
impeccable:overdrive [objetivo] | Mejorar | Añadir efectos técnicamente extraordinarios |
impeccable:clarify [objetivo] | Arreglar | Mejorar copia UX poco clara |
impeccable:adapt [objetivo] | Arreglar | Adaptar para diferentes dispositivos |
impeccable:optimize [objetivo] | Arreglar | Mejoras de rendimiento |
impeccable:live | Iterar | Modo de variante visual: iterar sobre elementos en el navegador |
Ruteo
- Sin objetivo especificado: Muestra la tabla de comandos agrupada por categoría, pregunta qué les gustaría hacer.
- Comando coincide: Carga su archivo de referencia desde el directorio reference/ de esta habilidad y sigue sus instrucciones.
- Sin coincidencia pero relacionado con diseño: Aplica las leyes de diseño compartidas y la referencia del registro directamente.
Leyes de Diseño Compartidas
Aplica a cada diseño, ambos registros. Iguala la complejidad de la implementación a la visión estética. Varía entre proyectos; nunca converjas en las mismas elecciones.
Color
- Usa OKLCH. Reduce la croma a medida que la luminosidad se acerca a 0 o 100; la croma alta en los extremos se ve chillona.
- Nunca uses
#000o#fff. Tiñe cada neutro hacia el tono de la marca (croma 0.005–0.01 es suficiente). - Elige una estrategia de color antes de elegir colores. Cuatro pasos en el eje de compromiso:
- Austero: neutros teñidos + un acento ≤10%. Predeterminado para producto; minimalismo de marca.
- Comprometido: un color saturado cubre el 30–60% de la superficie. Predeterminado de marca para páginas impulsadas por identidad.
- Paleta completa: 3–4 roles nombrados, cada uno usado deliberadamente. Campañas de marca; visualización de datos de producto.
- Empapado: la superficie ES el color. Héroes de marca, páginas de campaña.
- La regla "un acento ≤10%" es solo para Austero. Comprometido / Paleta completa / Empapado la superan a propósito.
Tema
Oscuro vs. claro nunca es un predeterminado. No oscuro "porque las herramientas se ven cool en oscuro". No claro "para estar seguro".
Antes de elegir, escribe una oración de escena física: quién usa esto, dónde, bajo qué luz ambiental, con qué estado de ánimo. Si la oración no fuerza la respuesta, no es lo suficientemente concreta. Añade detalle hasta que lo sea.
"Panel de observabilidad" no fuerza una respuesta. "SRE mirando la gravedad de incidentes en un monitor de 27 pulgadas a las 2am en una habitación oscura" sí.
Tipografía
- Limita el largo de línea del cuerpo a 65–75 caracteres.
- Jerarquía a través de contraste de escala + peso (ratio ≥1.25 entre pasos). Evita escalas planas.
Diseño
- Varía el espaciado para el ritmo. El mismo padding en todas partes es monotonía.
- Las cards son la respuesta perezosa. Úsalas solo cuando sean realmente la mejor forma. Las cards anidadas siempre están mal.
- No envuelvas todo en un contenedor. La mayoría de las cosas no necesitan uno.
Movimiento
- No animes propiedades de layout de CSS.
- Desacelera con curvas exponenciales (ease-out-quart / quint / expo). Sin rebote, sin elástico.
Prohibiciones Absolutas (Anti-patrones)
Reconoce y rechaza. Si estás a punto de escribir algo de esto, reescribe con una estructura diferente.
- Bordes de barra lateral.
border-leftoborder-right>1px como acento de color en cards, elementos de lista, callouts o alertas. Usa bordes completos, tintes de fondo, números/iconos al inicio, o nada. - Texto con gradiente.
background-clip: text+ gradiente. Decorativo, nunca significativo. Usa un solo color sólido. Énfasis mediante peso o tamaño. - Vidrio esmerilado como predeterminado. Desenfoques y cards de vidrio usados decorativamente. Raro y con propósito, o nada.
- La plantilla de métrica héroe. Número grande, etiqueta pequeña, estadísticas de apoyo, acento degradado. Cliché SaaS.
- Cuadrículas de cards idénticas. Cards del mismo tamaño con icono + encabezado + texto, repetidos infinitamente.
- Modal como primer pensamiento. Los modales suelen ser pereza. Agota primero alternativas en línea / progresivas.
Copia
- Cada palabra gana su lugar. Sin encabezados reformulados, sin introducciones que repitan el título.
- Sin rayas (em dash). Usa comas, dos puntos, punto y coma, puntos o paréntesis.
La Prueba de Slop de IA
Si alguien pudiera mirar esta interfaz y decir "IA hizo eso" sin duda, ha fallado.
Verificación de reflejo por categoría — dos altitudes:
- Primer orden: si alguien pudiera adivinar el tema + paleta solo por la categoría ("observabilidad → azul oscuro", "salud → blanco + verde azulado", "finanzas → azul marino + dorado", "crypto → neón sobre negro"), es el reflejo de los datos de entrenamiento. Reelabora la oración de escena y la estrategia de color hasta que la respuesta no sea obvia por el dominio.
- Segundo orden: si alguien pudiera adivinar la familia estética por categoría más anti-referencias ("herramienta de flujo de trabajo IA que no es SaaS-crema → editorial-tipográfico", "fintech que no es azul marino + dorado → modo oscuro nativo de terminal"), es la trampa un nivel más profundo. Se evitó el primer reflejo; el segundo no. Reelabora hasta que ambas respuestas no sean obvias.
Archivos de Referencia
Hay archivos de referencia detallados disponibles en el directorio reference/ de esta habilidad para cada comando y dominio de diseño. Cárgalos con skill_view(name='impeccable', file_path='reference/<nombre>.md').
Referencias clave de dominio de diseño (cargar para inmersiones profundas):
reference/brand.md— Registro brand: marketing, landing, páginas de campañareference/product.md— Registro product: UI de app, paneles de control, herramientasreference/typography.md— Sistemas tipográficos, parejas de fuentes, escalas modulares, OpenTypereference/color-and-contrast.md— OKLCH, neutros teñidos, modo oscuro, accesibilidadreference/spatial-design.md— Sistemas de espaciado, cuadrículas, jerarquía visualreference/motion-design.md— Curvas de easing, escalonamiento, movimiento reducidoreference/interaction-design.md— Formularios, estados de foco, patrones de cargareference/responsive-design.md— Mobile-first, diseño fluido, container queriesreference/ux-writing.md— Etiquetas de botones, mensajes de error, estados vacíosreference/cognitive-load.md— Reducir la sobrecarga cognitiva en interfacesreference/heuristics-scoring.md— Rúbrica de evaluación heurística estilo Nielsen
Referencias de comando específicas (cargar al coincidir comando):
reference/craft.md— Flujo completo de dar forma y construirreference/shape.md— Planificación UX/UI antes del códigoreference/teach.md— Configurar PRODUCT.md y DESIGN.mdreference/document.md— Generar DESIGN.md desde código existentereference/extract.md— Extraer tokens al sistema de diseñoreference/critique.md— Revisión de diseño UXreference/audit.md— Verificaciones de calidad técnicareference/polish.md— Pase de calidad finalreference/bolder.md— Amplificar diseños segurosreference/quieter.md— Atenuar diseños llamativosreference/distill.md— Reducir a la esenciareference/harden.md— Preparación para producciónreference/onboard.md— Flujos de primera ejecución y estados vacíosreference/animate.md— Animación con propósitoreference/colorize.md— Introducción estratégica de colorreference/typeset.md— Correcciones tipográficasreference/layout.md— Correcciones de diseño y espaciadoreference/delight.md— Personalidad y toques memorablesreference/overdrive.md— Ir más allá de los límites convencionalesreference/clarify.md— Mejoras de copia UXreference/adapt.md— Adaptación a dispositivosreference/optimize.md— Rendimiento de UIreference/live.md— Iteración de variantes en navegador
Herramienta CLI
Impeccable también incluye un CLI independiente para detectar anti-patrones de UI sin necesidad de un agente de IA:
npx impeccable detect src/ # escanea un directorio
npx impeccable detect index.html # escanea un archivo HTML
npx impeccable detect https://example.com # escanea una URL (requiere Puppeteer)
npx impeccable detect --fast --json . # solo regex, salida JSON
Escanea archivos HTML, CSS, JSX, TSX, Vue, Svelte en busca de más de 25 anti-patrones. Código de salida 0 = limpio, 2 = problemas encontrados. Requiere Node.js 18+.
Fuente
Original: github.com/pbakaus/impeccable Sitio web: impeccable.style