Communitygithub.com

craft-setup

Usa cuando se solicite diseñar o crear una página, pantalla o elemento en un proyecto sin `DESIGN.md` en la raíz, cuando la persona pida configurar, definir o iniciar el diseño, estilo, marca o guías de un producto, o ejecute `/craft-setup` (`/craft:craft-setup` en el plugin de Claude Code).

¿Qué es craft-setup?

El skill `craft-setup` guía el proceso de establecimiento de la base de diseño de un producto antes de crear cualquier pantalla. Reemplaza la especulación con una metodología estructurada de entrevista: primero se lee la documentación y el código existentes para no preguntar lo ya respondido, luego se hacen preguntas una por una (con opciones) sobre producto, audiencia, voz, estado de ánimo, marca, referencias y restricciones. El resultado es un archivo `DESIGN.md` con ocho secciones que sirve como referencia única para futuras decisiones de diseño. Si el código ya tiene un sistema de diseño (tokens, componentes, paquete UI), ofrece importarlo al tool de diseño mediante el sub-skill `craft-sync`; si no existe sistema, delega la creación de fundamentos (tokens, tipografía, espaciado, reglas de interacción) al sub-skill `craft-system`. El skill está diseñado para herramientas como Claude Code, Cursor o Codex, y enfatiza que no se deben inventar decisiones de marca (colores, fuentes, tono) a menos que la persona las confirme explícitamente, marcando como "(asumido)" cualquier inferencia. También incluye manejo del comando "skip" para casos de urgencia, donde se genera un `DESIGN.md` mínimo y se procede directamente a las bases técnicas.

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

Preguntar en tu IA favorita

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

Documentación

Configuración de diseño

Resumen

Antes de la primera pantalla, acuerda qué es el producto, para quién es, cómo debe sentirse y cómo nunca debe verse. Escríbelo en DESIGN.md, el resumen que toda decisión de diseño posterior leerá primero. Pregunta, no inventes: una marca creada por el agente es una suposición que la persona tendrá que deshacer. Lee lo que existe, entrevista a la persona una pregunta a la vez, escribe el resumen, detente para aprobación y luego construye los fundamentos.

Cuándo usarlo

  • Una tarea de diseño y no hay DESIGN.md en la raíz del proyecto.
  • "Configurar el diseño", "definir nuestro estilo / marca / guías", /craft-setup (/craft:craft-setup en el plugin de Claude Code).

Cuándo NO usarlo

  • DESIGN.md existe y la tarea es de diseño: usa craft.
  • Cambiar un token o una guía: usa craft-system.

Pasos

  1. Lee primero. README, docs, CSS existente o tokens, el archivo de diseño, carpetas de marca, cualquier borrador antiguo de DESIGN.md. Anota lo que ya responden. Si el código ya tiene un sistema de diseño (un paquete UI, archivos de tokens, una biblioteca de componentes), dímelo con conteos y escribe "Fuente del sistema de diseño: <ruta>" en la sección Marca del resumen. En el paso 6, ofrece importarlo al tool de diseño en lugar de crear fundamentos; las preguntas de marca que responda se saltan. Dos paquetes UI → pregunta cuál es la fuente antes de saltar cualquier pregunta de marca. Nunca preguntes algo que estos archivos respondan. Confírmalo en una línea ("Tu README dice solo pt-BR y miembros mayores de 60, así que diseñaré para texto de 18px y toques de 48px").
  2. Entrevista, una pregunta por mensaje. Sigue la entrevista en su orden: producto, audiencia y voz, estado de ánimo, marca, referencias, restricciones.
    • Ofrece 3–5 opciones más "algo más" siempre que puedas.
    • Salta cualquier pregunta ya respondida.
    • Detente cuando las respuestas sean suficientes para diseñar la primera pantalla. Seis buenas respuestas superan a quince.
  3. Las referencias son obligatorias. Pide de 2 a 5 productos, sitios o imágenes que les gusten. Para cada uno, pregunta qué tomar y qué evitar. Si es un enlace o imagen que puedas abrir, míralo y di lo que ves antes de preguntar.
  4. Escribe DESIGN.md en la raíz del proyecto usando la plantilla, con las ocho secciones: Producto, Audiencia y voz, Estado de ánimo, Marca, Referencias, Restricciones, Registro de decisiones, Preguntas abiertas.
    • Usa sus palabras cuando puedas.
    • Todo lo que hayas inferido y no hayan confirmado va a Preguntas abiertas, no al resumen como hecho.
  5. Detente y muestra a la persona DESIGN.md. Cámbialo hasta que lo aprueben.
  6. Fundamentos.
    • Sistema de diseño ya en código: ofrece la importación. En caso afirmativo, SUB-SKILL OBLIGATORIO: craft-sync (importar). Muestra un inventario y pregunta qué componentes dibujar. En caso negativo, registra " — Importación a rechazada" en el registro de decisiones. Ofrécelo incluso después de "saltar": se trata del tool de diseño, no del resumen.
    • Sin sistema en código: SUB-SKILL OBLIGATORIO: craft-system en modo creación para los fundamentos (tokens, tipografía, espaciado, reglas de interacción). Tiene su propia parada de aprobación.
    • Los tokens y estilos existentes son el punto de partida: extiéndelos, no los renombres ni los muevas sin preguntar.

