Communitygithub.com

Design Lab Skill

Realiza entrevistas de diseño, genera cinco variaciones de UI distintas en un laboratorio de diseño temporal, recopila comentarios y produce planes de implementación. Úsalo cuando quieras explorar opciones de diseño de UI, rediseñar componentes existentes o crear nueva UI con múltiples enfoques para comparar.

¿Qué es Design Lab Skill?

Esta habilidad implementa un flujo de trabajo completo de exploración de diseño: entrevista, generación de variaciones, recopilación de comentarios, refinamiento, vista previa y finalización. Es útil para desarrolladores y diseñadores que desean explorar múltiples direcciones de diseño para un componente o página, recopilar comentarios estructurados y generar un plan de implementación claro. La habilidad es compatible con plataformas como Claude Code y Cursor, y se integra con frameworks modernos como Next.js, Vite, Remix, Nuxt y Astro, así como con sistemas de estilos como Tailwind CSS, Material UI, Chakra UI y otros. Funciona detectando automáticamente el proyecto (gestor de paquetes, framework, sistema de estilos y memoria de diseño existente), realizando una entrevista estructurada al usuario para comprender el alcance, los puntos débiles, la inspiración y las restricciones, y luego generando cinco variaciones de UI distintas en un laboratorio de diseño temporal bajo `.claude-design/`. Cada variación explora un eje de diseño diferente (jerarquía de información, modelo de diseño, densidad, modelo de interacción y dirección expresiva), utilizando el lenguaje visual existente del proyecto. Un sistema de superposición de comentarios permite a los usuarios proporcionar retroalimentación interactiva sobre cada variante. El flujo concluye con la recopilación de comentarios, el refinamiento de la variante seleccionada y la generación de un plan de implementación paso a paso. Después de la finalización o cancelación, todos los archivos temporales se eliminan automáticamente.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/design-lab

Preguntar en tu IA favorita

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

Documentación

Habilidad de Laboratorio de Diseño

Esta habilidad implementa un flujo de trabajo completo de exploración de diseño: entrevista, generar variaciones, recopilar comentarios, refinar, previsualizar y finalizar.

CRÍTICO: Comportamiento de Limpieza

Todos los archivos temporales DEBEN eliminarse cuando el proceso termine, ya sea por:

  • El usuario confirma el diseño final → limpiar, luego generar plan
  • El usuario aborta/cancela → limpiar inmediatamente, no generar plan

Nunca dejes atrás .claude-design/ o rutas __design_lab. Si el usuario dice "cancelar", "abortar", "detener" o "olvídalo" en cualquier momento, confirma y luego elimina todos los artefactos temporales.


Fase 0: Detección Previa

Antes de comenzar la entrevista, detecta automáticamente:

Gestor de Paquetes

Busca archivos de bloqueo en la raíz del proyecto:

  • pnpm-lock.yaml → usa pnpm
  • yarn.lock → usa yarn
  • package-lock.json → usa npm
  • bun.lockb → usa bun

Detección de Framework

Busca archivos de configuración:

  • next.config.js o next.config.mjs o next.config.ts → Next.js
    • Busca el directorio app/ → App Router
    • Busca el directorio pages/ → Pages Router
  • vite.config.js o vite.config.ts → Vite
  • remix.config.js → Remix
  • nuxt.config.js o nuxt.config.ts → Nuxt
  • astro.config.mjs → Astro

Detección de Sistema de Estilos

Busca dependencias en package.json y archivos de configuración:

  • tailwind.config.js o tailwind.config.ts → Tailwind CSS
  • @mui/material en dependencias → Material UI
  • @chakra-ui/react en dependencias → Chakra UI
  • antd en dependencias → Ant Design
  • styled-components en dependencias → styled-components
  • @emotion/react en dependencias → Emotion
  • Archivos .css o .module.css → CSS Modules

Verificación de Memoria de Diseño

Busca el archivo existente de Memoria de Diseño:

  • docs/design-memory.md
  • DESIGN_MEMORY.md
  • .claude-design/design-memory.md

Si se encuentra, léelo y úsalo para rellenar valores predeterminados y omitir preguntas redundantes.

Inferencia de Estilo Visual (CRÍTICO)

NO uses estilos predefinidos/genéricos. Extrae el lenguaje visual del proyecto:

Si se detecta Tailwind, lee tailwind.config.js o tailwind.config.ts:

// Extrae y usa:
theme.colors      // Paleta de colores
theme.spacing     // Escala de espaciado
theme.borderRadius // Valores de radio
theme.fontFamily  // Tipografía
theme.boxShadow   // Sistema de elevación

Si existen Variables CSS, lee globals.css, variables.css o definiciones :root:

:root {
  --color-*     /* Tokens de color */
  --spacing-*   /* Tokens de espaciado */
  --font-*      /* Tokens de tipografía */
  --radius-*    /* Tokens de radio de borde */
}

Si se detecta una librería de UI (MUI, Chakra, Ant), lee la configuración del tema:

  • MUI: theme.ts o llamada createTheme()
  • Chakra: theme/index.ts o llamada extendTheme()
  • Ant: prop theme de ConfigProvider

Siempre escanea componentes existentes para entender los patrones:

  • Encuentra 2-3 botones existentes → anota sus patrones de estilo
  • Encuentra 2-3 tarjetas existentes → anota padding, bordes, sombras
  • Encuentra formularios existentes → anota estilos de entrada, ubicación de etiquetas
  • Encuentra tipografía existente → anota tamaños de encabezados, texto del cuerpo

Almacena los estilos inferidos en el Brief de Diseño para un uso consistente en todas las variantes.


Fase 1: Entrevista

Usa la herramienta AskUserQuestion para todos los pasos de la entrevista. Adapta las preguntas según la Memoria de Diseño si existe.

Paso 1.1: Alcance y Objetivo

Haz estas preguntas (pueden combinarse en una sola AskUserQuestion con múltiples preguntas):

Pregunta 1: Alcance

  • Encabezado: "Alcance"
  • Pregunta: "¿Estamos diseñando un solo componente o una página completa?"
  • Opciones:
    • "Componente" - Un elemento de UI reutilizable (botón, tarjeta, formulario, modal, etc.)
    • "Página" - Un layout de página o pantalla completo

Pregunta 2: Nuevo o Rediseño

  • Encabezado: "Tipo"
  • Pregunta: "¿Es un diseño nuevo o un rediseño de algo existente?"
  • Opciones:
    • "Nuevo" - Crear algo desde cero
    • "Rediseño" - Mejorar un componente/página existente

Si se selecciona "Rediseño", pregunta: Pregunta 3: Ruta Existente

  • Encabezado: "Ubicación"
  • Pregunta: "¿Cuál es la ruta de archivo o la ruta de la UI existente?"
  • Opciones: (deja que el usuario proporcione mediante "Otro")

Si el objetivo no está claro, propón un nombre basado en los patrones del repositorio y confírmalo.

Paso 1.2: Puntos Débiles e Inspiración

Pregunta 1: Puntos Débiles

  • Encabezado: "Problemas"
  • Pregunta: "¿Cuáles son los principales puntos débiles con el diseño actual (o qué debería evitar este nuevo diseño)?"
  • Opciones:
    • "Demasiado recargado/denso" - Sobrecarga de información, difícil de escanear
    • "Jerarquía poco clara" - Las acciones principales no son obvias
    • "Mala experiencia móvil" - No funciona bien en pantallas pequeñas
    • "Aspecto desactualizado" - Se siente antiguo o inconsistente con la marca
  • multiSelect: true

