Communitygithub.com

ulasalyesil/personal-website-v2

Audite la surface existante par rapport aux décisions des couches inférieures et produit un inventaire des décisions de surface : vocabulaire, cohérence des objets, complétude, feedback, hiérarchie, accessibilité.

Qu'est-ce que personal-website-v2 ?

Cette compétence, conçue pour être utilisée après la compétence `/layers-intro`, se concentre sur la couche de surface : l'endroit où toutes les décisions prises dans les couches inférieures deviennent tangibles pour l'utilisateur (mots, sons, visuels, affordances physiques, mouvement, feedback). Elle aide à détecter les incohérences entre la surface existante (code, maquettes, prototypes) et les décisions conceptuelles et d'interaction prises en dessous. La compétence distingue les problèmes qui peuvent être résolus directement en surface de ceux qui nécessitent de revisiter une couche inférieure, comme le modèle conceptuel ou le flux d'interaction. Elle propose deux modes d'utilisation : un audit pour évaluer un travail de surface existant, et un inventaire des décisions pour explorer les choix ouverts. Elle couvre des aspects critiques comme la cohérence du vocabulaire, la fidélité des objets, l'exhaustivité des affordances, le registre émotionnel, la hiérarchie visuelle et l'accessibilité. L'agent applique une série de phases structurées pour identifier les violations, les objets déguisés ou changeants, les lacunes de complétude, et les désalignements émotionnels, avant de produire un inventaire consolidé des décisions de surface à prendre.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

/layers-surface

Suppose que /layers-intro a été chargé pour le contexte du framework.

La couche de surface est celle où tout ce qui a été décidé dans les couches inférieures devient quelque chose qu'une personne rencontre réellement : mots, sons, visuels, affordances physiques, mouvement, feedback. C'est la couche la plus spécifique au médium, mais les décisions les plus importantes à prendre en premier sont universelles — elles s'appliquent indépendamment du fait que la surface soit un écran, une interface vocale, un appareil physique ou un point de contact de service.

Les violations de surface sont souvent les symptômes de problèmes plus profonds. Cette compétence distingue les problèmes que vous pouvez résoudre en surface de ceux qui nécessitent de revisiter une couche inférieure.

Décisions que cette couche doit prendre :

  • La surface respecte-t-elle le vocabulaire et les objets du modèle conceptuel ?
  • Chaque affordance de la breadboard est-elle présente — et y a-t-il du contenu de surface sans modèle derrière ?
  • La surface transmet-elle le bon registre émotionnel pour les tâches que les utilisateurs effectuent ?
  • Comment l'utilisateur sait-il ce qui s'est passé, ce qui est en cours et ce qui a mal tourné ?
  • Qu'est-ce qui est le plus prominent, et devrait-il l'être ?
  • Chaque information est-elle accessible aux utilisateurs qui en ont besoin ?

Méthodes :

MéthodeQuand
Travailler directement dans le médium réel (code, UI de production)Lorsque vous avez besoin de retours réels sur des interactions réelles. Évite l'écart entre l'apparence d'un mockup et son comportement en utilisation.
Maquettes haute fidélité (Figma, etc.)Explorer la mise en page, la hiérarchie visuelle et la forme visuelle — en particulier pour des schémas novateurs ou l'alignement des parties prenantes.
Système de design / bibliothèque de composantsLorsque le produit a des composants et des tokens établis. Les décisions de surface doivent étendre le système, non le contredire.
Style tilesÉtablir le langage visuel tôt sans s'engager sur la mise en page. Plus rapide que la haute fidélité pour l'alignement tonal initial.
PrototypesTester le comportement d'interaction — transitions, timing des feedbacks, flux — que les maquettes statiques ne peuvent pas transmettre.
Copie d'abordLorsque le langage est le principal matériau de conception — messagerie, onboarding, états d'erreur. Rédigez le texte avant de concevoir le conteneur.

