Communitygithub.com

ulasalyesil/personal-website-v2

Menez des entretiens de design, générez cinq variantes d'interface distinctes dans un laboratoire de design temporaire, recueillez des commentaires et produisez des plans d'implémentation. Utilisez cette compétence lorsque l'utilisateur souhaite explorer des options de conception d'interface, repenser des composants existants ou créer de nouvelles interfaces avec plusieurs approches à comparer.

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

Cette compétence implémente un flux de travail complet d'exploration de design pour les agents IA, permettant de passer de l'entretien utilisateur à la génération de variantes d'interface, à la collecte de retours, puis à la production d'un plan d'implémentation. Elle est conçue pour les projets utilisant des frameworks modernes comme Next.js, Vite, Remix, Nuxt ou Astro, avec une détection automatique du gestionnaire de paquets, du framework et du système de style (Tailwind CSS, Material UI, Chakra UI, etc.). Le processus comprend une phase d'entretien structurée pour recueillir le périmètre, les points faibles, l'inspiration et les contraintes, suivie de la création de cinq variantes d'interface distinctes explorant des axes de design différents (hiérarchie, mise en page, densité, interaction, expression). Un système de retour interactif (FeedbackOverlay) est intégré pour permettre aux utilisateurs de commenter chaque variante, et le laboratoire est nettoyé automatiquement à la fin, ne laissant aucun fichier temporaire derrière lui.

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

Demander à votre IA préférée

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

Documentation

Compétence Laboratoire de Design

Cette compétence implémente un flux de travail complet d'exploration de design : entretien, génération de variantes, collecte de retours, raffinement, prévisualisation et finalisation.

CRITIQUE : Comportement de Nettoyage

Tous les fichiers temporaires DOIVENT être supprimés lorsque le processus se termine, que ce soit par :

  • L'utilisateur confirme le design final → nettoyage, puis génération du plan
  • L'utilisateur abandonne/annule → nettoyage immédiat, aucun plan généré

Ne laissez jamais les dossiers .claude-design/ ou les routes __design_lab derrière vous. Si l'utilisateur dit « annuler », « abandonner », « arrêter » ou « oublie ça » à tout moment, confirmez puis supprimez tous les artefacts temporaires.


Phase 0 : Détection Pré-vol

Avant de commencer l'entretien, détectez automatiquement :

Gestionnaire de Paquets

Recherchez les fichiers de verrouillage dans la racine du projet :

  • pnpm-lock.yaml → utilisez pnpm
  • yarn.lock → utilisez yarn
  • package-lock.json → utilisez npm
  • bun.lockb → utilisez bun

Détection du Framework

Recherchez les fichiers de configuration :

  • next.config.js ou next.config.mjs ou next.config.ts → Next.js
    • Vérifiez la présence du dossier app/ → App Router
    • Vérifiez la présence du dossier pages/ → Pages Router
  • vite.config.js ou vite.config.ts → Vite
  • remix.config.js → Remix
  • nuxt.config.js ou nuxt.config.ts → Nuxt
  • astro.config.mjs → Astro

Détection du Système de Style

Recherchez les dépendances dans package.json et les fichiers de configuration :

  • tailwind.config.js ou tailwind.config.ts → Tailwind CSS
  • @mui/material dans les dépendances → Material UI
  • @chakra-ui/react dans les dépendances → Chakra UI
  • antd dans les dépendances → Ant Design
  • styled-components dans les dépendances → styled-components
  • @emotion/react dans les dépendances → Emotion
  • Fichiers .css ou .module.css → CSS Modules

Vérification de la Mémoire de Design

Recherchez un fichier de Mémoire de Design existant :

  • docs/design-memory.md
  • DESIGN_MEMORY.md
  • .claude-design/design-memory.md

S'il est trouvé, lisez-le et utilisez-le pour préremplir les valeurs par défaut et sauter les questions redondantes.

Inférence du Style Visuel (CRITIQUE)

N'utilisez PAS de styles prédéfinis/génériques. Extrayez le langage visuel du projet :

Si Tailwind est détecté, lisez tailwind.config.js ou tailwind.config.ts :

// Extrayez et utilisez :
theme.colors      // Palette de couleurs
theme.spacing     // Échelle d'espacement
theme.borderRadius // Valeurs de rayon
theme.fontFamily  // Typographie
theme.boxShadow   // Système d'élévation

Si des variables CSS existent, lisez globals.css, variables.css ou les définitions :root :

:root {
  --color-*     /* Jetons de couleur */
  --spacing-*   /* Jetons d'espacement */
  --font-*      /* Jetons de typographie */
  --radius-*    /* Jetons de rayon */
}

Si une bibliothèque d'interface est détectée (MUI, Chakra, Ant), lisez la configuration du thème :

  • MUI : theme.ts ou appel createTheme()
  • Chakra : theme/index.ts ou appel extendTheme()
  • Ant : propriété theme de ConfigProvider

