design-system
Skill3 starsChanged 9 days agoMITView on GitHub
Tire de la maquette validée le design system web — inventaire des valeurs, composants et gestes réellement utilisés, tokens en 3 couches (primitifs, sémantiques, composants), échelles typo et d''espacement, motion, composants avec tous leurs états, page de démonstration HTML — puis le critique contre une grille anti-« design généré par IA » et le corrige. Étape 8 de Lance ton site.
193 other projects use a version of this.
Adopted by
Most recently taken up by
- lengrufeng2008/dsh-skill-librarytheir own version, first seen Nov 15, 2026
- dmoreq/precepttheir own version, first seen Nov 15, 2026
- carlos2219/web-kittheir own version, first seen Nov 15, 2026
- kobiniv888-ai/Claude-codetheir own version, first seen Nov 15, 2026
- chuanglibs/Claude-Code-Game-Studios-Codextheir own version, first seen Nov 15, 2026
- jeremy-colard-dev/agent-communication-claudetheir own version, first seen Nov 15, 2026
Used with
Projects with it also use setup-engine, team-level and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
CoralGameSkillsetup-engine
Configure the project's game engine and version. Pins the engine in CLAUDE.md, detects knowledge gaps, and populates engine reference docs via WebSearch when the version is beyond the LLM's training data.
Also in 13 projects that use this
CoralGameSkillteam-level
Orchestrate level design team: level-designer + narrative-director + world-builder + art-director + systems-designer + qa-tester for complete area/level creation.
Also in 12 projects that use this
lilangMaxSkillcreate-stories
Break a single epic into implementable story files. Reads the epic, its GDD, governing ADRs, and control manifest. Each story embeds its GDD requirement TR-ID, ADR guidance, acceptance criteria, story type, and test evidence path. Run after /create-epics for each epic.
Also in 11 projects that use this
lilangMaxSkillstory-done
End-of-story completion review. Reads the story file, verifies each acceptance criterion against the implementation, checks for GDD/ADR deviations, prompts code review, updates story status to Complete, and surfaces the next ready story from the sprint.
Also in 11 projects that use this
- +2 more from CoralGame
- +6 more from lilangMax
Other versions193 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 193
- nextlevelbuilder/ui-ux-pro-max-skill★ 150ksame name
- getsentry/sentry★ 46ksame name
- Donchitos/Claude-Code-Game-Studios★ 39ksame name
- anthropics/knowledge-work-plugins★ 36ksame name
- ethereum/ethereum-org-website★ 6ksame name
- langwatch/langwatch★ 5ksame name
- joye61/pic-smaller★ 2.9ksame name
- daveebbelaar/bama★ 1.7ksame name
- reatom/reatom★ 1.4ksame name
- microsoft/power-platform-skills★ 1.2ksame name
183 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository15 other files it gives its agents.
- commun/agents.mdAGENTS.md
- architectureSkill
- cadrageSkill
- charteSkill
- construireSkill
- contenusSkill
- demarrerSkill
- deployerSkill
- maquetteSkill
- marqueSkill
- mediasSkill
- objets-3dSkill
- passationSkill
- prdSkill
- statutSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.
0
Common
Most of the 175 edited versions we read keep these.
1
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 17
Document présenté : suivre le modèle ${CLAUDE_PLUGIN_ROOT}/commun/modeles/design-system.md, en entier.
- Distinctive: line 179
Test persona : le persona principal se reconnaîtrait-il dans cette page ?
“Common” is measured: kept by at least 6 in 10 of the 175 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Design system
Équipe d'agents : lancer ensemble, dès le début, tout ce que prévoit
${CLAUDE_PLUGIN_ROOT}/commun/agents.md pour cette étape (un agent Sonnet par source,
page ou pièce indépendante).
Lire ${CLAUDE_PLUGIN_ROOT}/commun/conventions.md et
${CLAUDE_PLUGIN_ROOT}/commun/parcours.md (rythme, document publié, porte de
validation). On montre d'abord l'inventaire de la maquette (§ 1).
Document présenté : suivre le modèle ${CLAUDE_PLUGIN_ROOT}/commun/modeles/design-system.md,
en entier. Aucune image générée à cette étape (les médias de
l'étape 6 suffisent).
Le design system n'invente rien : il formalise la maquette validée (étape 7), qui a elle-même habillé les wireframes dans la charte. Il donne à la construction des tokens et des composants nommés, avec tous leurs états, pour que le site reproduise la maquette sans la réinterpréter.
Viser le niveau décrit dans ${CLAUDE_PLUGIN_ROOT}/commun/niveau-agence.md (le lire
maintenant) : grandes images, grille éditoriale, mouvement dessiné. La démo est notée sur
sa grille (§ 6). Le seuil de l'étape est 85 (${CLAUDE_PLUGIN_ROOT}/commun/boucle-persona.md,
« Le contrôle d'étape »).
Entrées
07-maquette/validée :maquette.md(style, composition, gestes, écarts),prototype/theme.css, le prototype et les pages. Le prototype07-maquette/prototype/accueil.htmlfait foi, pas la copie du canevas. Pas validée : s'arrêter et renvoyer à/lancetonsite:maquette.03-charte/charte.md(couleurs, typos, logo) pour vérifier que rien n'a dérivé ·05-contenus/(vrais textes de la démo) ·06-medias/(images de la démo).
Outils
- Skill
ui-ux-pro-maxinstallé → l'utiliser pour les règles UX et les états des composants (le style est déjà choisi à la maquette). Sinon MCPui-skills→get_skillnextlevelbuilder-ui-ux-pro-max(etnextlevelbuilder-design-systempour les tokens). Sinon, données intégrées (MIT, nextlevelbuilder/ui-ux-pro-max-skill) dansdata/:styles.csv(50 styles actifs),typography.csv,colors.csv,landing.csv,ux-guidelines.csv,motion.csv. Recherche (mots clés en anglais, les données le sont) :python3 ${CLAUDE_SKILL_DIR}/scripts/chercher.py styles "raw editorial natural". - Skill
impeccableinstallé → l'utiliser pour la critique finale (mode critique/audit). Sinon MCPui-skills→get_skillpbakaus-impeccable, puispbakaus-critique/pbakaus-polish. Sinon, grille intégrée references/anti-patterns.md. En cas de désaccord entreui-ux-pro-maxetimpeccable(ou la grille), c'estimpeccable/ la grille anti-« IA » qui l'emporte.
1. Relever la maquette
Le style, la composition et les gestes sont déjà choisis et validés à la maquette
(07-maquette/maquette.md, 00-etat.md ligne « Composition ») : ne pas les rouvrir.
Ici, on fait l'inventaire de ce que la maquette utilise vraiment, en lançant ensemble
(${CLAUDE_PLUGIN_ROOT}/commun/agents.md) un agent par famille :
- valeurs : couleurs, polices, tailles, interlignes, espacements, rayons, ombres,
durées et courbes lus dans
theme.csset dans les pages (07-maquette/prototype/, dont<page>.html) ; toute valeur isolée trouvée dans une page est listée ; - composants : chaque élément répété (bouton, carte, champ, en-tête, FAQ, fiche produit…), avec les pages où il apparaît et ses variantes vues ;
- gestes : ceux notés dans
maquette.mdet ceux branchés dans le prototype (data-*).
Puis ranger : deux valeurs presque égales se fusionnent (14 px et 15 px → une
seule), une valeur isolée rejoint l'échelle ou se justifie. Chaque fusion qui change le
rendu se note dans DESIGN.md (« Écarts avec la maquette ») et se reporte dans la
maquette : maquette et design system ne divergent jamais.
Les images de la démo viennent de 06-medias/ (manifeste) ; jamais un rectangle vide.
2. Les tokens
Architecture en 3 couches (references/token-architecture.md) :
primitifs (--color-sable-200) → sémantiques (--color-surface, --color-action) →
composants (--button-bg).
À produire dans projet-site/08-design-system/tokens.json, en partant de la structure
de templates/design-tokens-starter.json et en
remplaçant toutes ses valeurs (gris et bleus génériques) par celles de la charte.
Les noms de variables CSS découlent du chemin JSON (semantic.color.bg →
--color-bg) : choisir des chemins qui donnent les noms utilisés dans DESIGN.md.
Une valeur composite (objet) ou une référence introuvable fait échouer la génération :
découper en tokens simples.
- Couleurs : celles de la charte, avec états (survol, actif, désactivé, focus) et
fonctionnelles (succès, alerte, erreur). Contrastes revérifiés
(
python3 ${CLAUDE_PLUGIN_ROOT}/skills/charte/scripts/contraste.py). - Typographie : échelle fluide en
clamp()(mobile → desktop), interlignage, longueur de ligne 60-75 caractères. Interlettrage des titres d'affichage (la source unique) : les lettres d'un grand titre ne se touchent jamais. Sur une police condensée ou serrée (Anton, Bebas, Oswald, une grotesque étroite, une serif d'affichage resserrée), l'interlettrage des titres est d'au moins 0 : jamais négatif, souvent0.01emà0.02emen très grand corps. Sur une police à chasse normale, -0,02 em au plus serré. Un token--tracking-displayporte la valeur, et les titres l'utilisent tous ; untracking-tighterproposé par le catalogue (data/) ne l'emporte pas sur cette règle. Contrôle à l'œil : capture du hero et d'un titre de section à 1440 × 900 et à 375 × 812, zoom sur les lettres ; deux lettres qui se touchent ou se chevauchent, c'est à corriger. - Espacement : base 4 ou 8 px, 8 à 10 paliers nommés.
- Rayons, bordures, ombres : peu de paliers, cohérents avec le style. Pas un rayon identique partout par défaut.
- Motion : 3 durées (rapide ~150 ms, normale ~250 ms, lente ~450 ms), 3 courbes
nommées (entrée, sortie, emphase) en
cubic-bezier, et la règleprefers-reduced-motion. - Points de rupture : mobile d'abord.
Générer tokens.css :
node ${CLAUDE_SKILL_DIR}/scripts/generate-tokens.cjs --config projet-site/08-design-system/tokens.json -o projet-site/08-design-system/tokens.css.
Puis tailwind.css : le bloc @theme de Tailwind CSS v4 qui expose ces tokens
(couleurs, polices, échelle typo, espacements, rayons, ombres, courbes et durées), pour
que la maquette et le site s'écrivent en classes Tailwind
(references/tailwind-integration.md) :
node ${CLAUDE_SKILL_DIR}/scripts/generate-tokens.cjs --config projet-site/08-design-system/tokens.json --format tailwind -o projet-site/08-design-system/tailwind.css
(tokens sémantiques en clair, palette par défaut coupée). C'est ce bloc qui remplace le
@theme de démonstration du kit de maquette.
3. Les composants
Ceux que la maquette utilise (inventaire du § 1), rien de plus. En général : en-tête et navigation (desktop + mobile), boutons (principal, secondaire, lien), champs de formulaire, cartes, bloc de l'action principale (le soigner en premier), fiche produit et carte d'article si le zoning a un catalogue ou un journal, FAQ (accordéon), témoignage (réel uniquement), pied de page complet, bandeau cookies.
La barre de navigation part d'un modèle des skills (ui-ux-pro-max, ou MCP
ui-skills) et le bloc d'action se compose en deux colonnes : règles dans
${CLAUDE_PLUGIN_ROOT}/commun/niveau-agence.md § 3 (barre de navigation, blocs
d'action et formulaires).
Pour chacun, tous les états (references/states-and-variants.md) : repos, survol, focus clavier visible, actif, désactivé, chargement, erreur, vide. Cibles tactiles ≥ 44 px. Spécification au format de references/component-specs.md.
4. Le mouvement
Les gestes sont ceux de la maquette validée (§ 1) : un par type de section et le moment
signature. Ne pas en ajouter ; un type de section sans geste se signale. Pour chaque
geste : où, durée,
courbe, déclencheur, version « mouvement réduit ». Le tout dans DESIGN.md § motion.
Pas de rebond, rien qui retarde l'action principale, 60 images par seconde (transform,
opacity, clip-path seulement). Repères : data/motion.csv. Les gestes se voient
dans demo.html (animés, pas décrits).
5. La page de démonstration
projet-site/08-design-system/demo.html, autonome, écrite en Tailwind CSS v4
(@tailwindcss/browser depuis un CDN, version exacte, avec le @theme des tokens) et
GSAP + Lenis pour le mouvement — partir des gestes du kit
${CLAUDE_PLUGIN_ROOT}/skills/maquette/templates/prototype/ (gestes.js et le <head>
technique d'index.html ; ses sections sont une démonstration, pas une structure) :
palette et contrastes, échelle typo, espacements, tous les composants de l'inventaire dans
tous leurs états, avec les vrais textes du site, en clair, tous les gestes de mouvement en
action et au moins une section de démonstration avec une grande image (de 06-medias/).
Responsive. La démo est toujours complète. Un fabricant par groupe de composants et un pour la
page (agents.md). La montrer à l'utilisateur.
6. La critique (obligatoire)
Tous les points, dans l'ordre, sur la démo complète.
- Passer la démo à
impeccable(installé, ou viaui-skills) ou à la grille references/anti-patterns.md. - Capturer
demo.htmlaux tailles de la liste unique (conventions, « Captures d'écran ») dans08-design-system/captures/, et faire le contrôle à l'œil de l'interlettrage des titres (§ 2, « Typographie »), puis lancer l'agentrelecteuravec les chemins des captures et dedemo.html, et la consigne : « Trouve tout ce qui fait généré par IA, et tout ce qui pourrait servir tel quel à un concurrent. » Dans Claude (ni agent ni navigateur) : relire soi-même en changeant de posture, sur le rendu dedemo.htmlou du design system Claude Design. - Vérifier : chaque token et chaque composant se retrouve-t-il dans la maquette validée, et chaque couleur ou police dans la charte ? Une valeur qui n'est ni l'une ni l'autre a été inventée : la retirer. Un composant de la maquette absent : l'ajouter.
- Test persona : le persona principal se reconnaîtrait-il dans cette page ?
- Noter la démo sur la grille sur 100 de
niveau-agence.md§ 6 (critères applicables à un design system : direction artistique, mise en page, mouvement, accessibilité). Une démo qui ressemble à une ébauche (composants alignés sans images ni mouvement) ne passe pas. Cette note sert à corriger ; celle qu'on dit à la porte vient du contrôle d'étape. - Corriger, régénérer la démo, refaire les captures, lister les corrections dans
DESIGN.md(« Critique »).
7. Les livrables
Dans projet-site/08-design-system/ :
DESIGN.md(templates/DESIGN.md) — la référence lisible par l'humain et par l'IA qui construira le site ;tokens.json,tokens.cssettailwind.css(@theme) ;demo.html;captures/(§ 6).
Dans Claude, si node manque pour générer tokens.css et tailwind.css : les écrire à la
main depuis tokens.json (même règle de nommage), et le dire.
8. Le design system dans Claude Design
Dans Claude : créer un design system Claude Design (type « Design system ») à partir
de DESIGN.md, tokens.css, demo.html, du logo (03-charte/logo/) et des polices de
la charte, nommé « {{Projet}} ». Vérifier sur son aperçu que couleurs, typos, rayons et
composants correspondent aux tokens ; corriger l'écart dans le design system Claude
Design, pas dans les tokens (les tokens font foi). C'est lui que la construction
(étape 11) utilisera ; relier le canevas de la maquette à ce design system si l'outil le
permet. Noter son nom ou son lien dans 00-etat.md.
Dans Claude Code : même chose si l'outil Artifact propose le type « Design System »
(action: "quickstart", intent: "other") ; sinon demo.html suffit, le canevas de
la construction reprendra les tokens.
Avant la porte
À cocher d'après les fichiers, pas de mémoire. Chemins depuis projet-site/. Un manque se fait
maintenant ; il ne s'envoie pas au contrôle.
08-design-system/DESIGN.md: toutes les sections du gabarit remplies, plus aucun{{. Une ligne par composant de l'inventaire, avec tous ses états. Un geste par ligne, avec sa version « mouvement réduit ». Critique (§ 10) et écarts avec la maquette écrits.08-design-system/tokens.json: les 3 couches, plus aucune valeur du gabarit de départ.08-design-system/tokens.csset08-design-system/tailwind.cssgénérés après la dernière modification detokens.json.08-design-system/demo.html, la démo complète du § 5 : palette et contrastes, échelle typo, espacements, chaque composant de l'inventaire dans chacun de ses états, vrais textes, gestes en action, grande image de06-medias/, version téléphone, mouvement réduit.08-design-system/captures/:demo.htmlà chaque taille (conventions § 8), refaites après la dernière correction.- Contrastes revérifiés avec
contraste.py, résultat noté dansDESIGN.md. - Chaque token et chaque composant se retrouve dans la maquette ou la charte (§ 6, point 3).
- Chaque fusion qui change le rendu est reportée dans
07-maquette/prototype/theme.css(§ 1). 00-etat.md: statut de l'étape, lien du document, nom ou lien du design system Claude Design s'il existe.
Puis le contrôle d'étape : ${CLAUDE_PLUGIN_ROOT}/commun/boucle-persona.md, « Le contrôle
d'étape », rapports dans boucle-persona/etape-08/iteration-M/. Puis la porte (§ 9).
9. La porte
Le document présenté (parcours.md § 3) : le design system publié en design
(Claude Design, ou demo.html publiée comme page), avec en tête une synthèse lisible de
DESIGN.md (composition, style, couleurs, échelle typo, gestes). Jamais une capture
comme livrable. La note du contrôle d'étape se dit juste avant la question, sans être présentée comme une
validation. Puis porte de validation (parcours.md § 4) : jamais la vérification
sans un oui. 00-etat.md et tableau de bord à jour. Prochaine étape :
/lancetonsite:passation — la vérification avant de coder.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

