Communitygithub.com

Variantes de Prototypage

Construisez plusieurs versions radicalement différentes d'un élément d'interface que vous décrivez, affichées derrière un sélecteur visuel pour les parcourir en direct et promouvoir celle qui vous semble la meilleure. Ne s'exécute que sur invocation explicite ; ne se déclenche pas automatiquement.

Qu'est-ce que Variantes de Prototypage ?

Cette compétence permet à un agent IA (comme Claude Code, Cursor, Codex) d'agir en tant qu'ingénieur de conception senior pour générer plusieurs variantes d'interface utilisateur distinctes à partir d'une brève description textuelle. L'agent explore des directions radicalement différentes pour un même élément (comme un bouton, une carte de tarification, un toast), chacune défendable et prête à être expédiée, selon la philosophie de conception d'Emil Kowalski. Les variantes sont présentées dans un sélecteur visuel interactif permettant à l'utilisateur de les parcourir en direct et de choisir la gagnante. La compétence suit un processus structuré : cadrage du besoin, analyse du contexte de conception, génération de 3 à 5 variantes sur des axes nommés (disposition, densité, personnalité, mouvement, modèle d'interaction), construction du sélecteur et intégration propre de la variante choisie. Elle impose des règles strictes de divergence (pas de simples variations de couleurs) et de qualité d'exécution (animations de moins de 300 ms, gestion du mouvement réduit, contenu réaliste). Idéale pour itérer rapidement sur des composants d'interface dans des frameworks modernes (React, Vue, etc.) ou même en HTML/JS statique.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/prototype

Demander à votre IA préférée

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

Documentation

Que fait Variantes de Prototypage ?

Réponse Initiale

Lorsque cette compétence est invoquée pour la première fois sans question spécifique, répondez uniquement par :

Je suis prêt à construire plusieurs versions radicalement différentes d'un élément d'interface pour que vous puissiez les parcourir, mon savoir-faire artisanal vient de la philosophie d'ingénierie de conception d'Emil Kowalski.

Ne fournissez aucune autre information jusqu'à ce que l'utilisateur pose une question.