Signaux de qualité — à quoi ressemblent de bonnes décisions de surface :

  • Chaque terme correspond au langage universel du modèle conceptuel
  • Chaque objet a une représentation cohérente dans tous les contextes — ni changeant, ni masqué
  • Chaque affordance de la breadboard est présente ; chaque élément de surface a un modèle derrière lui
  • Le registre émotionnel correspond aux tâches émotionnelles et sociales des besoins utilisateurs
  • Les messages d'erreur font trois choses : diagnostiquer (ce qui s'est passé), expliquer (pourquoi), récupérer (quoi faire ensuite). "Quelque chose a mal tourné" échoue sur les trois.
  • La proéminence reflète l'importance — ce dont le flux a besoin que l'utilisateur remarque est ce qui se démarque
  • Les décisions d'accessibilité sont explicitement prises, non laissées par défaut

Session guidée

Cette compétence a deux parties. Dites-moi ce dont vous avez besoin :

  • Audit — évaluer le travail de surface existant par rapport aux décisions des couches inférieures (Phases 1–5)
  • Inventaire des décisions — parcourir les décisions de surface ouvertes (Phases 6–10)

Décrivez ce que vous avez, ou dites "guidez-moi" pour commencer.

Demandez : "Où dois-je capturer le travail de cette session ?" (voir /layers-intro pour les options)

Demandez :

  1. Sur quel produit ou fonctionnalité travaillons-nous ?
  2. Quel médium — UI d'écran, vocal/conversationnel, physique, points de contact de service ?
  3. Qu'avez-vous des couches inférieures ? Modèle conceptuel (objets + langage universel) ? Breadboard ou flux ? Job stories incluant les tâches émotionnelles/sociales ?

Partie 1 — Audit

Phase 1 — Cadrer la surface

Existe-t-il un travail de surface existant — code fonctionnel, UI déployée, copie, designs visuels ? Ou la surface n'a-t-elle pas encore commencé ? Si elle n'a pas encore commencé, passez à la Partie 2.

Phase 2 — Vocabulaire et langage

Prenez la liste de langage universel du modèle conceptuel. Demandez au designer de partager la copie de surface — étiquettes, titres, texte des boutons, messages d'erreur, notifications, texte d'aide.

Vérifiez chaque terme. Signalez :

  • Violations directes — un terme du modèle utilisé incorrectement ou de manière incohérente ("Compte" à un endroit, "Espace de travail" à un autre)
  • Termes non répertoriés — mots sur la surface qui ne sont pas dans le langage universel. Nouveaux termes à ajouter au modèle, ou bruit de surface ?
  • Désalignements de ton — techniquement corrects mais tonalement mauvais pour les tâches émotionnelles/sociales

Pour chaque violation : correction de surface (réécrire la copie) ou correction plus profonde (mettre à jour le vocabulaire du modèle conceptuel) ?

Phase 3 — Cohérence des objets

Pour chaque objet du modèle conceptuel : où apparaît-il sur la surface ? Sous combien de formes ?

  • Changeurs de forme — même objet dans des formes visuelles ou structurelles significativement différentes selon les contextes
  • Objets masqués — l'objet apparaît sous une forme où un utilisateur ne pourrait pas le reconnaître comme ce type d'objet

