Communitygithub.com

Diseño de Interfaces

Esta habilidad es para diseño de interfaces — paneles de control, paneles de administración, aplicaciones, herramientas y productos interactivos. NO para diseño de marketing (páginas de aterrizaje, sitios de marketing, campañas).

¿Qué es Diseño de Interfaces?

Esta habilidad entrena al agente de IA para diseñar interfaces de producto con oficio y consistencia, evitando resultados genéricos y patrones predeterminados. Se enfoca en paneles de control, aplicaciones SaaS, herramientas, páginas de configuración e interfaces de datos, y está explícitamente diseñada para no usarse en páginas de aterrizaje o sitios de marketing. El proceso central comienza con la intención (quién es el usuario, qué debe lograr, cómo debería sentirse la interfaz) y una exploración profunda del dominio del producto, que incluye nombrar una firma visual única, definir un mundo de colores e identificar los valores predeterminados a evitar. La habilidad es compatible con asistentes de codificación como Claude Code, Cursor y Codex, y se implementa como un conjunto de principios y comprobaciones que el agente debe ejecutar antes de generar cualquier interfaz de usuario. Estos incluyen la prueba de intercambio, la prueba de entrecerrar los ojos, la prueba de firma y la prueba de tokens, que garantizan que cada elección de diseño sea intencional y esté alineada con el contexto del producto.

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

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Diseño de Interfaces?

Construye diseño de interfaces con oficio y consistencia.

Alcance

Úsalo para: Paneles de control, paneles de administración, aplicaciones SaaS, herramientas, páginas de configuración, interfaces de datos.

No para: Páginas de aterrizaje, sitios de marketing, campañas. Redirige eso a /frontend-design.


El Problema

Generarás resultados genéricos. Tu entrenamiento ha visto miles de paneles de control. Los patrones son fuertes.

Puedes seguir todo el proceso a continuación — explorar el dominio, nombrar una firma, declarar tu intención — y aún así producir una plantilla. Colores cálidos sobre estructuras frías. Fuentes amigables sobre diseños genéricos. "Sensación acogedora" que parece cualquier otra aplicación.

Esto sucede porque la intención vive en el texto, pero la generación de código se basa en patrones. La brecha entre ellos es donde ganan los valores predeterminados.

El proceso a continuación ayuda. Pero el proceso solo no garantiza el oficio. Tienes que detectarte a ti mismo.


Dónde se Esconden los Valores Predeterminados

Los valores predeterminados no se anuncian. Se disfrazan de infraestructura — las partes que parecen que solo necesitan funcionar, no ser diseñadas.

La tipografía se siente como un contenedor. Elige algo legible, sigue adelante. Pero la tipografía no está sosteniendo tu diseño — ES tu diseño. El peso de un titular, la personalidad de una etiqueta, la textura de un párrafo. Estos moldean cómo se siente el producto antes de que alguien lea una palabra. Una herramienta de gestión de panadería y un terminal de trading pueden necesitar "un tipo legible y limpio" — pero el tipo que es cálido y artesanal no es el tipo que es frío y preciso. Si estás recurriendo a tu fuente habitual, no estás diseñando.

La navegación se siente como andamios. Construye la barra lateral, añade los enlaces, ve al trabajo real. Pero la navegación no está alrededor de tu producto — ES tu producto. Dónde estás, a dónde puedes ir, qué es más importante. Una página flotando en el espacio es una demostración de componentes, no un software. La navegación enseña a las personas cómo pensar sobre el espacio en el que están.

Los datos se sienten como presentación. Tienes números, muestra números. Pero un número en pantalla no es diseño. La pregunta es: ¿qué significa este número para la persona que lo mira? ¿Qué harán con él? Un anillo de progreso y una etiqueta apilada muestran "3 de 10" — uno cuenta una historia, el otro llena espacio. Si estás recurriendo a número-sobre-etiqueta, no estás diseñando.

Los nombres de tokens se sienten como detalles de implementación. Pero tus variables CSS son decisiones de diseño. --tinta y --pergamino evocan un mundo. --gris-700 y --superficie-2 evocan una plantilla. Alguien que solo lea tus tokens debería poder adivinar qué producto es este.

La trampa es pensar que algunas decisiones son creativas y otras estructurales. No hay decisiones estructurales. Todo es diseño. El momento en que dejas de preguntar "¿por qué esto?" es el momento en que los valores predeterminados toman el control.


Intención Primero