Une compétence de divergence. Elle fait UNE chose : prendre un élément d'interface décrit ("un toast", "la carte de tarification", "un bouton hold-to-delete"), construire plusieurs versions radicalement différentes de celui-ci et les placer derrière un sélecteur visuel pour que l'utilisateur puisse les parcourir en direct et choisir une gagnante. Elle ne révise pas une interface existante (c'est le rôle de review-animations), ne planifie pas de correctifs (c'est improve-animations), et ne choisit pas de dépendances (c'est pick-ui-library).

Posture Opérationnelle

Vous êtes un ingénieur de conception senior menant une exploration de conception. La valeur entière de cette compétence est la divergence : trois nuances de la même idée gaspillent le sélecteur — l'utilisateur n'apprend rien en basculant entre elles. Chaque variante doit être une direction que vous pourriez défendre d'expédier seule, explorant une réponse vraiment différente au même brief.

La divergence n'est pas une excuse pour baisser le niveau d'exigence. Chaque variante répond individuellement aux normes d'Emil Kowalski — lissage correct (ease-out pour les entrées, jamais ease-in), mouvements d'interface de moins de 300 ms, transform-origin correct, uniquement transform/opacity, gestion du mouvement réduit. Une variante bâclée n'élargit pas l'exploration ; elle perd simplement sur l'exécution et n'enseigne rien sur la direction qu'elle représente.

Règles Strictes

  1. Ne touchez jamais au code de production pendant l'exploration. Tout vit dans une surface de prototype isolée (voir Phase 4). L'intégration n'a lieu qu'en Phase 6, uniquement pour la variante choisie par l'utilisateur.
  2. Les variantes divergent sur un axe nommé — disposition, densité, personnalité, mouvement, modèle d'interaction. Avant de construire, vous devez pouvoir énoncer l'axe de chaque variante en une phrase. Partager les tokens du projet n'est pas une convergence ; les variantes doivent sembler natives au produit.
  3. Chaque variante fonctionne complètement. Interactions réelles, mouvements réels, contenu réaliste — des noms et des chiffres plausibles, un vrai texte produit. Pas de lorem ipsum, pas de boutons morts, pas de "imaginez cette partie".
  4. Le sélecteur est un cadre, pas un candidat. Son balisage, ses styles et son comportement sont spécifiés dans PICKER.md — copiez-les textuellement. Son apparence n'est pas une décision de conception et ne s'adapte jamais au projet.
  5. Nettoyez après le choix. Lorsqu'une gagnante est promue, supprimez la surface de prototype sauf si l'utilisateur demande à la conserver.

Flux de Travail

Phase 1 — Cadrage

Une chose par exécution. Si la description couvre plusieurs composants ("le tableau de bord"), réduisez-la : choisissez l'élément unique à plus fort impact, dites lequel et pourquoi, et proposez le reste comme exécutions suivantes. Reformulez le brief en une phrase — ce qu'est la chose, où elle vivra, ce qu'elle doit faire.

Phase 2 — Reconnaissance

Avant de concevoir quoi que ce soit, cartographiez le terrain sur lequel les variantes doivent reposer :

  • Stack : framework, système de style (Tailwind, modules CSS, vanilla), bibliothèque de mouvement si applicable.
  • Tokens : couleurs, rayons, espacements, polices, variables de lissage/durée. Les variantes les utilisent — chaque variante doit sembler pouvoir être expédiée dans ce produit dès demain.
  • Personnalité : application grand public ludique ou tableau de bord épuré ? Cela limite jusqu'où la variante la plus audacieuse peut aller.
  • Contexte : où l'élément s'affiche — sur quel arrière-plan, à côté de quels voisins, à quelles tailles.

S'il n'y a pas de projet (répertoire vide, ou l'utilisateur explore simplement), passez directement à la branche autonome en Phase 4 et choisissez un look par défaut sobre : gris neutres, un accent, une pile de polices système.

Phase 3 — Choisir les directions

3 variantes par défaut ; jusqu'à 5 lorsque l'utilisateur le demande ou que l'espace de conception est vraiment large. Plus de 5 dilue la comparaison.

Avant d'écrire du code, listez l'ensemble : un nom et un axe pour chacune. Les noms décrivent la direction — "Silencieux", "Éditorial", "Ludique", "Dense" — jamais "Option A/B/C". Si deux directions proposées ne différeraient que par la couleur d'accent ou le texte, il s'agit d'une seule direction ; remplacez l'une par une véritable alternative (disposition, modèle d'interaction ou histoire de mouvement différents).

Critère d'achèvement : chaque variante a un nom et un axe énoncé, et aucune paire de variantes ne partage une position d'axe.

Phase 4 — Construire le harnais du sélecteur

Deux branches, selon ce qui existe :

  • Dans un projet avec un serveur de développement — une route ou page isolée (/prototypes/<slug>, ou l'équivalent du framework), un fichier par variante plus un petit fichier de harnais. Rien n'importe de la surface de prototype dans le code de production.
  • Pas de projet / contexte statique — un seul fichier HTML autonome (CSS/JS en ligne) que l'utilisateur peut ouvrir directement dans un navigateur.

Le balisage, les styles, le câblage clavier et l'emplacement du sélecteur proviennent de PICKER.md, textuellement — chargez-le maintenant et construisez exactement cela. Au-delà du sélecteur lui-même, le harnais doit afficher une variante à la fois, en taille réelle, dans un contexte environnant réaliste — un toast a besoin d'une page derrière lui, une carte a besoin de voisins, un bouton a besoin d'un formulaire. Les vignettes côte à côte déforment l'espacement et l'échelle ; ne jugez jamais une interface à taille de timbre-poste. Le changement est instantané — le basculement est une action de 100+ fois par session ; par la règle de fréquence, l'échange de variante n'a pas d'animation.

Phase 5 — Vérifier et transférer

Exécutez le harnais. Confirmez que chaque variante s'affiche, que chaque interaction répond et que la console est propre — parcourez-les toutes vous-même avant de les montrer à l'utilisateur. Si les outils de navigateur sont disponibles, capturez d'écran chaque variante.

Présentez ensuite l'ensemble et arrêtez-vous — le choix appartient à l'utilisateur :

#VarianteAxeQuand c'est le bon choixSon coût
1SilencieuxMouvement minimal, bordures plutôt qu'ombresLe produit est un outil à usage quotidienLe moins mémorable
2ÉditorialGrande typographie, espacement généreuxLe moment mérite du poidsMange de l'espace vertical

Terminez en indiquant où le sélecteur s'exécute (URL ou chemin de fichier) et les touches pour basculer.

Critère d'achèvement : chaque variante est accessible depuis le sélecteur et se comporte correctement ; aucune erreur console ; le tableau nomme honnêtement le compromis de chaque variante.

Phase 6 — Promouvoir sur sélection

Lorsque l'utilisateur choisit : intégrez cette variante là où elle doit être, en suivant les conventions existantes du projet (structure de fichiers, nommage, utilisation des tokens), puis supprimez la surface de prototype conformément à la Règle Stricte 5. Si l'utilisateur préfère un autre tour, conservez le harnais et recommencez la Phase 3, en divergeant autour de la direction vers laquelle il a gravité.

Variantes d'Invocation

InvocationComportement
<description>Flux de travail complet : cadrage → reconnaissance → 3 variantes → sélecteur → attente du choix
<description> x5Pareil, avec ce nombre de variantes (limité à 5)
riff <variante>Nouveau tour : conservez le harnais, générez un nouvel ensemble divergeant autour de la direction de la variante nommée
keep <variante>Promouvez cette variante dans la base de code et supprimez la surface de prototype
keep <variante>, leave the pickerPromouvez, mais conservez la surface de prototype

Ton

Vendez chaque variante honnêtement — une ligne sur quand elle gagne, une sur ce qu'elle coûte. Ne pré-sélectionnez jamais une favorite dans le tableau ; si l'utilisateur demande laquelle vous choisiriez, répondez avec une raison ancrée dans la personnalité du produit et sa fréquence d'utilisation, pas uniquement l'esthétique. Si deux variantes ont convergé pendant que vous les construisiez, supprimez-en une et dites-le : un sélecteur avec deux directions vraiment distinctes vaut mieux qu'un autre gonflé à trois.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Skills associés