Communitygithub.com

ulasalyesil/personal-website-v2

Orientación del framework Capas de Diseño de Producto: cárguelo primero; proporciona el contexto del que dependen todas las demás habilidades.

¿Qué es personal-website-v2?

Esta habilidad establece el marco conceptual de 'Capas de Diseño de Producto', un enfoque estructurado para el diseño de interfaces y experiencias de usuario. Organiza el trabajo de diseño en siete capas que abarcan tres zonas (realidad, espacio del problema y espacio de la solución), donde las capas inferiores son fundamentos para las superiores y las debilidades en las bases generan deuda de UX. El marco orienta al diseñador a tomar decisiones informadas, descubrir decisiones no tomadas y evaluar la coherencia de las ya existentes, aplicando principios como trabajar una capa a la vez y verificar los cimientos antes de construir hacia arriba. Incluye además indicaciones sobre la dimensión temporal (estados intermedios, actualizaciones optimistas, estados vacío/carga/error) y señales de modos de fallo típicos, como los 'objetos camaleón' o 'enmascarados' de OOUX. Está diseñado para integrarse en sesiones de diseño con asistentes de IA como Claude Code, Cursor o Codex, y sugiere guardar el trabajo en archivos Markdown con diagramas Mermaid, Notion o simplemente en la conversación.

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

Preguntar en tu IA favorita

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

Documentación

/layers-intro

Cargue esta habilidad al inicio de cualquier sesión de diseño. Proporciona el contexto del framework del que dependen todas las demás habilidades /layers-*.


El framework

Capas de Diseño de Producto organiza el trabajo de diseño en siete capas distribuidas en tres zonas. Las capas tienen dependencia lógica: las capas inferiores son fundamentos para las superiores. Las capas inferiores débiles generan deuda de UX que se propaga hacia arriba.

Realidad — compleja, contradictoria, en evolución. Fuente de todo aprendizaje.

Espacio del problema — conocimiento recopilado de la realidad:

  1. Comportamiento observado — lo que los usuarios realmente hacen
  2. El dominio — conceptos, terminología y modelos mentales que existen independientemente de cualquier producto
  3. Necesidades del usuario — lo que creemos que los usuarios intentan lograr y por qué

Espacio de la solución — decisiones deliberadas sobre qué construir: 4. Estrategia de producto y servicio — qué necesidades atender y qué resultados de negocio perseguir 5. Modelo conceptual — objetos, relaciones, estados, vocabulario — independiente de cualquier interfaz 6. Estructura y flujo de interacción — lugares, affordances, conexiones y lógica de flujo 7. Superficie — palabras, imágenes, retroalimentación, jerarquía — lo que los usuarios realmente encuentran

Las capas no son un proceso lineal. Ingrese en cualquier punto, pero siempre verifique que los cimientos inferiores sean sólidos.

Inspirado en The Elements of User Experience de Jesse James Garrett (2000).


Diseñar es tomar decisiones

Diseñar = tomar decisiones sobre la forma de una solución (Christopher Alexander). La forma es la solución; el contexto son los requisitos, restricciones y entorno que debe encajar. Un buen diseño es un buen ajuste.

Cuatro tipos de progreso:

  1. Tomar decisiones — resolver algo no decidido
  2. Descubrir decisiones no tomadas — detectar qué aún no se ha decidido (a menudo más valioso que 1)
  3. Evaluar decisiones — identificar decisiones ya tomadas que son riesgosas, inconsistentes o incorrectas
  4. Priorizar decisiones — las capas inferiores son más fundamentales y conllevan más riesgo si están mal

El trabajo de cada habilidad es ayudar al diseñador a tomar mejores decisiones — no tomar decisiones por él.


Principios — aplican en todas las sesiones

  1. Decisiones, no resultados. Los artefactos solo son útiles en la medida en que representan decisiones tomadas o descubiertas. Nombre la decisión, no solo el diagrama.
  2. Descubra antes de resolver. Descubrir decisiones que el diseñador no sabía que debía tomar suele ser más valioso que responder las que ya conocía.
  3. Trabaje una capa a la vez. Mezclar el espacio del problema y el espacio de la solución, o la superficie y el modelo conceptual, produce resultados confusos.
  4. Verifique los cimientos antes de construir hacia arriba. Antes de trabajar en una capa superior, audite la capa inferior. Señale la inestabilidad.
  5. El modelo conceptual es la capa portante más descuidada. Préstele más atención de lo que parezca cómodo.
  6. Señale las malas decisiones, no solo las que faltan. Una decisión ya tomada que sea arriesgada o inconsistente debe ser nombrada, no sorteada.
  7. Dirija, no se deje dirigir. No salte a un resultado de superficie antes de que se tomen las decisiones fundamentales.
  8. Principios de diseño vs. decisiones de implementación. Algunas decisiones pueden enunciarse sin conocer las restricciones del sistema — qué debería suceder desde la perspectiva del usuario. Otras están enredadas con la implementación: articule el requisito de experiencia de usuario, formule una pregunta bien definida y llévela a una conversación de diseño e ingeniería. No fuerce una respuesta prematura.

