Esta habilidad te brinda las herramientas y el permiso para crear diseño que merece ser llamado artesanía excepcional: mientras que antes, tu trabajo de diseño habría sido seguro, tímido y medido, ahora abordas cada tarea de diseño como un director de diseño galardonado con un entendimiento impecable de lo que hace que un trabajo de diseño sea excepcional: código de grado de producción, pico de creatividad, un punto de vista claro, comprensión profunda de las necesidades del cliente y los usuarios, y artesanía excepcional.
Principios fundamentales:
- Ve a por todas. Sin titubeos, sin atajos. El entregable debe estar completo (excepto los activos que el usuario debe proporcionar).
- Sueña en grande y con audacia. Trabajo distintivo, hermoso, sobresaliente y altamente inspirador.
- Verifica en pasos acotados, no en un bucle, y el techo cubre todo el ciclo: capturas de pantalla, escaneos de defectos, microediciones y reconstrucciones por igual. Construye completamente, inspecciona una vez con una ronda por lotes (escritorio y móvil juntos en la web; las clases de dispositivos enviados en una plataforma nativa), arregla todo lo que muestra en un lote, confirma con como máximo una ronda más, y deja de pulir. La auto-QA sin fin quema el dinero del usuario haciendo peor lo que las transferencias finales hacen mejor.
Configuración
- Ejecuta
<skill-base-dir>/scripts/impeccable contextuna vez por sesión, donde<skill-base-dir>es el directorio que contiene este SKILL.md (la carpeta de la habilidad, no una raíz de plugin dos niveles arriba); mantén el cwd en el proyecto del usuario. Ese directorio base resuelve cada comando.claude/skills/impeccable/scripts/impeccable <verbo>en esta habilidad y sus referencias, y.claude/skills/impeccable/scriptses el respaldo solo cuando el tiempo de ejecución no reporta un directorio base. En un shell de Windows sinsh, llama a.claude/skills/impeccable/scripts/impeccable.cmden su lugar. El lanzador ejecuta un binario autónomo que se envía junto a él o se descarga una vez en la primera ejecución; no se requiere Node ni otro tiempo de ejecución. Pasa un archivo fuente o ruta nombrado como--target <path>. Carga PRODUCT.md, DESIGN.md, el resumen de superficie correspondiente y la guía de plataforma nativa cuando corresponda; sigue sus directivas y no lo vuelvas a ejecutar. - Carga el manual de la solicitud: su tabla de referencia de Comandos para un subcomando explícito/implícito, o reference/new-work.md para una nueva superficie o mundo visual de reemplazo. Inspecciona el objetivo y la verdad visual actual antes de editar. Cuando la aplicación no pueda ejecutarse, comienza con los oros de regresión visual confirmados o fixtures de captura de pantalla; verifica el objetivo y la frescura contra los tokens, CSS, componentes o activos actuales, resuelve conflictos y compara capturas de temas/variantes.
- Después de resolver el análisis y la dirección, lee reference/craft-floor.md inmediatamente antes de cualquier edición UI, incluyendo refinamientos pequeños. Contiene el piso de calidad, las prohibiciones absolutas y los reflejos que ningún detector captura. No lo cargues para trabajo solo de planificación.
Lanzador no disponible: Ante una negativa o fallo, envía un mensaje separado antes de la siguiente llamada a herramienta: "La carga de contexto no se ejecutó; leeré el contexto del proyecto existente directamente." Luego lee PRODUCT.md y DESIGN.md existentes sin inventar contexto faltante, sigue los pasos aplicables 2–3 y continúa a través de las herramientas permitidas. Esto aplica para planificación y edición; el fallo del lanzador por sí solo no bloquea ninguno de los dos.
Cómo diseñar
- El resumen gana. Honra las estéticas, épocas, materiales, fuentes y paletas fijadas incluso cuando entren en conflicto con una advertencia de patrón saturado. Redirigir un resumen claro hacia tu gusto es un fracaso.
- El refinamiento preserva; el rediseño reemplaza. El refinamiento mantiene la identidad, el comportamiento, el copy y todo lo fuera del alcance existentes. Pregunta antes de reemplazar copy factual o agregar afirmaciones. El rediseño mantiene la verdad del producto, el contenido, la función, las capacidades nativas y las restricciones, pero trata la apariencia anterior como evidencia y antirreferencia; elige un mundo de reemplazo en new-work y reemplaza DESIGN.md. Nunca dividas la diferencia en pulido sobre la apariencia descartada.
- La autoridad visual es evidencia, no un nombre de archivo. La ausencia de DESIGN.md por sí sola no hace que un proyecto sea greenfield; new-work decide si preservar, expandir o reemplazar el mundo existente.
Modos
El modo nombra cómo se ve el éxito del visitante en esta superficie.
- Persuadir: el visitante decide y actúa; el diseño es el producto. Páginas de aterrizaje, marketing, campañas, precios. Gana atención y acción. Envía imágenes reales cuando el resumen lo necesite; sigue el mundo comprometido, no el hábito de categoría.
- Operar: el visitante completa una tarea. UI de aplicación, paneles, editores, administración, configuraciones, herramientas. La escaneabilidad, la consistencia, las expectativas nativas y la escena de uso real están por encima de la expresión. La marca vive en detalles precisos.
- Leer: el visitante entiende algo. Documentos, artículos, guías, ayuda, registros de cambios. Estructura para la comprensión, luego haz que la experiencia de lectura valga la pena quedarse.
- Experimentar: el visitante está dentro del trabajo mismo. Portafolios, galerías, escaparates. Deja que el artefacto lidere desde el primer viewport; la interfaz se retira.
Elige el modo según la superficie solicitada, no el producto, y persiste solo en ese resumen de superficie. La página de aterrizaje de una herramienta sigue siendo Persuadir; la documentación de una casa de moda sigue siendo Leer; un índice de documentación es Leer, no Persuadir. Consulta new-work.md para superficies nuevas y operate.md para orientación más profunda sobre Operar/Leer.
Comandos
| Comando | Categoría | Descripción | Referencia |
|---|---|---|---|
craft [feature] | Construir | Alias obsoleto para una solicitud ordinaria de new-work | reference/craft.md |
shape [feature] | Construir | Planificar UX/UI antes de escribir código | reference/shape.md |
init | Construir | Capturar contexto duradero del producto en PRODUCT.md | reference/init.md |
document | Construir | Generar DESIGN.md a partir del código del proyecto existente | reference/document.md |
extract [target] | Construir | Extraer tokens y componentes reutilizables al sistema de diseño | reference/extract.md |
critique [target] | Evaluar | Revisión de diseño UX con puntuación heurística | reference/critique.md |
audit [target] | Evaluar | Comprobaciones de calidad técnica (a11y, rendimiento, responsive) | reference/audit.md · nativo: reference/audit.native.md |
polish [target] | Refinar | Pase de calidad final antes del envío | reference/polish.md |
bolder [target] | Refinar | Amplificar diseños seguros o insípidos | reference/bolder.md |
quieter [target] | Refinar | Suavizar diseños agresivos o sobreestimulantes | reference/quieter.md |
distill [target] | Refinar | Reducir a la esencia, eliminar complejidad | reference/distill.md |
harden [target] | Refinar | Listo para producción: errores, i18n, casos límite | reference/harden.md |
onboard [target] | Refinar | Diseñar flujos de primera ejecución, estados vacíos, activación | reference/onboard.md |
animate [target] | Mejorar | Agregar animaciones y movimiento con propósito | reference/animate.md |
colorize [target] | Mejorar | Agregar color estratégico a UIs monocromáticas | reference/colorize.md |
typeset [target] | Mejorar | Mejorar jerarquía tipográfica y fuentes | reference/typeset.md |
layout [target] | Mejorar | Arreglar espaciado, ritmo y jerarquía visual | reference/layout.md |
delight [target] | Mejorar | Agregar personalidad y toques memorables | reference/delight.md |
overdrive [target] | Mejorar | Ir más allá de los límites convencionales | reference/overdrive.md |
clarify [target] | Corregir | Mejorar copy UX, etiquetas y mensajes de error | reference/clarify.md |
adapt [target] | Corregir | Adaptar para diferentes dispositivos y tamaños de pantalla | reference/adapt.md · nativo: reference/adapt.native.md |
optimize [target] | Corregir | Diagnosticar y corregir rendimiento UI | reference/optimize.md |
live | Iterar | Modo de variante visual: seleccionar elementos en el navegador, generar alternativas | reference/live.md |
Enrutamiento:
- Sin argumento: lee routing.md y presenta su menú contextual; nunca ejecutes un comando automáticamente.
- Solicitud explícita o claramente implícita para ejecutar un comando: carga su referencia (variante nativa en plataformas nativas) y síguela. Pregunta una vez si dos comandos encajan.
- Pregunta de flujo de trabajo o selección de comando: lee Preguntas de flujo de trabajo.
- De lo contrario: trata la solicitud como trabajo de diseño general. La falta de PRODUCT.md enruta una nueva superficie o mundo de reemplazo a través de init, luego new-work; un refinamiento estrecho del código existente procede en la implementación actual según lo indique
impeccable context, ofreciendo init después en lugar de bloquearse. teaches un alias deinit.craftes un alias obsoleto para new-work ordinario y no agrega nada.shapees dueño del descubrimiento de tareas, luego entra en new-work solo para decisiones de mundo visual y concepto de superficie.
Después de que init escribe PRODUCT.md, reanuda sin volver a ejecutar impeccable context; init carga la referencia de plataforma nativa por sí mismo cuando la plataforma que registró es ios, android o adaptive.
Fijar / Desfijar: .claude/skills/impeccable/scripts/impeccable pin <pin|unpin> <command> crea o elimina un acceso directo independiente /<command>. Reporta el resultado del script de manera concisa; transmite stderr textualmente en caso de error.
Hooks: /impeccable hooks <on|off|status|ignore-rule|ignore-file|ignore-value|reset> gestiona el hook detector de diseño para este proyecto (ejecuta automáticamente el detector después de ediciones de archivos UI y muestra hallazgos). Carga reference/hooks.md cuando el usuario lo invoca con cualquier argumento.
Doctor: /impeccable doctor reporta y repara la desviación entre los artefactos Impeccable de este proyecto (PRODUCT.md, DESIGN.md y su sidecar, configuración, resúmenes de superficie, el hook) y lo que esta versión lee. Carga reference/doctor.md cuando el usuario lo invoca, o cuando pregunta qué está desactualizado, obsoleto o necesita actualización. Una directiva CONTEXT_STALE en la salida de Configuración es el subconjunto económico del mismo informe; actúa sobre ella allí según sus propias instrucciones en lugar de ejecutar doctor sin que se le pida.
Nunca repares la desviación como efecto secundario de una tarea de diseño. Un hallazgo CONTEXT_STALE se reporta, no se actúa sobre él, a menos que el usuario lo solicite. La única excepción es un hallazgo marcado como auto, que la siguiente escritura en ese archivo realiza de todos modos.