Communitygithub.com

do-design

Diseño de UI y visual contra un DESIGN.md vinculante, con scripts para todo lo medible. Úsalo para diseñar o rediseñar páginas y componentes, revisar cambios de UI, auditar y puntuar una interfaz, rediseñar un sitio, investigar un mercado antes de diseñar, impulsar una dirección audaz o instalar una guarda de diseño en un repositorio. Comandos: do-audit, do-design-new, do-design-review, do-design-renew, do-crazy.

¿Qué es do-design?

do-design es una habilidad para agentes de IA (compatible con Claude Code, Cursor, Codex y otras herramientas) que impone un flujo de trabajo de diseño basado en un documento central llamado DESIGN.md. Este documento actúa como el «contrato» vinculante que define las reglas visuales y de experiencia del proyecto. La habilidad proporciona una serie de comandos (do-audit, do-design-new, do-design-review, do-design-renew, do-crazy) que orquestan scripts de Python para medir aspectos como el cumplimiento del DESIGN.md, contraste, ritmo tipográfico, jerarquía, usabilidad y distinción. También incluye capas de diseño modulares (color, tipografía, espacio, movimiento, voz, investigación) y un sistema de puntuación ponderado que evalúa la interfaz renderizada, no el código fuente. Es especialmente útil porque obliga a basar las decisiones en evidencia real (scripts, datos de competidores, métricas) en lugar de en suposiciones, y proporciona mecanismos para evitar la deriva del diseño, como el «swap test» que verifica si la página es genérica o realmente distintiva del producto. No rompe código funcional y siempre prioriza el brief del proyecto sobre el gusto personal.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diononline-un/design-skill/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

¿Qué hace do-design?

Las rutas son relativas a la carpeta de esta habilidad; P es la raíz del proyecto. Los scripts son stdlib Python 3.8+. Ejecuta el script antes de razonar sobre cualquier cosa que mida, cita su salida y nunca vuelvas a derivar ni estimes lo que informa.

Modelo

  1. El DESIGN.md del proyecto (el papel) es vinculante y prevalece sobre esta habilidad. En caso de conflicto, el papel gana; dilo.
  2. Cada regla lleva su razón. Una regla sin ella se elimina la primera vez que resulte inconveniente.
  3. Evidencia antes que valores predeterminados. Un brief breve ("hazlo nuevo" + un logotipo) es una razón para investigar, no para recurrir al aspecto habitual ni para inventar hechos. Sin fuente, no hay afirmación: marca el vacío o pregunta.
  4. Carga perezosa. Solo los archivos que menciona la tabla de comandos. Las capas adicionales "por completitud" son un fallo de método.
  5. La convención es el valor predeterminado, no el fracaso. El modo decide cuánto desviarse.

Modos: indica una línea al inicio de cada comando

ModoEl visitante estáEmpuje
PersuadirDecidiendo y actuandofuerte: una plantilla es un fracaso
OperarCompletando una tareacontención: la convención es una característica
LeerEntendiendo algomedio: la comodidad de lectura gana
ExperimentarDentro de la obra mismafuerte: el artefacto lidera

Elige por superficie, no por producto: la página de inicio de una herramienta de desarrollo es Persuadir, su pantalla de configuración es Operar.

Comandos: carga un archivo de comando, más lo que nombran sus filas

ComandoCuándo usarloTambién cargarRiesgo
do-design-review"¿Esto coincide con el papel?" El más barato, ejecútalo másel DESIGN.md del proyecto-
do-audit"¿Qué tan bueno es esto?" Puntuación + hallazgos clasificadosreferences/critique-rubric.md, references/slop-catalog.md, capas 00-05 que toca el alcance-
do-design-new"Construye X": convencional, competente, según el papellayers/00, las capas 1-3 que toca la tarea; layers/06 cuando el brief es escaso o está orientado al clientebajo
do-design-renew"Rehaz este aspecto": mundo nuevo, misma verdad del productolayers/00, layers/06medio
do-crazy"Algo que nadie en este sector haría"layers/00, layers/06alto, por diseño

Capas: 00-craft-floor (todo modo) · 01-color · 02-typography · 03-space-layout · 04-motion-states · 05-voice · 06-research. Escribir un papel: templates/DESIGN.md, examples/01-two-papers.md, references/interview.md.

Scripts (todos aceptan --json)

