Communitygithub.com

craft

Crea, diseña o rediseña páginas, pantallas, flujos o elementos de interfaz de usuario siguiendo el sistema de diseño y verificando el resultado.

¿Qué es craft?

Craft es la habilidad principal para crear cualquier elemento visual desde cero o rediseñar existentes. Actúa como el punto de entrada que transforma una instrucción como 'diseña la página de precios' en un diseño terminado y revisado. Funciona a partir del brief del proyecto, cubre todos los estados, ofrece opciones solo si la dirección no está definida, utiliza exclusivamente las piezas del sistema de diseño y verifica su propio trabajo antes de mostrarlo. **No reemplaza a otras habilidades de diseño**, sino que las invoca en puntos fijos del proceso. Soporta plataformas como Claude Code y Cursor, y se integra con herramientas de diseño (Figma, HTML, etc.) según lo que esté disponible en el proyecto. Su flujo incluye pasos obligatorios: leer DESING.md, definir el alcance, generar la lista de estados (craft-states), explorar opciones solo si es necesario (craft-explore), dibujar usando solo tokens y componentes del sistema (con craft-system para añadir nuevos, craft-sync para importar componentes de código), y finalmente autoevaluarse con craft-critique. Craft asegura que las decisiones queden documentadas en DESING.md y que no se modifiquen valores del sistema localmente en una página.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft

Preguntar en tu IA favorita

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

Documentación

¿Qué hace craft?

Resumen

La puerta de entrada para crear cualquier elemento visual. Convierte "diseña la página de precios" en un diseño terminado y revisado. Trabaja a partir del brief del proyecto, cubre todos los estados, ofrece opciones solo cuando la dirección está abierta, utiliza únicamente las piezas del sistema de diseño y verifica su propio trabajo antes de mostrarlo. Invoca a las demás habilidades de diseño en puntos fijos; no las reemplaza.

Cuándo usarlo

  • "Diseñar / crear / maquetar / rediseñar <página, pantalla, flujo, elemento>", /craft (/craft:craft en el plugin de Claude Code).
  • Varias páginas a la vez ("diseña la incorporación: bienvenida, registro, verificación").

Cuándo NO usarlo

  • Una pequeña edición que la persona describió exactamente (un valor, una etiqueta, un tamaño): hazlo directamente.
  • Solo una revisión ("¿qué tiene de malo esto?"): craft-critique. Solo opciones: craft-explore.

Antes de empezar

  • Si no hay un adaptador en references/adapters/ que coincida con tu herramienta, realiza las mismas acciones en tu herramienta e indica cuáles mapeaste manualmente. Sin ninguna herramienta de diseño, crea en HTML (html.md). Si solo tienes una imagen, indica que los valores leídos de ella son estimaciones.

Las paradas son reales

Una parada significa: termina tu turno con la pregunta y espera. Siempre puedes hacerlo, incluso en una sesión de un solo mensaje o sin cabeza, donde tu mensaje final es la pregunta. Nunca decidas una parada por la persona porque la sesión "no puede esperar" o "para ahorrar un viaje de ida y vuelta". Decidirla tú mismo convierte una respuesta de cinco segundos en horas de rehacer.

Pasos

  1. Contexto.
    • Lee DESIGN.md en la raíz del proyecto. Si falta, o no tiene sección de Producto (un registro solo de sincronización) → SUB-HABILIDAD REQUERIDA: craft-setup, luego vuelve aquí.
    • Lee el sistema de diseño (tokens, componentes, guía) y las pantallas relacionadas con esta.
    • Cuando el brief y el código discrepen (el brief dice verde azulado, los tokens dicen azul): sigue el código, indícalo en una línea, añade el conflicto a DESIGN.md › Preguntas abiertas, y ofrece actualizar lo que sea incorrecto. Nunca sobrescribas tokens dentro del CSS de una página.
    • Cuando la guía de la herramienta de diseño y el código difieran y exista un design-sync.json, no consideres la guía como desactualizada. Clasifícalo con él: código cambiado → ofrece actualizar la guía antes de dibujar; guía cambiada → es un cambio de la persona que espera una exportación, así que dibuja con él y menciona la exportación pendiente.
  2. Alcance en palabras. Enumera cada página o elemento a crear, cada uno con su función y su siguiente acción.
    • Las palabras ambiguas reciben una interpretación claramente expresada ("página de precios = la lista de precios de la panadería, no los planes de suscripción").
    • Pausa y confirma la lista cuando haya más de un elemento o la solicitud sea vaga. Un elemento claro: continúa.
  3. Para cada elemento, en orden:
    1. SUB-HABILIDAD REQUERIDA: craft-states. Su lista de estados escrita y su pausa son lo primero.
    2. ¿Dirección abierta? Solo cuando la persona pidió ideas, o cuando dos estructuras de diseño diferentes sean plausibles y ni el brief ni el sistema elijan entre ellas → SUB-HABILIDAD REQUERIDA: craft-explore antes de dibujar los estados. Para varias páginas, pregunta en la pausa del alcance qué página (si alguna) recibe opciones; nunca ejecutes una ronda de opciones por página por defecto. Luego, los estados se dibujan en la dirección elegida. Una pantalla que sigue un patrón existente va directamente al dibujo.
    3. Dibuja el estado principal, luego los otros estados, usando solo las piezas y tokens del sistema. Algo nuevo (un componente, un color, un tamaño que la escala no tiene) → SUB-HABILIDAD REQUERIDA: craft-system (modo añadir) antes de usarlo. Un componente que existe en código pero no está dibujado en la herramienta ("solo en código" en el índice) → SUB-HABILIDAD REQUERIDA: craft-sync (importación de un componente), dibujando solo ese componente primero. Si la persona rechazó la importación (ver DESIGN.md), pregunta una vez antes de importar; si aún dicen que no, construye a partir de los valores del código en el propio tablero y anótalo. Nunca dibujes un imitación, y nunca codifiques un nuevo valor en una página.
    4. SUB-HABILIDAD REQUERIDA: craft-critique en modo autoverificación en cada tablero: renderiza, corrige lo que encuentre dentro del alcance de esta tarea, y renderiza de nuevo.
  4. Cerrar.
    • Muestra el resultado con el resumen a continuación.
    • Añade las decisiones a DESIGN.md › Registro de decisiones (fecha, decisión, por qué).
    • Mueve cualquier pregunta que haya sido respondida fuera de Preguntas abiertas.

Resumen de cierre (la forma de tu mensaje final)

Hecho: <páginas/elementos> — <dónde: archivos o tableros>
Decisiones: <cada una, una línea con su por qué> (también en DESIGN.md › Registro de decisiones)
Cambios del sistema: <piezas o tokens añadidos/cambiados> — afecta a: <pantallas>
Autoverificación corregida: <lo que craft-critique cambió antes de que lo vieras>
Preguntas abiertas: <lo que la persona aún tiene que decidir>

Reglas

ReglaPor qué
DESIGN.md primero, siempreSin el brief, cada pantalla inventa su propio estilo
Alcance confirmado antes del trabajo cuando hay más de un elementoTres páginas construidas sobre una lectura incorrecta son tres páginas desperdiciadas
Lista de estados antes de dibujar (mediante craft-states)El camino feliz es uno de muchos estados
Opciones solo cuando la dirección está abiertaOpciones sobre un patrón resuelto desperdician la atención de la persona
Solo piezas y tokens del sistema; los nuevos pasan por craft-systemLos valores codificados en páginas son donde comienza la deriva
El código prevalece sobre un brief desactualizado; anótalo, no lo sobrescribasLos tokens son lo que se envía; el brief se actualiza por decisión, no en silencio
Autoverificación antes de mostrarLa persona debe revisar el diseño, no atrapar errores
Las decisiones van a DESIGN.mdLa próxima sesión de diseño comienza desde ellas, no de la memoria

Hecho cuando

Cada elemento del alcance confirmado tiene sus estados dibujados y autoverificados, cualquier cambio del sistema ha pasado por craft-system, se ha dado el resumen de cierre y se ha actualizado el registro de decisiones de DESIGN.md.

Errores comunes

PensamientoRealidad
"Tres páginas son suficientemente claras, solo las construiré"Confirma la lista primero. Cuesta un mensaje.
"Haré botones de 52px aquí; el token dice 44, pero este público necesita más grande"Esa es una decisión del sistema. Propónlo mediante craft-system, luego úsalo en todas partes.
"El brief dice verde azulado, así que sobrescribiré el azul en el CSS de esta página"El código gana. Marca el conflicto y pregunta; nunca parchees tokens localmente.
"Lo mostraré, ellos me dirán qué está mal"Ejecuta craft-critique en modo autoverificación primero, y di lo que corrigió.
"Las decisiones están en mi mensaje, eso es suficiente"Los mensajes se pierden. Añádelas a DESIGN.md.
"Esta sesión no puede detenerse por respuestas, así que tomaré las decisiones yo mismo y las enumeraré"Terminar tu turno con la pregunta es detenerse. Haz eso; no construyas nada más allá de la primera pausa abierta.
"Para ahorrar un viaje de ida y vuelta pondré ambas pausas en un solo mensaje"Está bien, si luego te detienes. Pregunta ambas, no construyas nada, espera.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados