Repolode
Enviar
pbakaus

pbakaus/impeccable

Guía de diseño para agentes de programación con IA, con una skill de diseño, 24 comandos, iteración en el navegador y 61 reglas deterministas para detectar UI frontend generada por IA.

Ver en GitHubSitio web
Estrellas
83,060
Forks
5,022
Issues abiertos
48
Último commit
hace 3 horas

¿Qué es?

Impeccable es una skill de diseño y un conjunto de herramientas para agentes de programación con IA, como Claude Code, Cursor, Codex CLI y Gemini CLI. Proporciona al agente un vocabulario de diseño común mediante comandos como polish, audit, critique, distill y animate, además de un paso de inicialización que registra el contexto del producto en PRODUCT.md para que los comandos posteriores tengan en cuenta la audiencia y las restricciones.

También incluye una CLI independiente y una extensión de navegador que ejecutan 61 reglas deterministas de detección en HTML, directorios de código fuente o URL activas, sin necesidad de un LLM ni una clave de API. Las reglas identifican patrones habituales en interfaces frontend generadas por IA, como el uso excesivo de ciertas fuentes, degradados morados, tarjetas anidadas y aceleración con efecto rebote, además de problemas generales como objetivos táctiles pequeños y encabezados omitidos.

En los entornos compatibles, un hook instalable ejecuta el detector después de editar directamente archivos de UI y devuelve los hallazgos al flujo de trabajo del agente. El modo en vivo permite iterar sobre elementos de la página en el navegador, con un servidor de desarrollo local o HTML estático.

Funciones clave

  • 01Un único paso, /impeccable init, registra el contexto del producto en PRODUCT.md.
  • 0224 comandos para hacer críticas, auditorías, mejoras, ajustes de diseño, tipografía, animación y más.
  • 0361 reglas deterministas de detección que se pueden ejecutar mediante la CLI, la extensión de navegador o un hook del agente.
  • 04Modo de navegador en vivo para iterar sobre elementos con un servidor de desarrollo local o HTML estático.
  • 05El instalador es compatible con numerosas herramientas de programación con IA, como Cursor, Claude Code, Codex CLI y Gemini CLI.

Casos de uso

  • Mejorar la calidad visual del código frontend generado por un agente de programación con IA.
  • Auditar una página web existente en busca de problemas de accesibilidad, diseño adaptable y maquetación antes de publicarla.
  • Ejecutar el detector en CI sobre HTML o JSX para señalar patrones de diseño genéricos habituales en contenido generado por IA.
  • Analizar una URL de producción para detectar antipatrones de diseño sin modificar el código fuente.

Inicio rápido

  1. 1

    Instala la skill en tu proyecto desde la raíz del proyecto

    npx impeccable install
  2. 2

    Ejecuta el comando de configuración inicial en tu herramienta de programación con IA

    /impeccable init

Antes de usarlo

  • El instalador npx requiere Node.js, aunque las opciones de instalación manual y mediante Git no lo necesitan.
  • Algunos entornos requieren pasos adicionales, como aprobar los hooks o configurar la confianza, antes de que se ejecuten los hooks de diseño.

Temas

#ai-agents#frontend#design#ui-ux#linter#claude-code#cursor#accessibility

Preguntas frecuentes

¿Qué es impeccable?
Guía de diseño para agentes de programación con IA, con una skill de diseño, 24 comandos, iteración en el navegador y 61 reglas deterministas para detectar UI frontend generada por IA. Impeccable es una skill de diseño y un conjunto de herramientas para agentes de programación con IA, como Claude Code, Cursor, Codex CLI y Gemini CLI. Proporciona al agente un vocabulario de diseño común mediante comandos como polish, audit, critique, distill y animate, además de un paso de inicialización que registra el contexto del producto en PRODUCT.md para que los comandos posteriores tengan en cuenta la audiencia y las restricciones.
¿impeccable es gratuito? ¿Qué licencia tiene?
impeccable es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿impeccable sigue mantenido?
Mantenimiento activo. El último commit de impeccable fue el 19 oct 2026.
¿Para qué puedo usar impeccable?
Mejorar la calidad visual del código frontend generado por un agente de programación con IA. Auditar una página web existente en busca de problemas de accesibilidad, diseño adaptable y maquetación antes de publicarla. Ejecutar el detector en CI sobre HTML o JSX para señalar patrones de diseño genéricos habituales en contenido generado por IA. Analizar una URL de producción para detectar antipatrones de diseño sin modificar el código fuente.
¿Cómo se instala impeccable?
Instala la skill en tu proyecto desde la raíz del proyecto: npx impeccable install Ejecuta el comando de configuración inicial en tu herramienta de programación con IA: /impeccable init
¿Dónde consigo impeccable?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/pbakaus/impeccable

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados