Design Details
El objetivo es una página lo suficientemente buena como para aparecer en una galería de diseño, no una plantilla limpia. Tres cosas lo consiguen juntas:
- Referencias reales. El MCP de Design Details contiene secciones de sitios web reales, de nivel de premio, cada una con una captura de pantalla, hechos medidos y una nota del constructor. Míralas; no las imagines.
- Ambiición con oficio. Toma la idea más audaz que ofrezca una referencia y haz que funcione correctamente: legible, accesible, rápida.
- El diseñador. Ellos establecen la ambición, eligen la dirección y aprueban el resultado. Detente y espera por ellos: después de las direcciones, después de la página, y cada vez que marquen una sección como "básica".
Una página limpia, correcta y olvidable es un fracaso, no un resultado seguro.
Audaz no es grande
El tipo gigante es una forma de ser audaz, y la más usada en exceso. Las páginas que todas terminan con una palabra enorme, unas pocas líneas pequeñas y un botón se parecen, independientemente del negocio. Los tipos de audacia:
- Liderada por tipografía: la escala y la colocación de las palabras son la idea.
- Liderada por imagen: una fotografía o película domina la pantalla; el tipo es modesto y está colocado con cuidado.
- Liderada por producto: el producto real es el héroe, grande y funcionando.
- Liderada por objeto: un objeto o ilustración carga la idea.
- Liderada por estructura: una cuadrícula, lista, secuencia o interacción inusual es la idea.
- Tranquila: tipo pequeño, espacio amplio y un detalle exacto; la contención es el movimiento.
Elige según el briefing y el material, no según lo que se vea más fuerte. El tipo debe ser tan grande como la idea lo requiera, no tan grande como quepa.
Paso 1 — Briefing
Lee primero el proyecto: marca, fuentes, colores, tokens, DESIGN.md, componentes, stack. Conserva lo que exista.
Pregunta una vez, en un mensaje, como máximo cinco preguntas, cada una con una respuesta sugerida para que el diseñador pueda responder "adelante":
- Quién y qué: audiencia, oferta, la única acción que un visitante debe realizar.
- Material: qué es real (fotos, producto, logotipo, copia), qué puede usar sustitutos con licencia gratuita y qué no existe aún.
- Sensación: una o dos palabras con un borde. "Limpio y moderno" no es una sensación.
- Ambiición: seguro (familiar, tranquilo), distintivo (un movimiento memorable por pantalla; el valor por defecto) o extremo (nivel de galería: composiciones que un sitio típico nunca probaría, de cualquier tipo de los anteriores).
- Alcance: qué secciones, y si ver direcciones primero (por defecto: sí).
Si algo se omite, indica la suposición en una línea y continúa. Nunca inventes hechos, números, clientes, testimonios, premios o detalles de contacto.
Paso 2 — Busca las referencias más audaces
Si el MCP no está conectado, dílo, explica cómo añadir https://designdetails.io/api/mcp, y pregunta si continuar sin referencias. Sin él, no afirmes elecciones respaldadas por referencias.
Conectado, sigue la guía del MCP. Busca de dos maneras:
- Por el movimiento. Busca una composición, de cualquier industria. En ambición distintiva y extrema, esta búsqueda es lo primero. Un banco puede tomar prestado de una marca de moda. Escribe tú mismo cada búsqueda, desde este briefing: empieza por lo que solo este negocio tiene (un objeto, un momento, un material, un hábito de sus clientes) y describe un diseño construido alrededor de ello, en las palabras de lo que verías en pantalla. Nunca envíes una frase copiada de este skill o de un proyecto anterior; las mismas palabras devuelven las mismas referencias, y cada página termina pareciéndose.
- Por el trabajo. Usa
create_page_recipecon el briefing yslotspara cubrir secciones que necesitan un ajuste estructural (precios, reservas, equipo).
Lanza la red. Pide 20 resultados por búsqueda (limit: 20) y mira más allá de los tres primeros antes de elegir. Usa cada sitio web como máximo una vez por página. Unos pocos héroes ruidosos coinciden con muchas búsquedas; usa uno solo si encaja mejor con este briefing que todo lo demás que viste, y di qué más consideraste.
Mira las imágenes reales. El texto, los enlaces y las puntuaciones no son mirar. Para cada candidato fuerte, nombra su movimiento más audaz en una línea: lo que un sitio típico no haría. Obtén get_section_build_blueprint para las referencias desde las que realmente construirás; sus tamaños de tipo medidos, espaciado y colocación son lo que hace que un movimiento funcione.
Para cada referencia desde la que construirás, escribe un estudio de composición a partir de la imagen y el plano (diseño, estructura, medidas, posiciones de los medios), porque las notas del constructor describen ingredientes más que colocación:
- dónde está el titular (arriba, medio o abajo; izquierda, centro o derecha), cuántas líneas y qué ancho;
- dónde están la descripción y el botón, y qué cortos son;
- cuánto de la pantalla ocupa la imagen y dónde tiene espacio para crecer;
- qué se deja vacío.
Busca de nuevo solo para llenar un vacío nombrado. Usa al menos un puñado de búsquedas para el movimiento antes de decidir.
Paso 3 — Dos direcciones, luego detente
Haz dos direcciones que difieran en tipo: dos tipos diferentes de audacia de la lista anterior, con aspectos diferentes. Como máximo una puede ser liderada por tipografía. En ambición distintiva o extrema, cada dirección se construye alrededor del movimiento más audaz de una referencia, mantenido intacto. Nombra ese movimiento en una línea.
Cada dirección tiene un aspecto y un diseño, elegidos por separado:
- Aspecto: el sistema de superficie (combinación de tipos, paleta, papel o fondo, cómo se tratan las fotos, esquinas y reglas), tomado del diseño completo de un sitio web de referencia con
get_website_design. - Diseño: la composición, tomada de la sección de referencia cuyo movimiento conserva. Los dos pueden venir de sitios web diferentes.
Para cada dirección, escribe primero un plan breve: las referencias (IDs y enlaces), su tipo de audacia, la idea en una oración, el movimiento que conserva, el aspecto y de dónde viene, qué cambia para este negocio, el tipo y la paleta (de cuatro a seis colores), el uso de la imagen héroe, y qué lee el visitante primero, segundo y tercero.
Luego dos comprobaciones:
- La comprobación de plantilla: ¿Un sitio típico en esta categoría se vería así? Si es así, empuja la parte específica más allá.
- La comprobación de galería: ¿Design Details pondría esta pantalla de apertura en su propia biblioteca? Si no, no está listo para mostrar.
- La comprobación de igualdad: pon los dos estudios uno al lado del otro, y al lado de la última página hecha con este skill si tienes una. Si dos de ellas comparten una forma (una palabra gigante, unas pocas líneas pequeñas, un botón), cambia una.
Haz un estudio visual rápido de la pantalla de apertura de cada dirección y muéstralo junto a sus imágenes de referencia, con el movimiento nombrado. Ofrece: A, B o ninguno.
Detente y espera al diseñador. No construyas la página completa antes de que elijan.
Paso 4 — Planifica cada sección
Una página es buena cuando cada sección está diseñada, no solo el héroe. Antes de construir, escribe un plan de secciones. Para cada sección:
- Trabajo: la única cosa que debe transmitir.
- Idea de diseño: una idea propia, tomada de una referencia del MCP inspeccionada (busca el movimiento, escrito desde el contenido de esta sección, como en el paso 2), con su estudio de composición. El tipo de idea que se quiere: una oración sola con sus palabras clave iluminándose, o una imagen partida por una línea con la afirmación sobre ella. Estos muestran el tipo; no los busques tal como están escritos.
- Peso: tranquila o rica.
- Desplazamiento: mantiene el desplazamiento (fijado, avanza por pasos) o no.
Luego verifica el plan:
- Sin secciones predeterminadas. Un encabezado sobre tarjetas iguales, una foto junto a un texto, un encabezado con un botón, una fila de números, una tira de logotipos: cada una es la versión "básica". Reemplázala con una idea de diseño.
- Ritmo. No dos vecinos comparten una forma. Una sección tranquila sigue a una rica.
- Superficie tranquila. Una familia de fondos, un acento, dos tipografías, el mismo espacio entre secciones. La estructura es audaz; la superficie no.
- Límite de movimiento. Como máximo tres secciones mantienen el desplazamiento.
- Producto real primero. Donde el negocio tiene un producto, sus pantallas reales y datos reales son las imágenes más fuertes; las fotos son secundarias. Si hay una aplicación en funcionamiento (una URL o una carpeta), ejecútala y captura las pantallas reales. Dibuja la interfaz solo cuando no exista nada, y etiquétala como muestra.
Si el diseñador marca una sección como "básica", rediseña solo esa sección: ofrece tres opciones, ninguna segura, y mantén el resto de la página.
Paso 5 — Construye
Construye la dirección elegida en el stack del proyecto. Lee oficio y señas de IA antes de construir, movimiento cuando la página se mueva.
- Construye primero el héroe, renderízalo, y ponlo junto a su referencia. Verifica el estudio de composición punto por punto: posición del titular, número de líneas, proporción de imagen, espacio vacío. El movimiento más audaz debe sobrevivir. Si se ha suavizado en un diseño familiar, reconstrúyelo. Si la copia es demasiado larga para la colocación, acorta la copia, no la colocación.
- La ambición sobrevive a la accesibilidad. Cuando un movimiento audaz crea un problema (texto sobre una foto ocupada, tipo muy grande, recorte ajustado), resuélvelo con técnica: una capa semitransparente, un recorte más tranquilo, tipo más grande o más pesado, una banda sólida detrás del texto. No retrocedas al diseño estándar.
- Un lenguaje de diseño en toda la página: las mismas fuentes, tamaños, espaciado, superficies. Cada sección toma prestado su diseño de su referencia, no su aspecto.
- Presupuesto de texto (estricto), establecido por el tipo de dirección:
- Liderada por tipo u objeto: un titular de como máximo seis palabras, una línea de como máximo doce palabras, un botón.
- Liderada por imagen, producto, estructura o tranquila: un titular de como máximo diez palabras, como máximo dos oraciones cortas (unas treinta palabras), un botón relleno y como máximo un enlace de texto.
- Siempre: sin eslogan o etiqueta sobre el titular, sin segunda declaración. Encabezados de sección de como máximo seis palabras; los elementos son nombres, con como máximo una línea corta donde sea esencial. En caso de duda, recorta.
- Presupuesto de tipo (estricto): una familia para casi todo; una segunda solo para un rol claro; nunca más de dos. Como máximo tres tamaños por pantalla. El tamaño más grande lo establece la idea: una página tranquila o liderada por imagen no necesita un titular de póster.
- Copia real y específica: corta y segura. Material sustituto real o acreditado; marcadores de posición honestos solo donde no exista nada.
- El briefing gana sobre la referencia; la referencia gana sobre el hábito.
Paso 6 — Verifica, luego muestra
- Renderiza a 1440 y 390 de ancho. Mira las capturas de pantalla.
- Ejecuta el verificador de página desde la carpeta de este skill:
node scripts/check-page.mjs <archivo o URL de página>. Arregla cada fallo; arregla o explica cada advertencia. Verifica lo que un script puede ver (etiquetas sobre encabezados, palabras de acento, los presupuestos de tipo y texto, contraste, desbordamiento, botones rellenos lado a lado); no juzga el diseño. - Revisa la revisión: el movimiento más audaz, la comprobación de galería, oficio y señas.
- Rondas del diseñador. Ejecuta la revisión del diseñador, idealmente con un ayudante nuevo sin memoria de la compilación: un veredicto para cada sección (aprobada, medio hecha, débil, básica), un problema y un movimiento para cada sección que no esté aprobada, luego la página completa (vecinos, ritmo, señas, texto pequeño, superposiciones). Arregla, vuelve a renderizar, revisa de nuevo. Protege las secciones aprobadas. Como máximo tres rondas.
- Termina con un veredicto: enviar, arreglar o reconstruir.
Muestra al diseñador las capturas de pantalla junto a las referencias, y los registros de las rondas con fotogramas de antes y después: el movimiento que cada sección conservó y de dónde, qué se verificó y qué no, y los marcadores de posición. Detente y espera su aprobación. Su "no" es una respuesta real.
Honestidad
- Di qué elecciones vinieron de referencias y cuáles son tuyas.
- Las notas del constructor son lecturas editoriales, a menudo escritas por IA. Confía en la imagen sobre la nota.
- Una imagen fija no muestra movimiento ni comportamiento móvil. No afirmes que lo hace.
- Nunca informes algo como verificado que no hayas visto renderizado.
- No afirmes que la página convertirá mejor o que supera otro flujo de trabajo.
Este skill toma prestadas ideas de varios skills de diseño de código abierto; consulta créditos.