Pregunta 2: Inspiración Visual

  • Encabezado: "Estilo visual"
  • Pregunta: "¿Qué productos o marcas debo referenciar para inspiración visual?"
  • Opciones:
    • "Stripe" - Limpio, minimalista, confiable
    • "Linear" - Denso, primero el teclado, enfocado en desarrolladores
    • "Notion" - Flexible, centrado en contenido, divertido
    • "Apple" - Premium, espacioso, refinado
  • multiSelect: true

Pregunta 3: Inspiración Funcional

  • Encabezado: "Interacciones"
  • Pregunta: "¿Qué patrones de interacción debo emular?"
  • Opciones:
    • "Edición en línea" - Editar en el lugar sin modales
    • "Divulgación progresiva" - Mostrar más según sea necesario
    • "Actualizaciones optimistas" - Retroalimentación instantánea, sincronización en segundo plano
    • "Atajos de teclado" - Eficiencia para usuarios avanzados

Paso 1.3: Dirección de Marca y Estilo

Pregunta 1: Adjetivos de Marca

  • Encabezado: "Tono de marca"
  • Pregunta: "¿Qué 3-5 adjetivos describen la sensación de marca deseada?"
  • Opciones:
    • "Minimalista" - Limpio, simple, sin desorden
    • "Premium" - De alta gama, pulido, refinado
    • "Divertido" - Alegre, amigable, accesible
    • "Utilitario" - Funcional, eficiente, directo
  • multiSelect: true

Pregunta 2: Densidad

  • Encabezado: "Densidad"
  • Pregunta: "¿Qué densidad de información prefieres?"
  • Opciones:
    • "Compacto" - Más información visible, espaciado más ajustado
    • "Cómodo" - Espaciado equilibrado, escaneo fácil
    • "Espacioso" - Espacio en blanco generoso, atención enfocada

Pregunta 3: Modo Oscuro

  • Encabezado: "Modo oscuro"
  • Pregunta: "¿Se requiere modo oscuro?"
  • Opciones:
    • "Sí" - Debe soportar modo oscuro
    • "No" - Solo modo claro
    • "Agradable tenerlo" - Soporte si es fácil, no requerido

Paso 1.4: Persona y Trabajos por Hacer

Pregunta 1: Usuario Principal

  • Encabezado: "Usuario"
  • Pregunta: "¿Quién es el usuario final principal?"
  • Opciones:
    • "Desarrollador" - Técnico, orientado al teclado
    • "Diseñador" - Visual, orientado a los detalles
    • "Usuario de negocio" - Centrado en la eficiencia, menos técnico
    • "Consumidor final" - Público general, habilidad técnica variada

Pregunta 2: Contexto

  • Encabezado: "Contexto"
  • Pregunta: "¿Cuál es el contexto de uso principal?"
  • Opciones:
    • "Primero escritorio" - Usado principalmente en pantallas grandes
    • "Primero móvil" - Usado principalmente en teléfonos
    • "Ambos por igual" - Debe funcionar bien en todos los dispositivos

Pregunta 3: Tareas Clave

  • Encabezado: "Tareas clave"
  • Pregunta: "¿Cuáles son las 3 tareas principales que los usuarios deben completar?"
  • (Deja que el usuario proporcione mediante "Otro" - esto es abierto)

Paso 1.5: Restricciones

Pregunta 1: Elementos que Deben Mantenerse

  • Encabezado: "Mantener"
  • Pregunta: "¿Hay elementos que deben conservarse?"
  • Opciones:
    • "Copias/etiquetas existentes" - Mantener el texto actual
    • "Campos/entradas actuales" - Mantener la estructura del formulario
    • "Estructura de navegación" - Mantener la navegación actual
    • "Ninguno" - Libre de cambiar todo

Pregunta 2: Restricciones Técnicas

  • Encabezado: "Restricciones"
  • Pregunta: "¿Hay restricciones técnicas?"
  • Opciones:
    • "Sin nuevas dependencias" - Usar solo librerías existentes
    • "Usar componentes existentes" - Construir sobre el sistema de diseño actual
    • "Debe ser accesible (WCAG)" - Requisitos estrictos de accesibilidad
    • "Ninguna" - Sin restricciones especiales
  • multiSelect: true