Antes de tocar código, responde estas preguntas. No en tu cabeza — en voz alta, para ti o para el usuario.

¿Quién es este humano? No "usuarios". La persona real. ¿Dónde están cuando abren esto? ¿Qué tienen en mente? ¿Qué hicieron hace 5 minutos, qué harán dentro de 5 minutos? Un profesor a las 7 a. m. con café no es un desarrollador depurando a medianoche ni un fundador entre reuniones con inversores. Su mundo da forma a la interfaz.

¿Qué deben lograr? No "usar el panel de control". El verbo. Calificar estas entregas. Encontrar la implementación rota. Aprobar el pago. La respuesta determina qué lidera, qué sigue, qué se oculta.

¿Cómo debería sentirse esto? Dilo en palabras que signifiquen algo. "Limpio y moderno" no significa nada — cada IA dice eso. ¿Cálido como un cuaderno? ¿Frío como un terminal? ¿Denso como un piso de negociación? ¿Tranquilo como una aplicación de lectura? La respuesta da forma al color, tipo, espaciado, densidad — todo.

Si no puedes responder estas preguntas con especificidad, detente. Pregunta al usuario. No adivines. No recurras a valores predeterminados.

Cada Elección Debe Ser Una Elección

Para cada decisión, debes poder explicar POR QUÉ.

  • ¿Por qué esta disposición y no otra?
  • ¿Por qué esta temperatura de color?
  • ¿Por qué este tipo de letra?
  • ¿Por qué esta escala de espaciado?
  • ¿Por qué esta jerarquía de información?

Si tu respuesta es "es común" o "es limpio" o "funciona" — no has elegido. Has recurrido a un valor predeterminado. Los valores predeterminados son invisibles. Las elecciones invisibles se acumulan en resultados genéricos.

La prueba: Si intercambiaste tus elecciones por las alternativas más comunes y el diseño no se sintió significativamente diferente, nunca tomaste decisiones reales.

La Similitud Es Falla

Si otra IA, dada una indicación similar, produjera sustancialmente el mismo resultado — has fallado.

Esto no se trata de ser diferente por el simple hecho de serlo. Se trata de que la interfaz surja del problema específico, el usuario específico, el contexto específico. Cuando diseñas desde la intención, la similitud se vuelve imposible porque no hay dos intenciones idénticas.

Cuando diseñas desde valores predeterminados, todo se ve igual porque los valores predeterminados son compartidos.

La Intención Debe Ser Sistémica

Decir "cálido" y usar colores fríos no es cumplir. La intención no es una etiqueta — es una restricción que da forma a cada decisión.

Si la intención es cálida: superficies, texto, bordes, acentos, colores semánticos, tipografía — todo cálido. Si la intención es densa: espaciado, tamaño de tipo, arquitectura de información — todo denso. Si la intención es tranquila: movimiento, contraste, saturación de color — todo tranquilo.

Revisa tu resultado contra tu intención declarada. ¿Cada token la refuerza? ¿O declaraste una intención y luego recurriste a valores predeterminados de todos modos?


Exploración del Dominio del Producto

Aquí es donde los valores predeterminados se detectan — o no.

Resultado genérico: Tipo de tarea → Plantilla visual → Tema Resultado elaborado: Tipo de tarea → Dominio del producto → Firma → Estructura + Expresión

La diferencia: tiempo en el mundo del producto antes de cualquier pensamiento visual o estructural.

Resultados Requeridos

No propongas ninguna dirección hasta que produzcas los cuatro:

Dominio: Conceptos, metáforas, vocabulario del mundo de este producto. No características — territorio. Mínimo 5.

Mundo de color: ¿Qué colores existen naturalmente en el dominio de este producto? No "cálido" o "frío" — ve al mundo real. Si este producto fuera un espacio físico, ¿qué verías? ¿Qué colores pertenecen allí que no pertenecen en otro lugar? Enumera 5+.

Firma: Un elemento — visual, estructural o de interacción — que solo podría existir para ESTE producto. Si no puedes nombrar uno, sigue explorando.

Valores predeterminados: 3 opciones obvias para este tipo de interfaz — visuales Y estructurales. No puedes evitar patrones que no has nombrado.

Requisitos de Propuesta

Tu dirección debe referenciar explícitamente:

  • Conceptos de dominio que exploraste
  • Colores de tu exploración del mundo de color
  • Tu elemento de firma
  • Qué reemplaza cada valor predeterminado

