Impeccable no es ArtCraft ni forma parte de los productos o la suite de ArtCraft; esta página es una guía independiente y la información oficial está en impeccable.style y github.com/pbakaus/impeccable.
Impeccable: el vocabulario de diseño para tu agente de código
Impeccable es un skill de diseño y una herramienta de línea de comandos de código abierto que le da a tu agente de programación un vocabulario común para revisar, ajustar y pulir interfaces. Lo creó Paul Bakaus y partió del skill frontend-design de Anthropic; se publica bajo licencia Apache-2.0. Esta página es una guía independiente, no documentación oficial.
- 24 comandos: critique, polish, audit, typeset, distill y más
- Detector de 62 reglas deterministas, sin LLM ni clave de API
- Compatible con Claude Code, Cursor, Codex CLI, Copilot y 19 agentes en total
Sitio oficialRepositorio en GitHubDocumentación
Última actualización: · English
Qué es Impeccable
Impeccable es un skill que se instala en tu agente de código y le da un vocabulario de diseño, acompañado de una CLI independiente. No abre un lienzo: convierte el diseño en acciones que el agente puede ejecutar, desde la crítica y la síntesis hasta la tipografía, la limpieza y el endurecimiento. Nació del skill frontend-design de Anthropic y se distribuye con licencia Apache-2.0.
Su objetivo es el gusto por defecto de los agentes: Inter en todas partes, degradados de morado a azul, tarjetas dentro de tarjetas, texto gris sobre fondos de color y una loseta de icono redondeada encima de cada título. Un detector de 62 reglas deterministas marca estas señales mientras se edita, sin LLM y sin clave de API.
Rinde mejor en interfaces que ya existen: apuntas a una página o un componente y iteras. También puede construir páginas nuevas, aunque el propio proyecto admite que ese modo es más difícil. Conviene aclarar que Impeccable es un proyecto abierto e independiente, no un producto de ArtCraft ni parte de su suite.
Instalación y puesta en marcha
Ejecuta el comando desde la raíz del proyecto. npx necesita Node 18.19 o superior. El instalador detecta tus herramientas, pregunta si quieres una instalación por proyecto o global y ofrece el hook de diseño cuando la herramienta lo admite; conviene aceptarlo.
Después recarga la herramienta y ejecuta /impeccable init ($impeccable init en Codex). Para automatizar, acepta --providers=claude,codex,cursor y --scope=project|global. Una instalación existente se actualiza con npx impeccable update.
npx impeccable install- Comprueba que tienes Node 18.19 o superior y abre la raíz del proyecto.
- Ejecuta npx impeccable install, elige el alcance del proyecto o global y activa el hook de diseño si está disponible.
- Recarga la herramienta de código y ejecuta /impeccable init ($impeccable init en Codex) para generar PRODUCT.md.
- Si quieres fijar el sistema visual, ejecuta /impeccable document y crea DESIGN.md; luego mantén todo al día con npx impeccable update.
Comandos principales
Impeccable tiene 24 comandos. Se usan con la forma «comando + objetivo», por ejemplo /impeccable critique the pricing cards; en Codex cambia la barra por $. Si escribes /impeccable a secas, el agente muestra la lista. Estos son los siete más útiles.
| Comando | Qué hace | Cuándo usarlo |
|---|---|---|
/impeccable init | Lee el código, pregunta solo lo que no puede inferir y escribe PRODUCT.md. | Una vez al inicio del proyecto, para dar contexto a los demás comandos. |
/impeccable critique | Hace una revisión de UX puntuada según heurísticas de usabilidad y ordena qué corregir primero. | Antes de rediseñar o para saber dónde se atasca un flujo. |
/impeccable polish | Da el último repaso antes de publicar. | Cuando la funcionalidad está cerrada y toca lanzar. |
/impeccable audit | Genera un informe técnico de accesibilidad, rendimiento, temática, respuesta adaptativa e integridad de la implementación, con hallazgos de P0 a P3. | Antes de un lanzamiento o para atajar deuda de implementación. |
/impeccable typeset | Corrige tipografías, jerarquía, tamaños y espaciado. | Cuando la tipografía se ve floja o la jerarquía no se entiende. |
/impeccable distill | Elimina lo que la página no necesita. | Cuando hay demasiado contenido y el foco se pierde. |
/impeccable hooks status|on|off | Consulta, activa o desactiva el hook de diseño, que escanea los archivos de UI que edita el agente. | Para verificar que la comprobación automática funciona o para pausarla. |
Flujo de trabajo recomendado
Primero el contexto, después la pantalla. init solo pregunta lo que no puede deducir: para quién es el producto, qué debe conseguir y qué restricciones hay; las respuestas van a PRODUCT.md y las leen todos los comandos posteriores. Si ya tienes un sistema visual, ejecuta document para volcar las reglas de marca en DESIGN.md y evitar que el agente cambie de estilo a mitad del trabajo.
Cuanto más concreto sea el objetivo, mejor sale. En lugar de «rehaz toda la página», prueba con «critique a las tarjetas de precios». Los comandos que repites se pueden fijar con /impeccable pin audit, que crea el atajo /audit; antes de publicar, cierra con audit y luego polish.
- Ejecuta /impeccable init una vez por proyecto y revisa el PRODUCT.md generado.
- Si hay un sistema de diseño previo, ejecuta /impeccable document y resume tipografías, colores y componentes en DESIGN.md.
- Itera por secciones: /impeccable critique the pricing cards y después bolder, quieter, distill o typeset para ajustar el rumbo.
- Antes de publicar, pasa /impeccable audit y /impeccable polish, y fija tus comandos habituales con pin.
Agentes compatibles
La lista oficial es amplia: Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness y Veto. La instalación varía según la herramienta; consulta la documentación oficial para ver la lista completa.
Claude Code, Copilot y Grok tienen plugins; el hook de diseño está disponible en Claude Code, Cursor, Codex, GitHub Copilot, Grok Build y Hermes Agent. En Codex hay que aprobar el hook del proyecto en /hooks, en Grok Build ejecutar /hooks-trust y en Hermes habilitar el plugin.
Si no quieres instalar Node, puedes copiar la carpeta del skill a mano. Para usar solo el detector, npx impeccable detect funciona sin agente. El modo live es compatible con Vite, Next, SvelteKit, Astro, Nuxt y HTML plano, pero solo modifica una copia local del proyecto.
Impeccable frente a ArtCraft MCP
Los dos nombres suenan parecido porque ambos trabajan con agentes, pero operan en capas distintas. Impeccable se ocupa del código fuente de la interfaz; ArtCraft MCP es el MCP/CLI oficial por aplicación de storytold, que controla Crafting Apps locales como PhotoCraft. Tampoco es lo mismo que las API de suscripción de la comunidad que usan el nombre artcraft-mcp.
| Dimensión | Impeccable | ArtCraft MCP |
|---|---|---|
| Sobre qué actúa | El código frontend del repositorio: componentes, JSX/TSX, CSS y estructura de página. | Las Crafting Apps locales (PhotoCraft, por ejemplo) y sus flujos de imagen y vídeo. |
| Qué produce | Consejo de diseño, cambios de código, informes critique/audit y los archivos PRODUCT.md y DESIGN.md. | Imágenes o vídeos y operaciones automatizadas dentro de esas aplicaciones. |
| Cuándo elegirlo | Para construir, revisar o pulir una interfaz frontend. | Para generar o procesar imágenes y vídeo en lote y automatizar el trabajo en esas apps. |
| ¿Se complementan? | Sí: la interfaz con Impeccable y la producción de material con ArtCraft MCP. | Sí, pero se limita a los recursos multimedia: no hace revisión de diseño de interfaces ni sustituye a Impeccable. |
Guía de ArtCraft MCPCrafting Apps
Alcance y seguridad
Impeccable es un skill de diseño frontend y una CLI, no una aplicación de diseño ni un generador de imágenes. El modo live solo edita una copia local; no lo inyectes en un sitio desplegado ni relajes la CSP de producción para que funcione.
Los hooks se ejecutan al margen de la aprobación del modelo. En Claude Code, un hook de comando instalado puede correr aunque rechaces los comandos del modelo, y la primera edición puede descargar el motor. Revisa los hooks antes de una ejecución desatendida o desactívalos con --settings '{"disableAllHooks": true}'.
La telemetría registra de forma anónima qué direcciones visuales se mostraron y cuál se eligió; no envía el nombre del proyecto, los archivos, el código ni PRODUCT.md. Se desactiva con npx impeccable telemetry off, DO_NOT_TRACK=1 o "telemetry": false en .impeccable/config.json. En el detector, el código de salida 2 indica hallazgos y el 1, que no se pudo escanear el objetivo.
Guías relacionadas
Preguntas frecuentes
¿Qué es Impeccable y es un producto de ArtCraft?
Impeccable es un skill de diseño y una CLI para agentes de código creado por Paul Bakaus, con 24 comandos y un detector de 62 reglas, publicado bajo Apache-2.0. No es un producto de ArtCraft ni pertenece a su suite. Esta página es una guía independiente; la información oficial está en impeccable.style y github.com/pbakaus/impeccable.
¿Cómo se instala?
Desde la raíz del proyecto, ejecuta npx impeccable install y luego recarga tu herramienta. Después lanza /impeccable init, o $impeccable init en Codex, para generar PRODUCT.md. npx requiere Node 18.19 o superior y las instalaciones existentes se actualizan con npx impeccable update; los pasos completos están en impeccable.style/docs.
¿En qué se diferencian critique y audit?
critique es una revisión de UX con puntuación basada en heurísticas de usabilidad, que te dice qué corregir primero. audit es un informe técnico sobre accesibilidad, rendimiento, temática, respuesta adaptativa e integridad de la implementación, con hallazgos clasificados de P0 a P3. Uno juzga la experiencia; el otro revisa la ingeniería, y suelen usarse seguidos.
¿Hace falta una clave de API?
No para el detector: sus 62 reglas son deterministas y no llaman a ningún LLM ni leen claves. El skill funciona dentro de tu agente, así que tampoco necesitas una clave de modelo aparte. La telemetría se puede desactivar con npx impeccable telemetry off o con DO_NOT_TRACK=1.
¿Con qué agentes funciona?
Con Claude Code, Cursor, Codex CLI, GitHub Copilot, Devin, Replit Agent, Gemini CLI, Grok Build, OpenCode, Google Antigravity, Kiro, Trae, Rovo Dev, Qoder, Mistral Vibe, Pi, Hermes Agent, DeepSeek Harness y Veto. La instalación y el soporte de hooks cambian según la herramienta; la lista actualizada está en impeccable.style/docs.
¿Impeccable o ArtCraft MCP?
Depende de qué quieras modificar. Impeccable trabaja sobre el código de la interfaz y devuelve recomendaciones, cambios y revisiones. ArtCraft MCP controla aplicaciones locales como PhotoCraft para producir imágenes y vídeo y automatizar sus flujos. Se pueden combinar, pero ArtCraft MCP no es una herramienta de revisión de diseño ni reemplaza a Impeccable.
Aviso de independencia
Impeccable es un proyecto de código abierto independiente creado por Paul Bakaus. No tiene vínculo con ArtCraft, no es un producto de ArtCraft y no forma parte de su suite ni de sus componentes oficiales. Esta página la escribe un tercero para lectores hispanohablantes; para comandos, requisitos y novedades, la referencia es el sitio oficial impeccable.style y el repositorio github.com/pbakaus/impeccable. ArtCraft MCP es otra integración oficial, centrada en las Crafting Apps, y resuelve un problema distinto.
Sources
Every fact on this page comes from the pages below, checked on 3 November 2026.