EjecutaProporciona
scripts/check-design.py --root PDesviación del bloque de tokens del papel. Salida 0 limpia, 1 desviación, 2 sin papel/tokens. --init redacta tokens a partir del código
scripts/audit.py scan PIndicios de fuente (ID como en el catálogo slop), brechas de accesibilidad y superficie del navegador, inventario de valor
scripts/audit.py copy PIndicios de prosa y microcopia, ritmo de oraciones, marcadores de brecha sin llenar
scripts/audit.py contrast FG BG / --paper P/DESIGN.mdRatios WCAG
scripts/audit.py score H L S C T U DPuntuación ponderada, banda, lista de trabajo
scripts/render-audit.py URL-o-archivo [--shots DIR] [--inject-css FILE]La página pintada a 1280/768/390: superposición, desplazamiento lateral, recorte, contraste pintado, objetivos táctiles, visibilidad de enfoque. --inject-css mide una corrección CSS contra la página desplegada antes de desplegar. Necesita Chrome/Chromium
`scripts/research.py suggestprofile
bash scripts/install-guardrails.sh PDESIGN.md a partir de la plantilla, el bloque AGENTS.md/CLAUDE.md, el verificador

Las capturas de pantalla cuestan mucho más contexto que la salida del script: tómalas solo para lo que necesita ojos (jerarquía, distinción, composición), solo viewport, 390 primero. Los scripts también pueden estar equivocados: antes de informar un P0 que parezca improbable, confírmalo una vez (una captura de pantalla específica o la geometría del elemento) y corrige el script si fue un falso positivo.

Definiciones compartidas

Prueba de intercambio. Reemplaza el nombre del producto por el de un competidor. Si nada se rompe, la página no dice nada sobre este producto: no elegido, no feo. Arréglało en la copia, lo visual y un detalle distintivo, nunca añadiendo decoración.

Dirección, cinco líneas. Escrita antes de construir, mostrada, luego espera un sí (si te dicen "solo hazlo", expresa la suposición en una línea y continúa):

Producto:   qué hace, para quién, una frase sencilla
Carácter:   2-3 palabras concretas (nunca limpio, moderno, elegante, mínimo, premium)
Mundo:      el lugar o material al que pertenece; establece el tono neutro, el acento, las imágenes
Momentos:   1-2 lugares donde la pantalla se vuelve rica
Firma:      un solo detalle que solo tiene este producto, usado de forma consistente

Marcador de brecha. [número necesario], [fuente necesaria], [foto necesaria] donde falta un hecho o activo. audit.py copy lista los que aún están abiertos; ninguno puede enviarse.

Puntuación: todo comando evaluador termina con ella

#CampoPreguntaP
1Jerarquía¿Se puede nombrar lo más importante en 2 segundos?3
2LegibilidadContraste, tamaño, medida, copia real en cada ancho3
3SistemaUna paleta, una escala, una lógica de radio, un lenguaje de movimiento2
4ArtesaníaAlineación, ritmo de espaciado, estados, superficies del navegador2
5Verdad del contenidoDatos reales, copia específica, sin afirmaciones inventadas3
6UsabilidadLa tarea se completa; las affordances son obvias; los errores son recuperables3
7Distinción¿Pasa la prueba de intercambio?2

Puntúa cada uno 0-4 (4 = genuinamente excelente, no "aceptable") y calcula con audit.py score. Bandas: 85+ Fuerte, envía y corrige solo P0 · 70-84 Sólido, envía después de los P1 nombrados · 50-69 Débil, una revisión real primero · <50 Fallando, la dirección es incorrecta: reconstruye (do-design-renew). Puntúa el render, no la fuente. Un campo que no pudiste verificar es u: puntúa 0 y dice unverified, nunca una estimación. Distinción obtiene 4 solo si puedes nombrar qué lo hace ser de este producto. Los tres peores campos son la lista de trabajo, una acción cada uno.

Gravedad: P0 bloquea el envío (roto, ilegible, prohibición dura), informa todos · P1 daña la confianza, top 5 · P2 artesanía, top 5 · P3 pulido, solo lista. Formato del hallazgo: [Pn] ubicación - qué está mal - corrección; los hallazgos del script mantienen su ID.

Sin papel

Di "No hay DESIGN.md: la guarda no tiene nada que hacer cumplir." Ofrece escribirlo (plantilla + entrevista), o una adaptación retrospectiva desde el código (check-design.py --init + entrevista §Retrofit): v1.0 es lo que se envía, los valores antiguos van a legacy: (contados, no fallidos), las brechas a la lista de delta del papel. Los archivos y demos permanecen fuera de todo escaneo mediante skip: en el bloque de tokens (o --skip a,b), por carpeta o archivo. Busca importaciones antes de saltar: las carpetas de archivo a menudo tienen partes activas. Nunca inventes un papel para que el verificador pase.

No negociables

  1. Nunca rompas código funcional. Props, estado, enrutamiento, manejadores y accesibilidad sobreviven; la copia mantiene su significado.
  2. El brief gana. Una marca, fuente o color declarados superan el gusto, incluso en una lista de rechazo. Escríbelo en el papel (allow: en el bloque de tokens desactiva una regla del verificador o un ID de auditoría a propósito).
  3. Nunca inventes hechos, activos o fuentes. Elimina una afirmación vaga; nunca la reemplaces con una específica inventada. Usa un marcador de brecha.
  4. Mantén la voz del autor. Elimina los hábitos de máquina, conserva las peculiaridades de la persona.
  5. Densidad, no presencia. Actúa sobre grupos (3+ indicios P0/P1 distintos), nunca sobre un gradiente o una raya em. Un resultado limpio es válido; nunca fabriques hallazgos.
  6. Corrige, nunca acuses. Nunca digas "esto parece generado por IA"; nombra lo que no está elegido y qué hacer en su lugar.
  7. Solo lectura a menos que se solicite para revisiones y auditorías.

Skills relacionados