Diseño y frontend Guía paso a paso

DESIGN.md con Refero: dale a Claude un sistema de diseño real

Aprende a coger el sistema de diseño de una web que te guste en formato DESIGN.md, convertirlo en una skill permanente de Claude y usarlo para construir y publicar páginas que no parezcan hechas en serie. Pensado para quien diseña con Claude y está cansado del aspecto genérico.

Nivel
Intermedio
Qué necesitas
Una cuenta de Claude; para construir y publicar, Claude Code, Node.js 18 o superior, Git y Python 3.
Cuánto lleva
Unos 20 minutos para preparar la skill; la web, lo que tarde el proyecto

Herramientas que usa esta guía

01 Por qué tus diseños con IA se parecen todos

Cuando le pides a Claude una página sin más contexto, rellena los huecos con lo más probable: degradados violetas, tarjetas con sombra suave, tipografía sin personalidad. No es falta de capacidad, es falta de instrucciones concretas. «Moderno y elegante» no es una especificación; #1F2937 sí lo es.

Un DESIGN.md es un archivo Markdown que describe un sistema visual con valores exactos (colores, tipografías, espaciados, radios, componentes) y con reglas en prosa que explican cuándo usar cada cosa y qué evitar. Los agentes de código lo leen como leerían un AGENTS.md, pero para el aspecto en vez de para el código.

01

Tokens

Colores, tamaños de letra, espaciados y radios con su valor numérico. Eliminan la interpretación.

02

Componentes

Cómo son los botones, campos, tarjetas y estados. Evitan que cada pantalla invente su propio botón.

03

Criterio

El porqué de cada decisión: densidad, jerarquía, tono, movimiento.

04

Prohibiciones

Lo que esa estética nunca hace. Es la parte que más reduce el aspecto genérico.

markdown · Ejemplo mínimo de DESIGN.md (inventado, solo para ver la forma)
---
name: Taller Norte
colors:
  ink: "#16181D"
  paper: "#FAF8F4"
  accent: "#C2410C"
typography:
  heading:
    fontFamily: Fraunces
    fontSize: 2.75rem
  body:
    fontFamily: Inter
    fontSize: 1rem
rounded:
  md: 6px
spacing:
  section: 96px
---

## Reglas
- El acento solo en llamadas a la acción y enlaces.
- Fondos lisos; nada de degradados ni cristal esmerilado.
- Secciones con mucho aire: nunca menos de 64px entre bloques.

02 Paso 1: consigue un DESIGN.md

Tienes tres caminos. Refero Styles (styles.refero.design) es una biblioteca con más de 2.000 sistemas de diseño extraídos de webs de producto conocidas: abres la ficha de una marca, ves su paleta, tipografía y componentes, y copias el DESIGN.md. Navegar y copiar no requiere pagar; la integración que conecta Refero directamente con tu asistente es un servicio aparte.

Si prefieres algo abierto y versionado, la colección awesome-design-md en GitHub recopila más de 80 archivos de webs orientadas a desarrolladores. Y si tienes marca propia, escribe el tuyo siguiendo la especificación publicada por Google Labs, que además trae un validador.

Opción Variedad Cuándo elegirla
Refero Styles Más de 2.000 estilos con vista previa Buscas el aspecto de una web concreta o un estilo muy específico
awesome-design-md Más de 80 archivos, licencia abierta Quieres una fuente estable que puedas guardar en tu repositorio
Tu propio DESIGN.md Exactamente tu marca Ya tienes manual de identidad y quieres que Claude lo respete
bash · Validar un DESIGN.md propio (contraste, referencias rotas, estructura)
npx @google/design.md lint DESIGN.md

03 Paso 2: guárdalo como skill para no pegarlo nunca más

Pegar el archivo en cada conversación funciona, pero se olvida y ocupa contexto. Lo eficaz es envolverlo en una skill: una carpeta con un SKILL.md cuyo encabezado indica el nombre y cuándo debe activarse. Claude la carga sola cuando la petición encaja con la descripción.