Fase 2: Generar Brief de Diseño

Después de la entrevista, crea un Brief de Diseño estructurado como JSON y guárdalo en .claude-design/design-brief.json:

{
  "scope": "component|page",
  "isRedesign": true|false,
  "targetPath": "src/components/Example.tsx",
  "targetName": "Example",
  "painPoints": ["Demasiado denso", "Acción principal poco clara"],
  "inspiration": {
    "visual": ["Stripe", "Linear"],
    "functional": ["Validación en línea"]
  },
  "brand": {
    "adjectives": ["minimalista", "confiable"],
    "density": "cómodo",
    "darkMode": true
  },
  "persona": {
    "primary": "Desarrollador",
    "context": "primero-escritorio",
    "keyTasks": ["Completar compra", "Revisar pedido", "Aplicar descuento"]
  },
  "constraints": {
    "mustKeep": ["campos existentes"],
    "technical": ["sin nuevas dependencias", "accesible WCAG"]
  },
  "framework": "nextjs-app",
  "packageManager": "pnpm",
  "stylingSystem": "tailwind"
}

Muestra un resumen al usuario antes de continuar.


Fase 3: Generar Laboratorio de Diseño

Estructura de Directorios

Crea todos los archivos bajo .claude-design/:

.claude-design/
├── lab/
│   ├── page.tsx                 # Página principal del laboratorio (específica del framework)
│   ├── variants/
│   │   ├── VariantA.tsx
│   │   ├── VariantB.tsx
│   │   ├── VariantC.tsx
│   │   ├── VariantD.tsx
│   │   └── VariantE.tsx
│   ├── components/
│   │   └── LabShell.tsx         # Envoltorio de layout del laboratorio
│   ├── feedback/                # Sistema de comentarios interactivo
│   │   ├── types.ts             # Interfaces de TypeScript
│   │   ├── selector-utils.ts    # Identificación de elementos
│   │   ├── format-utils.ts      # Formateo de comentarios
│   │   ├── FeedbackOverlay.tsx  # Componente principal de superposición
│   │   └── index.ts             # Exportaciones del módulo
│   └── data/
│       └── fixtures.ts          # Datos simulados compartidos
├── design-brief.json
└── run-log.md

Configuración del Sistema de Comentarios (CRÍTICO - NUNCA SALTAR)

El FeedbackOverlay es la característica PRINCIPAL del Laboratorio de Diseño. Sin él, los usuarios no pueden proporcionar comentarios interactivos. NUNCA generes un Laboratorio de Diseño sin el FeedbackOverlay.

Estrategia de Fiabilidad: Para evitar problemas con rutas de importación en diferentes configuraciones de proyecto, crea el FeedbackOverlay directamente en el directorio de la ruta (ej., app/design-lab/FeedbackOverlay.tsx), NO en .claude-design/. Esto asegura que una importación relativa simple (./FeedbackOverlay) siempre funcione.

Archivos Requeridos en el Directorio de Ruta:

app/design-lab/           # o app/__design_lab/ si los guiones bajos funcionan
├── page.tsx              # Página principal del laboratorio con variantes
└── FeedbackOverlay.tsx   # Componente de superposición autocontenido (copia de plantillas)

Fuente de la Plantilla: design-and-refine/templates/feedback/FeedbackOverlay.tsx

Por qué este enfoque:

  • Las rutas de .claude-design/ pueden fallar debido a configuraciones del empaquetador
  • Las importaciones relativas desde el mismo directorio siempre funcionan
  • El directorio de la ruta se elimina durante la limpieza de todos modos

Integración de Ruta

Next.js App Router: Crear app/__design_lab/page.tsx que importe desde .claude-design/lab/

Next.js Pages Router: Crear pages/__design_lab.tsx que importe desde .claude-design/lab/