La prueba: Lee tu propuesta. Elimina el nombre del producto. ¿Podría alguien identificar para qué es esto? Si no, es genérico. Explora más profundo.


El Mandato

Antes de mostrarle al usuario, mira lo que hiciste.

Pregúntate: "Si ellos dijeran que esto carece de oficio, ¿qué querrían decir?"

Eso que acabas de pensar — arréglalo primero.

Tu primer resultado probablemente es genérico. Eso es normal. El trabajo es detectarlo antes de que el usuario tenga que hacerlo.

Las Comprobaciones

Ejecuta estas contra tu resultado antes de presentar:

  • La prueba de intercambio: Si intercambiaste el tipo de letra por tu habitual, ¿alguien lo notaría? Si intercambiaste la disposición por una plantilla de panel de control estándar, ¿se sentiría diferente? Los lugares donde intercambiar no importaría son los lugares donde recurriste a valores predeterminados.

  • La prueba de entrecerrar los ojos: Entrecierra los ojos. ¿Todavía puedes percibir la jerarquía? ¿Algo está saltando a la vista de manera agresiva? El oficio susurra.

  • La prueba de firma: ¿Puedes señalar cinco elementos específicos donde aparece tu firma? No "la sensación general" — componentes reales. Una firma que no puedes localizar no existe.

  • La prueba de tokens: Lee tus variables CSS en voz alta. ¿Suenan como si pertenecieran al mundo de este producto, o podrían pertenecer a cualquier proyecto?

Si alguna comprobación falla, itera antes de mostrar.


Fundamentos del Oficio

Capas Sutiles

Esta es la columna vertebral del oficio. Independientemente de la dirección, el tipo de producto o el estilo visual — este principio se aplica a todo. Apenas deberías notar el sistema funcionando. Cuando miras el panel de control de Vercel, no piensas "buenos bordes". Simplemente entiendes la estructura. El oficio es invisible — así es como sabes que está funcionando.

Elevación de Superficie

Las superficies se apilan. Un menú desplegable está sobre una tarjeta que está sobre la página. Construye un sistema numerado — base, luego niveles de elevación crecientes. En modo oscuro, mayor elevación = ligeramente más claro. En modo claro, mayor elevación = ligeramente más claro o usa sombra.

Cada salto debe ser solo unos pocos puntos porcentuales de claridad. Apenas puedes ver la diferencia de forma aislada. Pero cuando las superficies se apilan, la jerarquía emerge. Cambios susurrantemente silenciosos que sientes en lugar de ver.

Decisiones clave:

  • Barras laterales: Mismo fondo que el lienzo, no diferente. Colores diferentes fragmentan el espacio visual en "mundo de la barra lateral" y "mundo del contenido". Un borde sutil es suficiente separación.
  • Menús desplegables: Un nivel por encima de su superficie principal. Si ambos comparten el mismo nivel, el menú desplegable se fusiona con la tarjeta y la superposición se pierde.
  • Campos de entrada: Ligeramente más oscuros que su entorno, no más claros. Los campos están "en relieve" — reciben contenido. Un fondo más oscuro señala "escribe aquí" sin bordes pesados.

Bordes

Los bordes deberían desaparecer cuando no los estás buscando, pero ser encontrables cuando necesitas estructura. El rgba de baja opacidad se mezcla con el fondo — define bordes sin exigir atención. Los bordes sólidos en hex se ven agresivos en comparación.

Construye una progresión — no todos los bordes son iguales. Bordes estándar, separación más suave, bordes de énfasis, énfasis máximo para anillos de enfoque. Iguala la intensidad a la importancia del límite.

La prueba de entrecerrar los ojos: Entrecierra los ojos en la interfaz. Todavía deberías percibir jerarquía — qué está sobre qué, dónde se dividen las secciones. Pero nada debería saltar a la vista. Sin líneas ásperas. Sin cambios de color discordantes. Solo estructura silenciosa.

Esto separa las interfaces profesionales de las amateur. Haz esto mal y nada más importa.

Expresión Infinita

Cada patrón tiene infinitas expresiones. Ninguna interfaz debería verse igual.

Una visualización de métrica podría ser un número heroico, estadística en línea, gráfico de chispa, indicador, barra de progreso, delta de comparación, insignia de tendencia, o algo nuevo. Un panel de control podría enfatizar densidad, espacio en blanco, jerarquía o flujo de maneras completamente diferentes. Incluso barra lateral + tarjetas tiene variaciones infinitas en proporción, espaciado y énfasis.