markdown · ~/.claude/skills/estilo-taller-norte/SKILL.md
---
name: estilo-taller-norte
description: Sistema visual de Taller Norte. Úsalo siempre que se diseñe, maquete o revise cualquier pantalla, página, componente o presentación de Taller Norte.
---

# Estilo Taller Norte

Este archivo es la única fuente de verdad para colores, tipografía,
espaciado y componentes. Si falta un valor, derívalo de los existentes
y avisa de que lo has derivado.

## Ajustes propios del proyecto
- (tus excepciones, por ejemplo: esquinas de 10px en vez de 6px)

## DESIGN.md
(pega aquí el archivo completo, sin recortar)
  1. 1

    Claude Code

    Crea la carpeta en ~/.claude/skills/ (para todos tus proyectos) o en .claude/skills/ dentro del proyecto si solo aplica a uno. El archivo debe llamarse exactamente SKILL.md.

  2. 2

    App de Claude

    Comprime la carpeta en .zip y súbela desde Customize > Skills. Antes, en Settings > Capabilities, activa la ejecución de código y creación de archivos.

  3. 3

    Comprueba que se activa

    Abre una conversación nueva y pide una pantalla sin nombrar la skill. Si no la usa, la descripción es demasiado vaga: añade el nombre de la marca y verbos como diseñar, maquetar o revisar.

04 Paso 3: construye con UI/UX Pro Max sin que cambie tu paleta

UI/UX Pro Max es una skill gratuita que aporta criterio de interfaz: jerarquía, accesibilidad, patrones por sector y buenas prácticas por framework. Consulta su base de datos con un script de Python, así que necesitas python3 instalado (compruébalo con python3 --version).

text · Instalación como plugin dentro de Claude Code
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
bash · Alternativa: CLI oficial, instalación global
npm install -g ui-ux-pro-max-cli
uipro init --ai claude --global
Prompt · Prompt para construir respetando tu DESIGN.md
Diseña la página de servicios de mi empresa usando UI/UX Pro Max para la estructura, la accesibilidad y los patrones de interfaz.

Regla principal: los colores, la tipografía, los espaciados, los radios y los componentes salen únicamente de mi skill estilo-taller-norte. No uses paletas ni pares tipográficos de tu catálogo. Si necesitas un valor que no existe, derívalo de los que hay y anótalo en una lista al final.

Cuando termines, revisa la página sección por sección contra el DESIGN.md y dame una tabla con cada desviación encontrada y cómo la corregirías.

05 Paso 4: publícalo con Claude Web Builder

Claude Web Builder (repositorio claude-webkit) es una plantilla de proyecto para Claude Code que te entrevista sobre tu negocio, monta una landing con Next.js, Tailwind CSS y shadcn/ui, te enseña una vista previa y la despliega en Vercel con una URL pública. El despliegue no exige cuenta de Vercel; si quieres conservar la web, la reclamas después con una cuenta gratuita.

bash · Descargar el proyecto y abrir Claude dentro
git clone https://github.com/Hainrixz/claude-webkit.git
cd claude-webkit
claude

06 Usos en negocio y límites que debes conocer

01

Agencias

Un DESIGN.md por cliente guardado en su repositorio: cualquier persona del equipo o cualquier agente produce piezas coherentes.

02

Pymes sin diseñador

Parte de un estilo de referencia, cambia los colores por los de tu marca y obtén una base profesional en una tarde.

03

Producto digital

La misma skill sirve para la web, el panel de la aplicación y las presentaciones comerciales.

04

Revisiones

Pide a Claude que audite pantallas existentes contra el archivo y te devuelva la lista de incoherencias.

  • ✓Inspirarte en la estructura de un estilo es legítimo; copiar logotipos, nombres, fotografías, textos o tipografías de pago de otra marca no lo es.
  • ✓Sustituye siempre los colores de la marca original por los tuyos: si alguien puede confundir tu web con la suya, te has pasado.
  • ✓El archivo es una foto fija: si la marca rediseña, tu DESIGN.md no se actualiza solo.
  • ✓Un buen sistema visual no arregla una mala estructura de contenidos ni textos flojos.
  • ✓Si el resultado se ve barato, revisa primero el espaciado: es lo que antes se desvía.

Preguntas frecuentes

