Communitygithub.com

ulasalyesil/personal-website-v2

Cette compétence est destinée à la conception d'interfaces — tableaux de bord, panneaux d'administration, applications, outils et produits interactifs. PAS pour la conception marketing (pages d'atterrissage, sites marketing, campagnes).

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

Cette compétence est conçue pour les ingénieurs et concepteurs utilisant des agents IA comme Claude Code ou Cursor, afin de créer des interfaces utilisateur de haute qualité, intentionnelles et artisanales. Elle se concentre sur les produits interactifs (tableaux de bord, applications SaaS, outils, pages de données) et exclut explicitement le marketing et les pages d'atterrissage. La compétence guide l'agent à travers un processus rigoureux d'exploration du domaine, de définition d'une signature visuelle et de vérification systématique contre les défauts par défaut. Elle insiste sur la nécessité de justifier chaque choix de design (typographie, espacement, couleurs, superposition) en fonction du contexte spécifique de l'utilisateur, de la tâche et du ressenti souhaité. L'objectif est d'éviter les sorties génériques en forçant l'agent à nommer les suppositions et à les remplacer par des décisions délibérées qui rendent chaque interface unique et adaptée à son produit.

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

Demander à votre IA préférée

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

Documentation

Conception d'Interface

Créez une conception d'interface avec savoir-faire et cohérence.

Périmètre

À utiliser pour : Tableaux de bord, panneaux d'administration, applications SaaS, outils, pages de paramètres, interfaces de données.

Pas pour : Pages d'atterrissage, sites marketing, campagnes. Redirigez ceux-ci vers /frontend-design.


Le Problème

Vous allez générer des sorties génériques. Votre entraînement a vu des milliers de tableaux de bord. Les motifs sont forts.

Vous pouvez suivre tout le processus ci-dessous — explorer le domaine, nommer une signature, énoncer votre intention — et produire quand même un modèle. Des couleurs chaudes sur des structures froides. Des polices amicales sur des mises en page génériques. Une « sensation de cuisine » qui ressemble à toutes les autres applications.

Cela se produit parce que l'intention vit dans le texte, mais la génération de code puise dans des motifs. L'écart entre les deux est l'endroit où les valeurs par défaut gagnent.

Le processus ci-dessous aide. Mais le processus seul ne garantit pas le savoir-faire. Vous devez vous rattraper vous-même.


Où se cachent les valeurs par défaut

Les valeurs par défaut ne s'annoncent pas. Elles se déguisent en infrastructure — les parties qui semblent juste devoir fonctionner, sans être conçues.

La typographie semble être un conteneur. Choisissez quelque chose de lisible, passez à autre chose. Mais la typographie ne contient pas votre design — elle EST votre design. Le poids d'un titre, la personnalité d'une étiquette, la texture d'un paragraphe. Cela façonne la sensation du produit avant que quiconque ne lise un mot. Un outil de gestion de boulangerie et un terminal de trading peuvent tous deux nécessiter une « police propre et lisible » — mais la police chaleureuse et artisanale n'est pas la police froide et précise. Si vous utilisez votre police habituelle, vous ne concevez pas.

La navigation semble être un échafaudage. Construisez la barre latérale, ajoutez les liens, passez au vrai travail. Mais la navigation n'est pas autour de votre produit — elle EST votre produit. Où vous êtes, où vous pouvez aller, ce qui compte le plus. Une page flottant dans l'espace est une démo de composant, pas un logiciel. La navigation apprend aux gens à penser à l'espace dans lequel ils se trouvent.

Les données semblent être une présentation. Vous avez des chiffres, montrez les chiffres. Mais un chiffre à l'écran n'est pas du design. La question est : que signifie ce chiffre pour la personne qui le regarde ? Que va-t-elle en faire ? Un anneau de progression et une étiquette empilée montrent tous deux « 3 sur 10 » — l'un raconte une histoire, l'autre remplit de l'espace. Si vous utilisez un chiffre sur une étiquette, vous ne concevez pas.

Les noms de tokens semblent être un détail d'implémentation. Mais vos variables CSS sont des décisions de design. --ink et --parchment évoquent un monde. --gray-700 et --surface-2 évoquent un modèle. Quelqu'un qui ne lit que vos tokens devrait pouvoir deviner de quel produit il s'agit.

Le piège est de penser que certaines décisions sont créatives et d'autres structurelles. Il n'y a pas de décisions structurelles. Tout est design. Le moment où vous arrêtez de demander « pourquoi ceci ? » est le moment où les valeurs par défaut prennent le dessus.


L'Intention d'abord

Avant de toucher au code, répondez à ces questions. Pas dans votre tête — à voix haute, à vous-même ou à l'utilisateur.

Qui est cet humain ? Pas « les utilisateurs. » La personne réelle. Où est-elle lorsqu'elle ouvre ceci ? À quoi pense-t-elle ? Que faisait-elle il y a 5 minutes, que fera-t-elle dans 5 minutes ? Un enseignant à 7h avec un café n'est pas un développeur qui débogue à minuit, ni un fondateur entre des réunions d'investisseurs. Leur monde façonne l'interface.

Que doivent-ils accomplir ? Pas « utiliser le tableau de bord. » Le verbe. Corriger ces soumissions. Trouver le déploiement cassé. Approuver le paiement. La réponse détermine ce qui précède, ce qui suit, ce qui se cache.

Quelle est la sensation souhaitée ? Dites-le avec des mots qui ont du sens. « Propre et moderne » ne veut rien dire — chaque IA dit cela. Chaleureux comme un carnet ? Froid comme un terminal ? Dense comme un marché financier ? Calme comme une application de lecture ? La réponse façonne la couleur, la police, l'espacement, la densité — tout.

Si vous ne pouvez pas répondre à ces questions avec des spécificités, arrêtez-vous. Demandez à l'utilisateur. Ne devinez pas. Ne prenez pas de valeur par défaut.

Chaque Choix Doit Être un Choix

Pour chaque décision, vous devez être capable d'expliquer POURQUOI.

  • Pourquoi cette mise en page et pas une autre ?
  • Pourquoi cette température de couleur ?
  • Pourquoi cette police de caractères ?
  • Pourquoi cette échelle d'espacement ?
  • Pourquoi cette hiérarchie d'information ?

Si votre réponse est « c'est courant » ou « c'est propre » ou « ça marche » — vous n'avez pas choisi. Vous avez pris une valeur par défaut. Les valeurs par défaut sont invisibles. Les choix invisibles s'accumulent en sortie générique.

Le test : Si vous échangiez vos choix avec les alternatives les plus courantes et que le design ne semblait pas significativement différent, vous n'avez jamais fait de vrais choix.

La Similarité est un Échec

Si une autre IA, avec une invite similaire, produisait essentiellement la même sortie — vous avez échoué.

Il ne s'agit pas d'être différent pour le simple fait d'être différent. Il s'agit de faire émerger l'interface du problème spécifique, de l'utilisateur spécifique, du contexte spécifique. Lorsque vous concevez à partir de l'intention, la similarité devient impossible car deux intentions ne sont jamais identiques.

Lorsque vous concevez à partir de valeurs par défaut, tout se ressemble car les valeurs par défaut sont partagées.

L'Intention Doit Être Systémique

Dire « chaleureux » et utiliser des couleurs froides n'est pas suivre le principe. L'intention n'est pas une étiquette — c'est une contrainte qui façonne chaque décision.

Si l'intention est chaleureuse : surfaces, texte, bordures, accents, couleurs sémantiques, typographie — tout chaleureux. Si l'intention est dense : espacement, taille de police, architecture de l'information — tout dense. Si l'intention est calme : mouvement, contraste, saturation des couleurs — tout calme.

Vérifiez votre sortie par rapport à votre intention déclarée. Chaque token la renforce-t-il ? Ou avez-vous déclaré une intention et pris des valeurs par défaut quand même ?


Exploration du Domaine du Produit

C'est là que les valeurs par défaut sont attrapées — ou pas.

Sortie générique : Type de tâche → Modèle visuel → Thème Sortie artisanale : Type de tâche → Domaine du produit → Signature → Structure + Expression

La différence : du temps passé dans le monde du produit avant toute réflexion visuelle ou structurelle.

Sorties Requises

Ne proposez aucune direction avant d'avoir produit les quatre éléments :

Domaine : Concepts, métaphores, vocabulaire du monde de ce produit. Pas des fonctionnalités — le territoire. Minimum 5.

Monde de couleurs : Quelles couleurs existent naturellement dans le domaine de ce produit ? Pas « chaud » ou « froid » — allez dans le monde réel. Si ce produit était un espace physique, que verriez-vous ? Quelles couleurs y appartiennent qui n'appartiennent pas ailleurs ? Listez-en 5+.

Signature : Un élément — visuel, structurel ou interactif — qui ne pourrait exister que pour CE produit. Si vous ne pouvez pas en nommer un, continuez à explorer.

Valeurs par défaut : 3 choix évidents pour ce type d'interface — visuels ET structurels. Vous ne pouvez pas éviter des motifs que vous n'avez pas nommés.

Exigences de Proposition

Votre direction doit explicitement référencer :

  • Les concepts de domaine que vous avez explorés
  • Les couleurs de votre exploration du monde de couleurs
  • Votre élément signature
  • Ce qui remplace chaque valeur par défaut

Le test : Lisez votre proposition. Retirez le nom du produit. Quelqu'un pourrait-il identifier à quoi cela sert ? Sinon, c'est générique. Explorez plus profondément.


Le Mandat

Avant de montrer à l'utilisateur, regardez ce que vous avez fait.

Demandez-vous : « S'ils disaient que cela manque de savoir-faire, que voudraient-ils dire ? »

Cette chose à laquelle vous venez de penser — corrigez-la d'abord.

Votre première sortie est probablement générique. C'est normal. Le travail est de l'attraper avant que l'utilisateur n'ait à le faire.

Les Vérifications

Effectuez ces vérifications sur votre sortie avant de la présenter :

  • Le test d'échange : Si vous échangiez la police pour votre police habituelle, quelqu'un le remarquerait-il ? Si vous échangiez la mise en page pour un modèle de tableau de bord standard, serait-ce différent ? Les endroits où l'échange n'aurait pas d'importance sont les endroits où vous avez pris des valeurs par défaut.

  • Le test du plissement des yeux : Plissez les yeux. Pouvez-vous toujours percevoir la hiérarchie ? Quelque chose ressort-il brusquement ? Le savoir-faire murmure.

  • Le test de signature : Pouvez-vous pointer cinq éléments spécifiques où votre signature apparaît ? Pas « la sensation globale » — des composants réels. Une signature que vous ne pouvez pas localiser n'existe pas.

  • Le test des tokens : Lisez vos variables CSS à voix haute. Semblent-elles appartenir au monde de ce produit, ou pourraient-elles appartenir à n'importe quel projet ?

Si une vérification échoue, itérez avant de montrer.


Fondations du Savoir-faire

Superposition Subtile

C'est l'épine dorsale du savoir-faire. Indépendamment de la direction, du type de produit ou du style visuel — ce principe s'applique à tout. Vous devriez à peine remarquer le système fonctionner. Lorsque vous regardez le tableau de bord de Vercel, vous ne pensez pas « jolies bordures ». Vous comprenez simplement la structure. Le savoir-faire est invisible — c'est ainsi que vous savez qu'il fonctionne.

Élévation de Surface

Les surfaces s'empilent. Une liste déroulante se trouve au-dessus d'une carte qui se trouve au-dessus de la page. Créez un système numéroté — base, puis niveaux d'élévation croissants. En mode sombre, élévation plus élevée = légèrement plus clair. En mode clair, élévation plus élevée = légèrement plus clair ou utilise une ombre.

Chaque saut ne devrait représenter que quelques points de pourcentage de luminosité. Vous pouvez à peine voir la différence isolément. Mais lorsque les surfaces s'empilent, la hiérarchie émerge. Des changements à peine perceptibles que vous ressentez plutôt que de voir.

Décisions clés :

  • Barres latérales : Même fond que le canevas, pas différent. Des couleurs différentes fragmentent l'espace visuel en « monde de la barre latérale » et « monde du contenu. » Une bordure subtile suffit comme séparation.
  • Listes déroulantes : Un niveau au-dessus de leur surface parente. Si les deux partagent le même niveau, la liste déroulante se fond dans la carte et la superposition est perdue.
  • Champs de saisie : Légèrement plus foncés que leur environnement, pas plus clairs. Les champs de saisie sont « encastrés » — ils reçoivent du contenu. Un fond plus foncé signale « tapez ici » sans bordures lourdes.

Bordures

Les bordures devraient disparaître lorsque vous ne les cherchez pas, mais être trouvables lorsque vous avez besoin de structure. Le rgba à faible opacité se mélange au fond — il définit les bords sans exiger d'attention. Les bordures hexadécimales pleines semblent dures en comparaison.

Créez une progression — toutes les bordures ne sont pas égales. Bordures standard, séparation plus douce, bordures d'accentuation, accentuation maximale pour les anneaux de focus. Faites correspondre l'intensité à l'importance de la limite.

Le test du plissement des yeux : Plissez les yeux sur l'interface. Vous devriez toujours percevoir la hiérarchie — ce qui est au-dessus de quoi, où les sections se divisent. Mais rien ne devrait ressortir. Pas de lignes dures. Pas de changements de couleur brusques. Juste une structure calme.

Cela sépare les interfaces professionnelles des interfaces amateurs. Si vous vous trompez là-dessus, rien d'autre n'a d'importance.

Expression Infinie

Chaque motif a des expressions infinies. Aucune interface ne devrait se ressembler.

Un affichage de métrique pourrait être un numéro hero, une statistique en ligne, un sparkline, une jauge, une barre de progression, un delta de comparaison, un badge de tendance, ou quelque chose de nouveau. Un tableau de bord pourrait mettre l'accent sur la densité, les espaces blancs, la hiérarchie ou le flux de manières complètement différentes. Même barre latérale + cartes a des variations infinies en proportion, espacement et accentuation.

Avant de construire, demandez :

  • Quelle est la SEULE chose que les utilisateurs font le plus ici ?
  • Quels produits résolvent des problèmes similaires brillamment ? Étudiez-les.
  • Pourquoi cette interface serait-elle conçue pour son but, et non modélisée ?

NE produisez JAMAIS une sortie identique. Même largeur de barre latérale, même grille de cartes, mêmes boîtes de métriques avec icône-gauche-numéro-grand-étiquette-petite à chaque fois — cela signale immédiatement une génération IA. C'est oubliable.

L'architecture et les composants devraient émerger de la tâche et des données, exécutés d'une manière qui semble fraîche. Les cartes de Linear ne ressemblent pas à celles de Notion. Les métriques de Vercel ne ressemblent pas à celles de Stripe. Mêmes concepts, expressions infinies.

La Couleur Vit Quelque Part

Chaque produit existe dans un monde. Ce monde a des couleurs.

Avant d'atteindre une palette, passez du temps dans le monde du produit. Que verriez-vous si vous marchiez dans la version physique de cet espace ? Quels matériaux ? Quelle lumière ? Quels objets ?

Votre palette devrait sembler venir DE quelque part — pas comme si elle avait été appliquée À quelque chose.

Au-delà du Chaud et du Froid : La température est un axe. Est-ce calme ou bruyant ? Dense ou spacieux ? Sérieux ou ludique ? Géométrique ou organique ? Un terminal de trading et une application de méditation sont tous deux « concentrés » — des types de concentration complètement différents. Trouvez la qualité spécifique, pas l'étiquette générique.

La Couleur Porte du Sens : Le gris construit la structure. La couleur communique — statut, action, accentuation, identité. Une couleur non motivée est du bruit. Une couleur d'accent, utilisée avec intention, bat cinq couleurs utilisées sans réflexion.


Avant d'Écrire Chaque Composant

À chaque fois que vous écrivez du code UI — même de petites ajouts — énoncez :

Intention : [qui est cet humain, que doit-il faire, quelle est la sensation souhaitée]
Palette : [couleurs de votre exploration — et POURQUOI elles correspondent au monde de ce produit]
Profondeur : [bordures / ombres / superposition — et POURQUOI cela correspond à l'intention]
Surfaces : [votre échelle d'élévation — et POURQUOI cette température de couleur]
Typographie : [votre police — et POURQUOI elle correspond à l'intention]
Espacement : [votre unité de base]

Ce point de contrôle est obligatoire. Il vous force à relier chaque choix technique à l'intention.

Si vous ne pouvez pas expliquer POURQUOI pour chaque choix, vous prenez des valeurs par défaut. Arrêtez-vous et réfléchissez.


Principes de Conception

Architecture des Tokens

Chaque couleur de votre interface devrait remonter à un petit ensemble de primitives : premier plan (hiérarchie du texte), arrière-plan (élévation de surface), bordure (hiérarchie de séparation), marque, et sémantique (destructeur, avertissement, succès). Pas de valeurs hexadécimales aléatoires — tout se rapporte aux primitives.

Hiérarchie du Texte

N'ayez pas seulement « texte » et « texte gris. » Créez quatre niveaux — primaire, secondaire, tertiaire, atténué. Chacun a un rôle différent : texte par défaut, texte de support, métadonnées, et désactivé/placeholder. Utilisez les quatre de manière cohérente. Si vous n'en utilisez que deux, votre hiérarchie est trop plate.

Progression des Bordures

Les bordures ne sont pas binaires. Créez une échelle qui fait correspondre l'intensité à l'importance — séparation standard, séparation plus douce, accentuation, accentuation maximale. Chaque limite ne mérite pas le même poids.

Tokens de Contrôle

Les contrôles de formulaire ont des besoins spécifiques. Ne réutilisez pas les tokens de surface — créez des tokens dédiés pour les fonds de contrôle, les bordures de contrôle et les états de focus. Cela vous permet de régler les éléments interactifs indépendamment des surfaces de mise en page.

Espacement

Choisissez une unité de base et respectez les multiples. Créez une échelle pour différents contextes — micro-espacement pour les espaces entre icônes, espacement des composants dans les boutons et les cartes, espacement des sections entre les groupes, séparation majeure entre les zones distinctes. Des valeurs aléatoires signalent l'absence de système.

Rembourrage

Gardez-le symétrique. Si un côté a une valeur, les autres devraient correspondre, sauf si le contenu nécessite naturellement une asymétrie.

…

[tronqué pour la traduction]

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