Scannez toujours les composants existants pour comprendre les motifs :

  • Trouvez 2-3 boutons existants → notez leurs motifs de style
  • Trouvez 2-3 cartes existantes → notez le padding, les bordures, les ombres
  • Trouvez des formulaires existants → notez les styles des champs, le placement des labels
  • Trouvez la typographie existante → notez les tailles de titres, le corps du texte

Stockez les styles inférés dans le Cahier des Charges de Design pour une utilisation cohérente dans toutes les variantes.


Phase 1 : Entretien

Utilisez l'outil AskUserQuestion pour toutes les étapes de l'entretien. Adaptez les questions en fonction de la Mémoire de Design si elle existe.

Étape 1.1 : Périmètre & Cible

Posez ces questions (peuvent être combinées en une seule AskUserQuestion avec plusieurs questions) :

Question 1 : Périmètre

  • En-tête : « Périmètre »
  • Question : « Concevons-nous un seul composant ou une page entière ? »
  • Options :
    • « Composant » - Un élément d'interface réutilisable (bouton, carte, formulaire, modale, etc.)
    • « Page » - Une mise en page complète de page ou d'écran

Question 2 : Nouveau ou Refonte

  • En-tête : « Type »
  • Question : « S'agit-il d'un nouveau design ou d'une refonte de quelque chose d'existant ? »
  • Options :
    • « Nouveau » - Créer quelque chose à partir de zéro
    • « Refonte » - Améliorer un composant/page existant

Si « Refonte » est sélectionné, demandez : Question 3 : Chemin Existant

  • En-tête : « Emplacement »
  • Question : « Quel est le chemin du fichier ou la route de l'interface existante ? »
  • Options : (laissez l'utilisateur fournir via « Autre »)

Si la cible n'est pas claire, proposez un nom basé sur les motifs du dépôt et confirmez.

Étape 1.2 : Points Faibles & Inspiration

Question 1 : Points Faibles

  • En-tête : « Problèmes »
  • Question : « Quels sont les principaux points faibles du design actuel (ou que devrait éviter ce nouveau design) ? »
  • Options :
    • « Trop chargé/dense » - Surcharge d'information, difficile à parcourir
    • « Hiérarchie peu claire » - Les actions principales ne sont pas évidentes
    • « Mauvaise expérience mobile » - Ne fonctionne pas bien sur les petits écrans
    • « Aspect dépassé » - Semble vieux ou incohérent avec la marque
  • multiSelect : true

Question 2 : Inspiration Visuelle

  • En-tête : « Style visuel »
  • Question : « Quels produits ou marques devrais-je référencer pour l'inspiration visuelle ? »
  • Options :
    • « Stripe » - Propre, minimal, digne de confiance
    • « Linear » - Dense, orienté clavier, axé développeur
    • « Notion » - Flexible, axé contenu, ludique
    • « Apple » - Premium, spacieux, raffiné
  • multiSelect : true

Question 3 : Inspiration Fonctionnelle

  • En-tête : « Interactions »
  • Question : « Quels motifs d'interaction devrais-je imiter ? »
  • Options :
    • « Édition en ligne » - Modifier sur place sans modales
    • « Divulgation progressive » - Afficher plus au besoin
    • « Mises à jour optimistes » - Retour instantané, synchronisation en arrière-plan
    • « Raccourcis clavier » - Efficacité pour les utilisateurs avancés

Étape 1.3 : Direction de Marque & Style

Question 1 : Adjectifs de Marque

  • En-tête : « Ton de la marque »
  • Question : « Quels 3 à 5 adjectifs décrivent le ressenti souhaité de la marque ? »
  • Options :
    • « Minimal » - Propre, simple, sans encombrement
    • « Premium » - Haut de gamme, poli, raffiné
    • « Ludique » - Amusant, convivial, accessible
    • « Utilitaire » - Fonctionnel, efficace, sans fioritures
  • multiSelect : true

Question 2 : Densité

  • En-tête : « Densité »
  • Question : « Quelle densité d'information préférez-vous ? »
  • Options :
    • « Compact » - Plus d'informations visibles, espacement plus serré
    • « Confortable » - Espacement équilibré, balayage facile
    • « Spacieux » - Espaces blancs généreux, attention focalisée

Question 3 : Mode Sombre

  • En-tête : « Mode sombre »
  • Question : « Le mode sombre est-il requis ? »
  • Options :
    • « Oui » - Doit prendre en charge le mode sombre
    • « Non » - Mode clair uniquement
    • « Agréable à avoir » - Prendre en charge si facile, pas obligatoire

Étape 1.4 : Persona & Tâches à Accomplir

Question 1 : Utilisateur Principal

  • En-tête : « Utilisateur »
  • Question : « Qui est l'utilisateur final principal ? »
  • Options :
    • « Développeur » - Technique, orienté clavier
    • « Designer » - Visuel, soucieux des détails
    • « Utilisateur métier » - Axé efficacité, moins technique
    • « Consommateur final » - Grand public, compétence technique variée

Question 2 : Contexte

  • En-tête : « Contexte »
  • Question : « Quel est le contexte d'utilisation principal ? »
  • Options :
    • « D'abord desktop » - Principalement utilisé sur de grands écrans
    • « D'abord mobile » - Principalement utilisé sur téléphone
    • « Les deux également » - Doit bien fonctionner sur tous les appareils

Question 3 : Tâches Clés

  • En-tête : « Tâches clés »
  • Question : « Quelles sont les 3 principales tâches que les utilisateurs doivent accomplir ? »
  • (Laissez l'utilisateur fournir via « Autre » - c'est une question ouverte)

Étape 1.5 : Contraintes

Question 1 : Éléments à Conserver Impérativement

  • En-tête : « Conserver »
  • Question : « Y a-t-il des éléments qui doivent être préservés ? »
  • Options :
    • « Copie/étiquettes existantes » - Conserver le texte actuel
    • « Champs/saisies actuels » - Conserver la structure du formulaire
    • « Structure de navigation » - Conserver la navigation actuelle
    • « Aucun » - Libre de tout changer

Question 2 : Contraintes Techniques

  • En-tête : « Contraintes »
  • Question : « Y a-t-il des contraintes techniques ? »
  • Options :
    • « Aucune nouvelle dépendance » - Utiliser uniquement les bibliothèques existantes
    • « Utiliser les composants existants » - Construire sur le système de design actuel
    • « Doit être accessible (WCAG) » - Exigences strictes d'accessibilité
    • « Aucune » - Pas de contraintes particulières
  • multiSelect : true

Phase 2 : Générer le Cahier des Charges de Design

Après l'entretien, créez un Cahier des Charges de Design structuré en JSON et enregistrez-le dans .claude-design/design-brief.json :

{
  "scope": "component|page",
  "isRedesign": true|false,
  "targetPath": "src/components/Example.tsx",
  "targetName": "Example",
  "painPoints": ["Trop dense", "Action principale peu claire"],
  "inspiration": {
    "visual": ["Stripe", "Linear"],
    "functional": ["Validation en ligne"]
  },
  "brand": {
    "adjectives": ["minimal", "digne de confiance"],
    "density": "confortable",
    "darkMode": true
  },
  "persona": {
    "primary": "Développeur",
    "context": "desktop-first",
    "keyTasks": ["Terminer le paiement", "Voir la commande", "Appliquer une réduction"]
  },
  "constraints": {
    "mustKeep": ["champs existants"],
    "technical": ["aucune nouvelle dépendance", "accessible WCAG"]
  },
  "framework": "nextjs-app",
  "packageManager": "pnpm",
  "stylingSystem": "tailwind"
}

Affichez un résumé à l'utilisateur avant de continuer.


Phase 3 : Générer le Laboratoire de Design

Structure des Dossiers

Créez tous les fichiers sous .claude-design/ :

.claude-design/
├── lab/
│   ├── page.tsx                 # Page principale du labo (spécifique au framework)
│   ├── variants/
│   │   ├── VariantA.tsx
│   │   ├── VariantB.tsx
│   │   ├── VariantC.tsx
│   │   ├── VariantD.tsx
│   │   └── VariantE.tsx
│   ├── components/
│   │   └── LabShell.tsx         # Wrapper de mise en page du labo
│   ├── feedback/                # Système de retour interactif
│   │   ├── types.ts             # Interfaces TypeScript
│   │   ├── selector-utils.ts    # Identification d'éléments
│   │   ├── format-utils.ts      # Mise en forme des retours
│   │   ├── FeedbackOverlay.tsx  # Composant principal de superposition
│   │   └── index.ts             # Exportations du module
│   └── data/
│       └── fixtures.ts          # Données simulées partagées
├── design-brief.json
└── run-log.md

Configuration du Système de Retour (CRITIQUE - NE JAMAIS SAUTER)

Le FeedbackOverlay est la fonctionnalité PRINCIPALE du Laboratoire de Design. Sans lui, les utilisateurs ne peuvent pas fournir de retours interactifs. NE générez JAMAIS un Laboratoire de Design sans le FeedbackOverlay.

Stratégie de Fiabilité : Pour éviter les problèmes de chemins d'importation selon les différentes configurations de projet, créez le FeedbackOverlay directement dans le dossier de la route (par ex., app/design-lab/FeedbackOverlay.tsx), PAS dans .claude-design/. Cela garantit qu'une importation relative simple (./FeedbackOverlay) fonctionne toujours.

Fichiers Requis dans le Dossier de Route :

app/design-lab/           # ou app/__design_lab/ si les underscores fonctionnent
├── page.tsx              # Page principale du labo avec les variantes
└── FeedbackOverlay.tsx   # Composant de superposition autonome (copié depuis les modèles)

Source du Modèle : design-and-refine/templates/feedback/FeedbackOverlay.tsx

Pourquoi cette approche :

  • Les chemins .claude-design/ peuvent échouer à cause des configurations du bundler
  • Les importations relatives depuis le même dossier fonctionnent toujours
  • Le dossier de route est de toute façon supprimé lors du nettoyage

Intégration de la Route

Next.js App Router : Créez app/__design_lab/page.tsx qui importe depuis .claude-design/lab/

Next.js Pages Router : Créez pages/__design_lab.tsx qui importe depuis .claude-design/lab/

Vite React :

  • Si React Router existe : ajoutez une route vers /__design_lab
  • Si pas de routeur : créez un rendu conditionnel dans App.tsx basé sur le paramètre de requête ?design_lab=true

Autres frameworks : Créez la route temporaire la plus appropriée pour le framework détecté.

Directives de Génération de Variantes

IMPORTANT : Lisez DESIGN_PRINCIPLES.md pour les meilleures pratiques UX, d'interaction et de mouvement. Mais N'utilisez PAS de styles visuels prédéfinis—inférez-les du projet.

Appliquez les principes universels (depuis DESIGN_PRINCIPLES.md) :

  • UX : Heuristiques de Nielsen, réduction de charge cognitive, divulgation progressive
  • Comportement du composant : États des boutons, anatomie du formulaire, structure de la carte
  • Interaction : Motifs de retour, gestion des états, mises à jour optimistes
  • Mouvement : Timing (150-300ms), easing (entrées en ease-out, sorties en ease-in)
  • Accessibilité : États de focus, motifs ARIA, cibles tactiles (min 44px)

Inférez les styles visuels du projet :

  • Couleurs → depuis la config Tailwind, les variables CSS ou les composants existants
  • Typographie → depuis les titres existants, le corps du texte dans le codebase
  • Espacement → depuis l'échelle d'espacement du projet ou les motifs existants
  • Rayon de bordure → depuis les cartes, boutons, champs existants
  • Ombres → depuis les composants surélevés existants

Chaque variante DOIT explorer un axe de design différent. Ne créez pas de variations mineures—rendez-les distinctes de manière significative. Utilisez le langage visuel existant du projet pour toutes les variantes.

Variante A : Focus sur la Hiérarchie de l'Information

  • Restructurez la hiérarchie du contenu (qu'est-ce qui est le plus important ?)
  • Appliquez la proximité gestaltique—regroupez les éléments liés plus près
  • Une action principale par vue
  • Utilisez l'échelle typographique existante pour créer des niveaux clairs

Variante B : Exploration du Modèle de Mise en Page

  • Essayez une approche de mise en page différente (carte vs liste vs tableau vs panneau fractionné)
  • Appliquez l'anatomie de la carte ou les motifs de comportement du tableau depuis DESIGN_PRINCIPLES
  • Considérez le comportement responsive à chaque point de rupture
  • Utilisez le système de grille/mise en page existant du projet

Variante C : Variation de Densité

  • Si le cahier des charges dit « confortable », essayez une version plus compacte
  • Si le cahier des charges dit « compact », essayez une version plus spacieuse
  • Utilisez les jetons d'espacement existants du projet—appliquez-les simplement différemment
  • Montrez les compromis : plus de données visibles vs balayage plus facile

Variante D : Modèle d'Interaction

  • Motif d'interaction différent (modale vs en ligne vs panneau vs tiroir)
  • Appliquez les motifs de retour : immédiat → progression → achèvement
  • Implémentez tous les états requis (chargement, erreur, vide, désactivé)
  • Considérez les mises à jour optimistes pour les actions non destructrices

Variante E : Direction Expressive

  • Poussez la direction de marque que l'utilisateur a décrite dans l'entretien
  • Explorez différentes utilisations des jetons de design existants du projet
  • Plus ou moins d'utilisation d'ombres, de bordures, de couleurs de fond
  • Appliquez le mouvement là où il ajoute du sens (survol, focus, transitions)

Exigences de la Page du Laboratoire

La page du Laboratoire de Design doit inclure :

  1. En-tête avec :

    • Résumé du Cahier des Charges de Design (cible, périmètre, exigences clés)
    • Instructions pour l'examen
  2. Grille de Variantes avec :

    • Étiquettes claires (A, B, C, D, E)
    • Justification brève pour chaque variante (« Pourquoi elle existe »)
    • Le rendu réel de la variante

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

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

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