No para los pasos 1 y 2, que son copiar un archivo y guardarlo como skill. Para construir y publicar necesitas instalar Claude Code, Node.js, Git y Python y ejecutar unos pocos comandos en la terminal, pero el código lo escribe Claude.

Sí. DESIGN.md es un formato abierto en Markdown que también entienden otros agentes de código. Lo que cambia es cómo se carga: en Claude lo más cómodo es una skill; en otros agentes, dejar el archivo en la raíz del proyecto.

El archivo describe decisiones de diseño genéricas (espaciados, jerarquía, contrastes), que puedes usar como inspiración. Lo que no debes reproducir es la identidad: nombre, logotipo, imágenes, textos ni tipografías con licencia. Adapta los colores a tu marca.

Comprueba que la skill está activa, que su descripción menciona tu marca y tareas de diseño, y repite en el prompt que la skill es la única fuente de colores y tipografía. Pedirle una auditoría final contra el archivo suele destapar las desviaciones.

Sobre el autor

Equipo editorial de appyweb

Marketing, SEO y desarrollo con IA

Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.

Sigue con estas guías

Guía paso a paso · Principiante

Awesome DESIGN.md: sistemas de diseño listos para que Claude maquete con estilo

Awesome DESIGN.md es una colección abierta de más de 80 archivos DESIGN.md que describen en texto el sistema visual de webs conocidas: colores, tipografías, componentes y espaciados. Copias uno en tu proyecto, se lo indicas a Claude y obtienes interfaces coherentes en vez de diseños genéricos. Aquí verás cómo usarlo y cómo crear el tuyo propio.

Unos 10 minutos para aplicar tu primer DESIGN.md. Leer la guía →
Guía paso a paso · Principiante

Kit de diseño para Claude Code: 5 skills para crear, animar y auditar interfaces

Cinco skills de código abierto que convierten a Claude Code en un equipo de diseño: una fija la dirección visual, otra aporta criterio de estilos y paletas, otra cuida el movimiento, otra produce prototipos y presentaciones, y la última revisa el resultado. Para quien quiere webs y apps que no parezcan una plantilla.

Unos 20 minutos para instalarlas y hacer la primera prueba Leer la guía →
Guía paso a paso · Principiante

Claude Web Builder: crea la web de tu negocio con Claude Code

Para autónomos y pequeños negocios que quieren una página de aterrizaje propia sin programar. Claude Web Builder convierte Claude Code en un diseñador web que te entrevista, construye la página en Next.js, la revisa en móvil y escritorio y, si quieres, la publica con un enlace compartible.

Unos 15 minutos de instalación más lo que tardes en reunir tu material Leer la guía →
Guía paso a paso · Intermedio

Stop AI Slop: repos gratuitos para que tu trabajo con IA no parezca hecho con IA

Una selección de repositorios gratuitos para que las webs, los textos, las presentaciones y los diagramas que haces con Claude no tengan ese acabado genérico tan reconocible. Verás qué resuelve cada uno, cómo se instala en Claude Code y cuál elegir según lo que vayas a producir.

Unos 10 minutos por herramienta Leer la guía →
Guía paso a paso · Principiante

De la idea a la web publicada con The Architect y Claude Web Builder

Combina dos proyectos libres para Claude Code: The Architect, que te entrevista y redacta un plano técnico completo de tu proyecto, y Claude Web Builder, que diseña, construye y publica una landing en Vercel. Pensado para negocios pequeños, profesionales y lanzamientos que quieren una web propia sin empezar desde una plantilla.

Entre 1 y 2 horas para tener la primera versión publicada Leer la guía →

¿Quieres llevar la IA a tu empresa sin pelearte con todo esto?

Diseñamos e implantamos agentes, automatizaciones y asistentes con IA a medida de tu negocio.

Ver nuestros servicios de IA

Cuéntanos tu proyecto. Te respondemos en 48 h.

Auditoría gratuita de IA, campañas, web y SEO, con prioridades y cifras reales de tu negocio.

✓ Sin compromiso ✓ Respuesta en 48 h laborables ✓ Un consultor senior, no un bot
WA WhatsApp