Communitygithub.com

usalyesil/personal-website-v2

Audita la superficie existente frente a decisiones de capas inferiores y produce un inventario de decisiones de superficie: vocabulario, consistencia de objetos, integridad, retroalimentación, jerarquía, accesibilidad

¿Qué es personal-website-v2?

Este skill de agente de IA, diseñado para plataformas como Claude Code, Cursor o Codex, se enfoca en la capa de superficie del diseño de productos. Su objetivo es auditar implementaciones existentes (código, UI, copia) contra las decisiones tomadas en capas inferiores (modelo conceptual, breadboard, interacciones) y producir un inventario completo de decisiones de superficie pendientes. Es útil para desarrolladores y diseñadores que buscan garantizar que la experiencia del usuario final sea coherente, accesible y emocionalmente alineada con las necesidades del usuario. El skill distingue entre problemas corregibles en la superficie y aquellos que requieren revisar capas más profundas, evitando parches superficiales que ocultan fallos estructurales. Ofrece un proceso guiado en dos partes: una auditoría detallada (vocabulario, consistencia de objetos, integridad, registro emocional) y un inventario de decisiones (retroalimentación, jerarquía, accesibilidad, consistencia). Al finalizar, produce hallazgos de auditoría, inventario de decisiones, problemas entre capas y aspectos que funcionan bien.

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

Preguntar en tu IA favorita

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

Documentación

/layers-surface

Asume que /layers-intro ya ha sido cargado para el contexto del framework.

La capa de superficie es donde todo lo decidido en las capas inferiores se convierte en algo que una persona realmente encuentra: palabras, sonidos, imágenes, affordances físicos, movimiento, retroalimentación. Es la capa más específica del medio, pero las decisiones más importantes que tomar primero son universales: se aplican independientemente de si la superficie es una pantalla, una interfaz de voz, un dispositivo físico o un punto de contacto de servicio.

Las violaciones de superficie a menudo son síntomas de problemas más profundos. Este skill distingue entre problemas que puedes solucionar en la superficie y problemas que requieren revisar una capa inferior.

Decisiones que esta capa necesita tomar:

  • ¿La superficie respeta el vocabulario y los objetos del modelo conceptual?
  • ¿Está presente cada affordance del breadboard, y hay contenido de superficie sin un modelo detrás?
  • ¿Transmite la superficie el registro emocional correcto para los trabajos que los usuarios están realizando?
  • ¿Cómo sabe el usuario qué pasó, qué está en progreso y qué salió mal?
  • ¿Qué es lo más prominente, y debería serlo?
  • ¿Es accesible cada pieza de información para los usuarios que la necesitan?

Métodos:

MétodoCuándo
Trabajar directamente en el medio real (código, UI de producción)Cuando necesitas retroalimentación real sobre interacciones reales. Evita la brecha entre cómo se ve algo en un mockup y cómo se comporta en uso.
Mockups de alta fidelidad (Figma, etc.)Explorar diseño, jerarquía visual y forma visual, especialmente para patrones novedosos o alineación de partes interesadas.
Sistema de diseño / biblioteca de componentesCuando el producto tiene componentes y tokens establecidos. Las decisiones de superficie deben extender el sistema, no contradecirlo.
Style tilesEstablecer el lenguaje visual temprano sin comprometerse con el diseño. Más rápido que alta fidelidad para la alineación tonal inicial.
PrototiposProbar el comportamiento de interacción (transiciones, temporización de retroalimentación, flujo) que los mockups estáticos no pueden transmitir.
Copy-firstCuando el lenguaje es el material de diseño principal: mensajería, onboarding, estados de error. Escribe el copy antes de diseñar el contenedor.