Antes de construir, pregúntate:

  • ¿Qué es lo ÚNICO que los usuarios hacen más aquí?
  • ¿Qué productos resuelven problemas similares brillantemente? Estúdialos.
  • ¿Por qué esta interfaz se sentiría diseñada para su propósito, no basada en plantillas?

NUNCA produzcas resultados idénticos. Mismo ancho de barra lateral, misma cuadrícula de tarjetas, mismas cajas de métricas con icono-izquierda-número-grande-etiqueta-pequeña cada vez — esto señala generado por IA inmediatamente. Es olvidable.

La arquitectura y los componentes deberían surgir de la tarea y los datos, ejecutados de una manera que se sienta fresca. Las tarjetas de Linear no se parecen a las de Notion. Las métricas de Vercel no se parecen a las de Stripe. Mismos conceptos, expresiones infinitas.

El Color Vive en Algún Lugar

Cada producto existe en un mundo. Ese mundo tiene colores.

Antes de buscar una paleta, pasa tiempo en el mundo del producto. ¿Qué verías si caminaras dentro de la versión física de este espacio? ¿Qué materiales? ¿Qué luz? ¿Qué objetos?

Tu paleta debería sentirse como si viniera DE algún lugar — no como si fuera APLICADA A algo.

Más Allá de Cálido y Frío: La temperatura es un eje. ¿Es esto tranquilo o ruidoso? ¿Denso o espacioso? ¿Serio o juguetón? ¿Geométrico u orgánico? Un terminal de trading y una aplicación de meditación son ambos "enfocados" — tipos de enfoque completamente diferentes. Encuentra la cualidad específica, no la etiqueta genérica.

El Color Lleva Significado: El gris construye estructura. El color comunica — estado, acción, énfasis, identidad. El color sin motivación es ruido. Un color de acento, usado con intención, vence a cinco colores usados sin pensamiento.


Antes de Escribir Cada Componente

Cada vez que escribas código de interfaz de usuario — incluso adiciones pequeñas — declara:

Intención: [quién es este humano, qué debe hacer, cómo debería sentirse]
Paleta: [colores de tu exploración — y POR QUÉ encajan en el mundo de este producto]
Profundidad: [bordes / sombras / capas — y POR QUÉ esto encaja con la intención]
Superficies: [tu escala de elevación — y POR QUÉ esta temperatura de color]
Tipografía: [tu tipo de letra — y POR QUÉ encaja con la intención]
Espaciado: [tu unidad base]

Este punto de control es obligatorio. Te obliga a conectar cada elección técnica de vuelta a la intención.

Si no puedes explicar POR QUÉ para cada elección, estás recurriendo a valores predeterminados. Detente y piensa.


Principios de Diseño

Arquitectura de Tokens

Cada color en tu interfaz debería remontarse a un pequeño conjunto de primitivas: primer plano (jerarquía de texto), fondo (elevación de superficie), borde (jerarquía de separación), marca y semántico (destructivo, advertencia, éxito). Sin valores hexadecimales aleatorios — todo se asigna a primitivas.

Jerarquía de Texto

No tengas solo "texto" y "texto gris". Construye cuatro niveles — primario, secundario, terciario, apagado. Cada uno cumple un rol diferente: texto predeterminado, texto de apoyo, metadatos y deshabilitado/marcador de posición. Usa los cuatro de manera consistente. Si solo estás usando dos, tu jerarquía es demasiado plana.

Progresión de Bordes

Los bordes no son binarios. Construye una escala que iguale la intensidad a la importancia — separación estándar, separación más suave, énfasis, énfasis máximo. No todos los límites merecen el mismo peso.

Tokens de Control

Los controles de formulario tienen necesidades específicas. No reutilices tokens de superficie — crea tokens dedicados para fondos de control, bordes de control y estados de enfoque. Esto te permite ajustar elementos interactivos independientemente de las superficies de diseño.

Espaciado

Elige una unidad base y quédate con múltiplos. Construye una escala para diferentes contextos — micro espaciado para espacios entre iconos, espaciado de componentes dentro de botones y tarjetas, espaciado de sección entre grupos, separación mayor entre áreas distintas. Los valores aleatorios indican que no hay sistema.

Relleno

Mantenlo simétrico. Si un lado tiene un valor, los otros deberían coincidir a menos que el contenido requiera naturalmente asimetría.

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

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

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

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