La dimensión temporal — sondee de forma proactiva

Las decisiones temporales a menudo se pasan por alto. Se agrupan en dos capas:

Capa del modelo conceptual:

  • Estados de acción intermedios — ¿un objeto pasa por estados transitorios (guardando, procesando, pendiente de aprobación) antes de resolverse? Esos son estados del modelo.
  • Retraso del modelo de lectura — ¿brecha entre cuándo se escriben los datos y cuándo son visibles? Articule la necesidad del usuario; márquela como una pregunta abierta para ingeniería.
  • Temporalidad de las relaciones — "todos los productos en Europa" ¿se refiere al grupo ahora o a la membresía a medida que cambia? Esta es una decisión de diseño.
  • Semántica de eliminación — ¿archivar, papelera, eliminación física o eliminación reglamentaria? Indique cuál y por qué. La implementación sigue.
  • Historial — ¿importa qué era un objeto en el pasado? Afirmar que importa es una decisión de diseño.

Capa de estructura de interacción:

  • Estado posterior a la acción — después de enviar, ¿qué ve el usuario? ¿Una lista redirigida refleja inmediatamente el cambio?
  • Actualizaciones optimistas vs. pesimistas — ¿mostrar el resultado supuesto antes de que el servidor confirme, o esperar? Indique la preferencia; márquela como pregunta abierta si la implementación es incierta.
  • Estados vacío, carga y parcial — cada lugar tiene un ciclo de vida temporal. Diseñe todos ellos.
  • Caminos de error y fallo — fallo de validación, error de servidor, desconexión de red, edición concurrente. Pasos de diseño obligatorios, no ocurrencias tardías.

Señales de modos de fallo

Modos de fallo de objetos OOUX (Sophia Prater):

  • Camaleón — el mismo objeto en formas significativamente diferentes según el contexto. Solución de superficie: tratamiento consistente del objeto. Solución más profunda si el modelo no define el objeto claramente.
  • Enmascarado — distintos tipos de objetos se ven idénticos. Solución de superficie: tratamientos visuales distintivos. Solución más profunda si el modelo no los diferencia.
  • Roto — los datos y acciones del objeto están dispersos por las pantallas sin vínculos cruzados. Problema de estructura de interacción → /layers-interaction-flow.
  • Aislado — los objetos existen sin relaciones visibles con otros objetos. Problema de modelo conceptual → /layers-conceptual-model.

Heurísticas de Nielsen — un mapeo de capa raíz: Las violaciones de "Correspondencia entre el sistema y el mundo real" casi siempre se originan en el modelo conceptual, no en la superficie. "Control y libertad del usuario" es una decisión de estructura de interacción. Parchear estos en la superficie trata los síntomas, no las causas.


Captura del trabajo

Al inicio de cualquier sesión de diseño, pregunte dónde guardar los resultados:

"¿Dónde debo capturar el trabajo de esta sesión? La configuración recomendada es un archivo Markdown en su proyecto: los diagramas se escriben como Mermaid incrustado y se renderizan de forma nativa en VSCode con la extensión Markdown Preview Mermaid Support. Alternativas:

  • Notion — si tiene el MCP de Notion conectado
  • Solo en la conversación — no se necesita archivo"

Guarde el resumen de la sesión en el destino elegido al final.

Al escribir diagramas Mermaid, use <br/> para los saltos de línea dentro de las etiquetas de nodo — no \n, que se renderiza como texto literal.


Por dónde empezar

  • ¿No sabe en qué enfocarse? → /layers-orient — diagnóstico rápido en las siete capas
  • ¿Sabe en qué capa está? → salte directamente a esa habilidad

Habilidades: /layers-observed-behaviour · /layers-domain · /layers-user-needs · /layers-product-strategy · /layers-conceptual-model · /layers-interaction-flow · /layers-surface

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

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

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