Señales de calidad: cómo se ven las buenas decisiones de superficie:

  • Cada término coincide con el lenguaje ubicuo del modelo conceptual
  • Cada objeto tiene una representación consistente en todos los contextos: no un cambiaformas, no enmascarado
  • Cada affordance del breadboard está presente; cada elemento de superficie tiene un modelo detrás
  • El registro emocional coincide con los trabajos emocionales y sociales de las necesidades del usuario
  • Los mensajes de error hacen tres cosas: diagnosticar (qué pasó), explicar (por qué), recuperar (qué hacer a continuación). "Algo salió mal" falla en las tres.
  • La prominencia refleja la importancia: lo que el flujo necesita que el usuario note es lo que destaca
  • Las decisiones de accesibilidad se toman explícitamente, no se dejan como valores predeterminados

Sesión guiada

Este skill tiene dos partes. Dime lo que necesitas:

  • Auditoría: evaluar el trabajo de superficie existente frente a decisiones de capas inferiores (Fases 1–5)
  • Inventario de decisiones: trabajar a través de decisiones de superficie abiertas (Fases 6–10)

Describe lo que tienes, o di "guíame" para comenzar.

Pregunta: "¿Dónde debería capturar el trabajo de esta sesión?" (consulta /layers-intro para opciones)

Pregunta:

  1. ¿En qué producto o característica estamos trabajando?
  2. ¿Qué medio? ¿UI de pantalla, voz/conversacional, físico, puntos de contacto de servicio?
  3. ¿Qué tienes de las capas inferiores? ¿Modelo conceptual (objetos + lenguaje ubicuo)? ¿Breadboard o flujo? ¿Historias de trabajo incluyendo trabajos emocionales/sociales?

Parte 1 — Auditoría

Fase 1 — Enmarcar la superficie

¿Existe trabajo de superficie? ¿Código funcional, UI desplegada, copy, diseños visuales? ¿O la superficie aún no ha comenzado? Si aún no ha comenzado, salta a la Parte 2.

Fase 2 — Vocabulario y lenguaje

Toma la lista de lenguaje ubicuo del modelo conceptual. Pide al diseñador que comparta el copy de superficie: etiquetas, encabezados, texto de botones, mensajes de error, notificaciones, texto de ayuda.

Revisa cada término. Señala:

  • Violaciones directas: un término del modelo usado incorrectamente o de manera inconsistente ("Cuenta" en un lugar, "Espacio de trabajo" en otro)
  • Términos no listados: palabras en la superficie que no están en el lenguaje ubicuo. ¿Nuevos términos para agregar al modelo, o ruido de superficie?
  • Desalineaciones tonales: técnicamente correcto pero tonalmente incorrecto para los trabajos emocionales/sociales

Para cada violación: ¿solución de superficie (reescribir copy) o solución más profunda (actualizar el vocabulario del modelo conceptual)?

Fase 3 — Consistencia de objetos

Para cada objeto en el modelo conceptual: ¿dónde aparece en la superficie? ¿En cuántas formas?

  • Cambiaformas: el mismo objeto en formas visuales o estructurales significativamente diferentes en distintos contextos
  • Objetos enmascarados: el objeto aparece en una forma en la que un usuario no podría reconocerlo como ese tipo de objeto

Para cada uno: ¿es una decisión de superficie (establecer un tratamiento consistente) o un problema del modelo conceptual (la identidad del objeto no está clara ni siquiera en el modelo)?

Fase 4 — Verificación de integridad

Toma el breadboard. Para cada lugar y affordance:

  • ¿Está presente cada affordance del breadboard en la superficie?
  • ¿Hay contenido de superficie sin un elemento de breadboard correspondiente?

Las adiciones que no estaban en el breadboard a menudo son decisiones de la capa de interacción que se colaron: señalízalas y recomienda revisitar /layers-interaction-flow.

Fase 5 — Registro emocional

Vuelve a las historias de trabajo, particularmente los trabajos emocionales y sociales.

"¿Qué trabajo emocional está haciendo el usuario aquí? No solo la tarea funcional, sino cómo quiere sentirse." "¿Qué trabajo social está en juego? ¿Cómo quiere ser percibido?"