Si la persona dice "saltar" o "solo diseñalo"

No sigas preguntando. Escribe un DESIGN.md mínimo a partir de lo que leíste y lo que dijeron:

  • cada vacío se convierte en una Pregunta abierta;
  • cada suposición se marca como "(asumido)".

Di en una línea qué suposiciones importan más. "Saltar" omite la entrevista y la parada de aprobación del resumen, nunca el paso 6:

  • sistema de diseño en código → aún así haz la pregunta de importación única ("¿Importarlo a ahora? Te mostraré lo que hay y tú eliges los componentes"), luego continúa;
  • aún sin tokens → el paso de fundamentos y su parada aún se ejecutan, porque craft solo puede dibujar con piezas del sistema.

Luego continúa con la tarea que pidieron.

Antes de empezar

  • Si ningún adaptador en references/adapters/ coincide con tu herramienta, haz los mismos verbos en tu herramienta y di cuáles mapeaste manualmente. Sin tool de diseño, construye en HTML (html.md). Si solo tienes una imagen, di que los valores leídos de ella son estimaciones.
  • DESIGN.md es un archivo Markdown simple en el repositorio en cualquier tool. Solo el tablero de referencias opcional vive en el tool de diseño.

Reglas

ReglaPor qué
Una pregunta por mensaje, con opcionesUn muro de preguntas se hojea y se responde a medias
Lee antes de preguntar; nunca preguntes lo que dicen los archivosPreguntar qué hay en el README les dice que no miraste
No inventes marca: los colores, fuentes y estado de ánimo vienen de ellos o se marcan como "(asumido)"Una marca inventada es una suposición que tienen que deshacer pantalla por pantalla
Las referencias siempre vienen con tomar/evitar"Me gusta Stripe" no sirve; "tomar el espaciado calmado, evitar los degradados" es una regla
"Nunca como..." se pregunta explícitamenteLo que evitar acota el diseño más rápido que lo que buscar
No rediseñes archivos existentes durante la configuraciónLa configuración registra decisiones; cambiar su CSS es una tarea de diseño que aún no pidieron
Sin pantallas durante la configuraciónLas pantallas vienen de craft, después de que el resumen y los fundamentos estén aprobados

Hecho cuando

DESIGN.md está aprobado con sus ocho secciones, y los fundamentos están resueltos: creados y aprobados a través de craft-system, o (con un sistema en código) importados a través de craft-sync o la importación rechazada y registrada. Después de un "saltar": DESIGN.md está escrito con sus suposiciones marcadas, los fundamentos existen (aprobados, o ya en el proyecto), y la tarea original ha continuado.

Errores comunes

PensamientoRealidad
"Elegiré una bonita paleta y fuentes, pueden cambiarlo"No pueden cambiar lo que no sabían que se decidió. Pregunta, o márcalo como "(asumido)".
"Ya que estoy aquí, haré maquetas de las pantallas principales"Eso es trabajo de craft, después de la aprobación. La configuración termina en el resumen y los fundamentos.
"Déjame preguntar las seis preguntas a la vez para ahorrar tiempo"Una por mensaje, con opciones. Es más rápido para ellos responder.
"Sus tokens son un desastre, los reestructuraré"Extiéndelos. Reestructurar es un cambio separado y aprobado.
"No dieron referencias, omitiré esa sección"Pídelas. Si no tienen, ofrece tres que encajen con el estado de ánimo y pregunta qué tomar y evitar de cada una.

Individual skills in this repo

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

Skills relacionados