Communitygithub.com

DevvGwardo/impeccable

Habilidad completa de diseño frontend — 23 comandos para dar forma, auditar, pulir y refinar UI. Úsala cuando el usuario quiera diseñar, rediseñar, dar forma, criticar, auditar, pulir, clarificar, destilar, endurecer, optimizar, adaptar, animar, colorear, extraer o mejorar una interfaz frontend.

¿Qué es impeccable?

Impeccable es una habilidad completa de diseño frontend para agentes de IA (Claude Code, Cursor, Codex, etc.) que proporciona 23 comandos especializados para dar forma, auditar, pulir y refinar interfaces de usuario. Cubre desde sitios web y landing pages hasta paneles de control, componentes, formularios, estados vacíos y sistemas de diseño completos. La habilidad incluye leyes de diseño compartidas (color con OKLCH, tipografía con escalas modulares, diseño espacial, motion design) y una prueba anti-IA para evitar patrones genéricos. Soporta dos registros: "brand" (marketing, landing) y "product" (apps, dashboards), cargando referencias específicas para cada uno. También incluye un CLI independiente (`npx impeccable detect`) para escanear HTML/CSS/JSX/TSX/Vue/Svelte en busca de más de 25 anti-patrones. Es útil para diseñadores y desarrolladores que quieren iterar visualmente en el navegador, auditar accesibilidad, rendimiento y responsive, refinar tipografía y color, y preparar interfaces para producción.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add DevvGwardo/impeccable

Preguntar en tu IA favorita

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

Documentación

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:

  1. 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:teach primero.
  2. 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.
  3. 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.

ComandoCategoríaDescripción
impeccable:craft [característica]ConstruirFlujo completo de dar forma y luego construir con iteración visual
impeccable:teachConstruirConfiguración única: recopilar contexto de diseño, escribir PRODUCT.md y DESIGN.md
impeccable:documentConstruirGenerar DESIGN.md a partir del código del proyecto existente
impeccable:extract [objetivo]ConstruirExtraer componentes y tokens reutilizables hacia el sistema de diseño
impeccable:shape [característica]ConstruirPlanificar UX/UI antes de escribir código
impeccable:critique [objetivo]EvaluarRevisión de diseño UX: jerarquía, claridad, resonancia emocional
impeccable:audit [objetivo]EvaluarEjecutar verificaciones de calidad técnica (a11y, rendimiento, responsive)
impeccable:polish [objetivo]RefinarPase final, alineación con el sistema de diseño y preparación para lanzamiento
impeccable:bolder [objetivo]RefinarAmplificar diseños aburridos
impeccable:quieter [objetivo]RefinarAtenuar diseños demasiado llamativos
impeccable:distill [objetivo]RefinarReducir a la esencia
impeccable:harden [objetivo]RefinarManejo de errores, i18n, desbordamiento de texto, casos extremos
impeccable:onboard [objetivo]RefinarFlujos de primera ejecución, estados vacíos, caminos de activación
impeccable:animate [objetivo]MejorarAñadir movimiento con propósito
impeccable:colorize [objetivo]MejorarIntroducir color estratégico
impeccable:typeset [objetivo]MejorarCorregir elecciones tipográficas, jerarquía, tamaño
impeccable:layout [objetivo]MejorarCorregir diseño, espaciado, ritmo visual
impeccable:delight [objetivo]MejorarAñadir momentos de deleite
impeccable:overdrive [objetivo]MejorarAñadir efectos técnicamente extraordinarios
impeccable:clarify [objetivo]ArreglarMejorar copia UX poco clara
impeccable:adapt [objetivo]ArreglarAdaptar para diferentes dispositivos
impeccable:optimize [objetivo]ArreglarMejoras de rendimiento
impeccable:liveIterarModo 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 #000 o #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-left o border-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ña
  • reference/product.md — Registro product: UI de app, paneles de control, herramientas
  • reference/typography.md — Sistemas tipográficos, parejas de fuentes, escalas modulares, OpenType
  • reference/color-and-contrast.md — OKLCH, neutros teñidos, modo oscuro, accesibilidad
  • reference/spatial-design.md — Sistemas de espaciado, cuadrículas, jerarquía visual
  • reference/motion-design.md — Curvas de easing, escalonamiento, movimiento reducido
  • reference/interaction-design.md — Formularios, estados de foco, patrones de carga
  • reference/responsive-design.md — Mobile-first, diseño fluido, container queries
  • reference/ux-writing.md — Etiquetas de botones, mensajes de error, estados vacíos
  • reference/cognitive-load.md — Reducir la sobrecarga cognitiva en interfaces
  • reference/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 construir
  • reference/shape.md — Planificación UX/UI antes del código
  • reference/teach.md — Configurar PRODUCT.md y DESIGN.md
  • reference/document.md — Generar DESIGN.md desde código existente
  • reference/extract.md — Extraer tokens al sistema de diseño
  • reference/critique.md — Revisión de diseño UX
  • reference/audit.md — Verificaciones de calidad técnica
  • reference/polish.md — Pase de calidad final
  • reference/bolder.md — Amplificar diseños seguros
  • reference/quieter.md — Atenuar diseños llamativos
  • reference/distill.md — Reducir a la esencia
  • reference/harden.md — Preparación para producción
  • reference/onboard.md — Flujos de primera ejecución y estados vacíos
  • reference/animate.md — Animación con propósito
  • reference/colorize.md — Introducción estratégica de color
  • reference/typeset.md — Correcciones tipográficas
  • reference/layout.md — Correcciones de diseño y espaciado
  • reference/delight.md — Personalidad y toques memorables
  • reference/overdrive.md — Ir más allá de los límites convencionales
  • reference/clarify.md — Mejoras de copia UX
  • reference/adapt.md — Adaptación a dispositivos
  • reference/optimize.md — Rendimiento de UI
  • reference/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

Skills relacionados