Desalineaciones comunes:

  • La superficie enfatiza el beneficio del producto ("obtenemos una referencia") sobre el trabajo del usuario ("ayudo a un colega")
  • El copy enmarca una interacción de manera transaccional cuando el trabajo del usuario es relacional
  • El tono se siente experto/clínico cuando el usuario necesita sentirse tranquilo o seguro

Parte 2 — Inventario de decisiones

Fase 6 — Retroalimentación y errores

Para cada acción significativa y transición de estado:

  • "¿Cómo sabe el usuario que su acción funcionó?"
  • "¿Cómo sabe el usuario que algo está en progreso?"
  • "¿Cómo sabe el usuario que algo salió mal y qué hacer al respecto?"

Los mensajes de error deben diagnosticar, explicar y decir al usuario qué hacer a continuación. Señala cada estado de error que no cumpla con los tres. Produce una decisión para cada brecha: "Necesitamos decidir cómo comunicar [X] al usuario. Las opciones son [Y]."

Fase 7 — Jerarquía y énfasis

Para cada lugar clave:

  • "¿Qué es lo más importante que un usuario necesita notar o en lo que debe actuar aquí?"
  • "¿La superficie actual hace que eso sea lo más prominente?"
  • "¿Hay algo visualmente prominente que no debería serlo?"

Estas son decisiones independientes del medio primero (qué debería ser primario) antes de volverse específicas del medio (cómo hacerlo primario visual, auditiva o táctilmente).

Fase 8 — Accesibilidad

Señala consideraciones relevantes para el medio declarado:

  • UI de pantalla: contraste de color, tamaño de texto, objetivos táctiles, navegación por teclado, etiquetas de lector de pantalla para elementos interactivos e imágenes, gestión de enfoque a través de pasos del flujo
  • Voz/conversacional: toda la información transmitida verbalmente (sin "haz clic en el botón de la izquierda"), recuperación de errores sin contexto visual
  • Físico: alcance, diferenciación táctil, visibilidad en iluminación variada, operación sin precisión motora fina

Produce una lista de decisiones de accesibilidad: "Necesitamos decidir cómo [X] será accesible para usuarios que [Y]."

Fase 9 — Consistencia

  • ¿Las cosas similares se tratan de manera similar? (Las mismas acciones se ven y se comportan igual; los mismos tipos de objetos se representan de manera consistente)
  • ¿Las cosas diferentes se tratan de manera diferente? (Primario vs. secundario, destructivo vs. seguro)
  • ¿Esta superficie se ajusta a las convenciones de su medio? Violar las normas de la plataforma es una decisión con un costo: a veces vale la pena, siempre intencional.

Distinguir: inconsistencias internas (arreglar dentro de la superficie) vs. violaciones de convenciones (elección deliberada o descuido: decidir cuál).

Fase 10 — Decisiones abiertas

Produce una lista consolidada de todas las decisiones de superficie aún por tomar:

  • Problemas entre capas para resolver primero: la raíz está en una capa inferior; listados por separado; requieren revisar el skill relevante antes de que la superficie pueda ser correcta
  • Decisiones de superficie para tomar ahora: ¿cuál es la decisión? ¿cuáles son las opciones? ¿qué restricciones aplican (de capas inferiores, el medio, la marca/consistencia)?
  • Diferidas: no necesitan tomarse ahora pero deben rastrearse

Finalización

Produce:

  1. Hallazgos de auditoría: violaciones de vocabulario, objetos enmascarados/cambiaformas, brechas de integridad, desalineaciones del registro emocional, cada una categorizada como solución de superficie o problema de capa más profunda
  2. Inventario de decisiones: todas las decisiones de superficie abiertas, agrupadas y priorizadas
  3. Problemas entre capas: cosas para resolver en una capa inferior antes de que la superficie pueda ser correcta
  4. Lo que funciona: decisiones de superficie ya tomadas correctamente; no las pierdas en la revisión

Cierra con: "La superficie es la capa que los usuarios encuentran. Todo lo decidido debajo se honra aquí o se socava aquí. Revisita este skill después de cualquier cambio significativo al modelo conceptual o a la estructura de interacció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

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

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

Skills relacionados