Vite React:

  • Si React Router existe: agregar ruta a /__design_lab
  • Si no hay router: crear un renderizado condicional en App.tsx basado en el parámetro de consulta ?design_lab=true

Otros frameworks: Crear la ruta temporal más apropiada para el framework detectado.

Directrices de Generación de Variantes

IMPORTANTE: Lee DESIGN_PRINCIPLES.md para mejores prácticas de UX, interacción y movimiento. Pero NO uses estilos visuales predefinidos—infiérelos del proyecto.

Aplica principios universales (de DESIGN_PRINCIPLES.md):

  • UX: Heurísticas de Nielsen, reducción de carga cognitiva, divulgación progresiva
  • Comportamiento del componente: Estados de botón, anatomía de formulario, estructura de tarjeta
  • Interacción: Patrones de retroalimentación, manejo de estados, actualizaciones optimistas
  • Movimiento: Tiempo (150-300ms), aceleración (entradas con ease-out, salidas con ease-in)
  • Accesibilidad: Estados de enfoque, patrones ARIA, objetivos táctiles (mínimo 44px)

Infiera los estilos visuales del proyecto:

  • Colores → de la configuración de Tailwind, variables CSS o componentes existentes
  • Tipografía → de encabezados existentes, texto del cuerpo en el código base
  • Espaciado → de la escala de espaciado del proyecto o patrones existentes
  • Radio de borde → de tarjetas, botones, entradas existentes
  • Sombras → de componentes elevados existentes

Cada variante DEBE explorar un eje de diseño diferente. No crees variaciones menores—hazlas significativamente distintas. Usa el lenguaje visual existente del proyecto para todas las variantes.

Variante A: Enfoque en Jerarquía de Información

  • Reestructurar la jerarquía de contenido (¿qué es más importante?)
  • Aplicar proximidad de Gestalt—agrupar elementos relacionados más juntos
  • Una acción principal por vista
  • Usar la escala tipográfica existente para crear niveles claros

Variante B: Exploración de Modelo de Layout

  • Probar un enfoque de layout diferente (tarjeta vs lista vs tabla vs panel dividido)
  • Aplicar anatomía de tarjeta o patrones de comportamiento de tabla de DESIGN_PRINCIPLES
  • Considerar el comportamiento responsivo en cada punto de quiebre
  • Usar el sistema de cuadrícula/layout existente del proyecto

Variante C: Variación de Densidad

  • Si el brief dice "cómodo", probar una versión más compacta
  • Si el brief dice "compacto", probar una versión más espaciosa
  • Usar los tokens de espaciado existentes del proyecto—solo aplicarlos de manera diferente
  • Mostrar las compensaciones: más datos visibles vs escaneo más fácil

Variante D: Modelo de Interacción

  • Patrón de interacción diferente (modal vs en línea vs panel vs cajón)
  • Aplicar patrones de retroalimentación: inmediato → progreso → finalización
  • Implementar todos los estados requeridos (carga, error, vacío, deshabilitado)
  • Considerar actualizaciones optimistas para acciones no destructivas

Variante E: Dirección Expresiva

  • Empujar la dirección de marca que el usuario describió en la entrevista
  • Explorar diferentes usos de los tokens de diseño existentes del proyecto
  • Más o menos uso de sombras, bordes, colores de fondo
  • Aplicar movimiento donde añada significado (hover, focus, transiciones)

Requisitos de la Página de Laboratorio

La página del Laboratorio de Diseño debe incluir:

  1. Encabezado con:

    • Resumen del Brief de Diseño (objetivo, alcance, requisitos clave)
    • Instrucciones para revisar
  2. Cuadrícula de Variantes con:

    • Etiquetas claras (A, B, C, D, E)
    • Justificación breve para cada variante ("Por qué existe esto")
    • La variante renderizada real

...

[truncado para traducción]

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

Skills relacionados