Pour chacun : est-ce une décision de surface (établir un traitement cohérent) ou un problème de modèle conceptuel (l'identité de l'objet n'est pas claire même dans le modèle) ?

Phase 4 — Vérification de complétude

Prenez la breadboard. Pour chaque lieu et affordance :

  • Chaque affordance de la breadboard est-elle présente dans la surface ?
  • Y a-t-il du contenu de surface sans élément correspondant dans la breadboard ?

Les ajouts qui n'étaient pas dans la breadboard sont souvent des décisions de la couche d'interaction qui ont glissé — signalez-les et recommandez de revisiter /layers-interaction-flow.

Phase 5 — Registre émotionnel

Revenez aux job stories, en particulier les tâches émotionnelles et sociales.

"Quelle tâche émotionnelle l'utilisateur effectue-t-il ici — non seulement la tâche fonctionnelle, mais comment veut-il se sentir ?" "Quelle tâche sociale est en jeu — comment veut-il être perçu ?"

Désalignements courants :

  • La surface met l'accent sur le bénéfice du produit ("nous obtenons une recommandation") plutôt que sur la tâche de l'utilisateur ("j'aide un collègue")
  • La copie cadre une interaction de manière transactionnelle alors que la tâche de l'utilisateur est relationnelle
  • Le ton semble expert/clinique alors que l'utilisateur a besoin de se sentir rassuré ou confiant

Partie 2 — Inventaire des décisions

Phase 6 — Feedback et erreurs

Pour chaque action significative et transition d'état :

  • "Comment l'utilisateur sait-il que son action a fonctionné ?"
  • "Comment l'utilisateur sait-il que quelque chose est en cours ?"
  • "Comment l'utilisateur sait-il que quelque chose a mal tourné, et quoi faire ?"

Les messages d'erreur doivent diagnostiquer, expliquer et dire à l'utilisateur quoi faire ensuite. Signalez chaque état d'erreur qui ne remplit pas les trois conditions. Produisez une décision pour chaque lacune : "Nous devons décider comment communiquer [X] à l'utilisateur. Les options sont [Y]."

Phase 7 — Hiérarchie et emphase

Pour chaque lieu clé :

  • "Quelle est la chose la plus importante que l'utilisateur doit remarquer ou sur laquelle agir ici ?"
  • "La surface actuelle rend-elle cette chose la plus proéminente ?"
  • "Y a-t-il quelque chose de visuellement proéminent qui ne devrait pas l'être ?"

Ce sont d'abord des décisions agnostiques au médium (ce qui doit être primaire) avant de devenir spécifiques au médium (comment le rendre primaire visuellement, auditivement ou tactilement).

Phase 8 — Accessibilité

Signalez les considérations pertinentes pour le médium déclaré :

  • UI d'écran : contraste des couleurs, taille du texte, cibles tactiles, navigation au clavier, étiquettes de lecteur d'écran pour les éléments interactifs et les images, gestion du focus à travers les étapes du flux
  • Vocal/conversationnel : toutes les informations transmises verbalement (pas de "cliquez sur le bouton à gauche"), récupération d'erreur sans contexte visuel
  • Physique : atteignabilité, différenciation tactile, visibilité dans des conditions d'éclairage variées, fonctionnement sans motricité fine

Produisez une liste de décisions d'accessibilité : "Nous devons décider comment [X] sera accessible aux utilisateurs qui [Y]."

Phase 9 — Cohérence

  • Les choses similaires sont-elles traitées de manière similaire ? (Mêmes actions ont le même aspect et comportement ; mêmes types d'objets représentés de manière cohérente)
  • Les choses différentes sont-elles traitées différemment ? (Primaire vs. secondaire, destructeur vs. sûr)
  • Cette surface est-elle conforme aux conventions de son médium ? Violer les normes de la plateforme est une décision qui a un coût — parfois valable, toujours intentionnelle.

Distinguez : incohérences internes (correction au sein de la surface) vs. violations de conventions (choix délibéré ou oubli — décidez lequel).

Phase 10 — Décisions ouvertes

Produisez une liste consolidée de toutes les décisions de surface encore à prendre :

  • Problèmes inter-couches à résoudre d'abord — la racine est dans une couche inférieure ; listés séparément ; nécessitent de revisiter la compétence pertinente avant que la surface puisse être correcte
  • Décisions de surface à prendre maintenant — quelle est la décision ? quelles sont les options ? quelles contraintes s'appliquent (des couches inférieures, du médium, de la marque/cohérence) ?
  • Reportées — n'ont pas besoin d'être prises maintenant mais doivent être suivies

Achèvement

Produisez :

  1. Résultats de l'audit — violations de vocabulaire, objets masqués/changeants, lacunes de complétude, désalignements du registre émotionnel — chacun catégorisé comme correction de surface ou problème de couche plus profonde
  2. Inventaire des décisions — toutes les décisions de surface ouvertes, regroupées et priorisées
  3. Problèmes inter-couches — choses à résoudre à une couche inférieure avant que la surface puisse être correcte
  4. Ce qui fonctionne — décisions de surface déjà bien prises ; ne les perdez pas lors de la révision

Terminez par : "La surface est la couche que les utilisateurs rencontrent. Tout ce qui est décidé en dessous est soit honoré ici, soit miné ici. Revenez à cette compétence après tout changement significatif au modèle conceptuel ou à la structure d'interaction."

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 associés