Communitygithub.com

tmnhutwork/design-system

Auditez, documentez ou étendez votre système de design. À utiliser pour vérifier les incohérences de nommage ou les valeurs codées en dur, rédiger la documentation des variantes, états et notes d’accessibilité d’un composant, ou concevoir un nouveau motif s’intégrant au système existant.

Qu'est-ce que design-system ?

Cette compétence spécialisée vous aide à gérer et faire évoluer votre système de design. Elle permet de lancer un audit complet (nommage, tokens, couverture des composants), de documenter précisément un composant (variantes, états, accessibilité, bonnes pratiques), ou de concevoir un nouveau motif ou composant en s’assurant qu’il s’intègre harmonieusement au système existant. La compétence propose des sorties structurées en Markdown pour chaque usage : audit, documentation et extension. Elle prend en charge la connexion à des outils de design (comme Figma) pour auditer directement les composants et récupérer leurs propriétés, ainsi qu’à une base de connaissances pour rechercher ou publier la documentation. Les principes fondamentaux sont la cohérence, la flexibilité dans des contraintes, la documentation systématique et la gestion des migrations.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tmnhutwork/Landingpage-Photo-Retouch/tree/HEAD/.agents/plugins/anthropic-design/skills/design-system

Demander à votre IA préférée

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

Documentation

/design-system

Si vous voyez des espaces réservés inconnus ou devez vérifier quels outils sont connectés, consultez CONNECTORS.md.

Gérez votre système de design — auditez la cohérence, documentez les composants ou concevez de nouveaux motifs.

Utilisation

/design-system audit                    # Audit complet du système
/design-system document [composant]     # Documenter un composant
/design-system extend [motif]           # Concevoir un nouveau composant ou motif

Composants d'un Système de Design

Tokens de Design

Valeurs atomiques qui définissent le langage visuel :

  • Couleurs (marque, sémantiques, neutres)
  • Typographie (échelle, graisses, interlignes)
  • Espacement (échelle, espacement des composants)
  • Bordures (rayon, épaisseur)
  • Ombres (niveaux d'élévation)
  • Mouvement (durées, courbes d'accélération)

Composants

Éléments d'interface réutilisables avec des éléments définis :

  • Variantes (primaire, secondaire, fantôme)
  • États (défaut, survol, actif, désactivé, chargement, erreur)
  • Tailles (sm, md, lg)
  • Comportement (interactions, animations)
  • Accessibilité (ARIA, clavier)

Motifs

Solutions d'interface courantes combinant des composants :

  • Formulaires (groupes de saisie, validation, soumission)
  • Navigation (barre latérale, onglets, fil d'Ariane)
  • Affichage de données (tableaux, cartes, listes)
  • Retour d'information (toasts, modales, messages en ligne)

Principes

  1. Cohérence avant créativité — Le système existe pour que les équipes ne réinventent pas la roue
  2. Flexibilité dans les contraintes — Les composants doivent être composables, pas rigides
  3. Tout documenter — Si ce n'est pas documenté, ça n'existe pas
  4. Versionner et migrer — Les changements cassants nécessitent des chemins de migration

Sortie — Audit

## Audit du Système de Design

### Résumé
**Composants examinés :** [X] | **Problèmes trouvés :** [X] | **Score :** [X/100]

### Cohérence de nommage
| Problème | Composants | Recommandation |
|----------|------------|----------------|
| [Nommage incohérent] | [Liste] | [Standard à adopter] |

### Couverture des tokens
| Catégorie | Définis | Valeurs codées en dur trouvées |
|-----------|---------|-------------------------------|
| Couleurs | [X] | [X] occurrences de hex codé en dur |
| Espacement | [X] | [X] occurrences de valeurs arbitraires |
| Typographie | [X] | [X] occurrences de polices/tailles personnalisées |

### Complétude des composants
| Composant | États | Variantes | Docs | Score |
|-----------|-------|-----------|------|-------|
| Bouton | ✅ | ✅ | ⚠️ | 8/10 |
| Champ | ✅ | ⚠️ | ❌ | 5/10 |

### Actions prioritaires
1. [Amélioration la plus impactante]
2. [Deuxième priorité]
3. [Troisième priorité]

Sortie — Document

## Composant : [Nom]

### Description
[Ce qu'est ce composant et quand l'utiliser]

### Variantes
| Variante | Utiliser quand |
|----------|---------------|
| [Primaire] | [Actions principales] |
| [Secondaire] | [Actions secondaires] |

### Props / Propriétés
| Propriété | Type | Défaut | Description |
|-----------|------|--------|-------------|
| [prop] | [type] | [défaut] | [description] |

### États
| État | Visuel | Comportement |
|------|--------|-------------|
| Défaut | [description] | — |
| Survol | [description] | [interaction] |
| Actif | [description] | [interaction] |
| Désactivé | [description] | Non interactif |
| Chargement | [description] | [animation] |

### Accessibilité
- **Rôle** : [rôle ARIA]
- **Clavier** : [comportement Tab, Entrée, Échap]
- **Lecteur d'écran** : [annoncé comme…]

### À faire et à ne pas faire
| ✅ À faire | ❌ À ne pas faire |
|-----------|------------------|
| [Bonne pratique] | [Anti-patron] |

### Exemple de code
[Extrait de code adapté au framework]

Sortie — Extension

## Nouveau composant : [Nom]

### Problème
[Quel besoin utilisateur ou lacune ce composant adresse]

### Motifs existants
| Composant associé | Similitude | Pourquoi ce n'est pas suffisant |
|-------------------|------------|---------------------------------|
| [Composant] | [Ce qui est partagé] | [Ce qui manque] |

### Conception proposée

#### API / Props
| Propriété | Type | Défaut | Description |
|-----------|------|--------|-------------|
| [prop] | [type] | [défaut] | [description] |

#### Variantes
| Variante | Utiliser quand | Visuel |
|----------|---------------|--------|
| [Variante] | [Scénario] | [Description] |

#### États
| État | Comportement | Notes |
|------|-------------|-------|
| Défaut | [Description] | — |
| Survol | [Description] | [Interaction] |
| Désactivé | [Description] | Non interactif |
| Chargement | [Description] | [Animation] |

#### Tokens utilisés
- Couleurs : [Quels tokens]
- Espacement : [Quels tokens]
- Typographie : [Quels tokens]

### Accessibilité
- **Rôle** : [rôle ARIA]
- **Clavier** : [interactions attendues]
- **Lecteur d'écran** : [annoncé comme…]

### Questions ouvertes
- [Décision qui nécessite une revue de design]
- [Cas limite à résoudre]

Si des connecteurs sont disponibles

Si ~~outil de design est connecté :

  • Auditez les composants directement dans Figma — vérifiez le nommage, les variantes et l'utilisation des tokens
  • Récupérez les propriétés des composants et la structure des calques pour la documentation

Si ~~base de connaissances est connectée :

  • Recherchez la documentation et les directives d'utilisation existantes des composants
  • Publiez la documentation mise à jour sur votre wiki

Conseils

  1. Commencez par un audit — Sachez où vous êtes avant de décider où aller.
  2. Documentez en construisant — Il est plus facile de documenter un composant pendant sa conception.
  3. Donnez la priorité à la couverture plutôt qu'à la perfection — 80 % des composants documentés vaut mieux que 100 % de 10 composants.

Individual skills in this repo

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

tmnhutwork/Landingpage-Photo-Retouch

Run a WCAG 2.1 AA accessibility audit on a design or page. Trigger with "audit accessibility", "check a11y", "is this accessible?", or when reviewing a design for color contrast, keyboard navigation, touch target size, or screen reader behavior before handoff.

tmnhutwork/Landingpage-Photo-Retouch

Get structured design feedback on usability, hierarchy, and consistency. Trigger with "review this design", "critique this mockup", "what do you think of this screen?", or when sharing a Figma link or screenshot for feedback at any stage from exploration to final polish.

tmnhutwork/Landingpage-Photo-Retouch

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

tmnhutwork/Landingpage-Photo-Retouch

Synthesize user research into themes, insights, and recommendations. Use when you have interview transcripts, survey results, usability test notes, support tickets, or NPS responses that need to be distilled into patterns, user segments, and prioritized next steps.

tmnhutwork/Landingpage-Photo-Retouch

Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.

tmnhutwork/Landingpage-Photo-Retouch

Write or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error message", or when naming a CTA, wording a confirmation dialog, filling an empty state, or writing onboarding text.

tmnhutwork/Landingpage-Photo-Retouch

Design banners for social media, ads, website heroes, creative assets, and print. Multiple art direction options with AI-generated visuals. Actions: design, create, generate banner. Platforms: Facebook, Twitter/X, LinkedIn, YouTube, Instagram, Google Display, website hero, print. Styles: minimalist, gradient, bold typography, photo-based, illustrated, geometric, retro, glassmorphism, 3D, neon, duotone, editorial, collage. Uses ui-ux-pro-max, frontend-design, ai-artist, ai-multimodal skills.

tmnhutwork/Landingpage-Photo-Retouch

Brand voice, visual identity, messaging frameworks, asset management, brand consistency. Activate for branded content, tone of voice, marketing assets, brand compliance, style guides.

tmnhutwork/Landingpage-Photo-Retouch

Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print), icon design (15 styles, SVG, Gemini 3.1 Pro), social photos (HTML→screenshot, multi-platform). Actions: design logo, create CIP, generate mockups, build slides, design banner, generate icon, create social photos, social media images, brand identity, design system. Platforms: Facebook, Twitter, LinkedIn, YouTube, Instagram, Pinterest, TikTok, Threads, Google Ads.

tmnhutwork/Landingpage-Photo-Retouch

Audit, document, or extend your design system. Use when checking for naming inconsistencies or hardcoded values across components, writing documentation for a component's variants, states, and accessibility notes, or designing a new pattern that fits the existing system.

tmnhutwork/Landingpage-Photo-Retouch

Translates Figma designs into production-ready application code with 1:1 visual fidelity. Use when implementing UI code from Figma files, when user mentions "implement design", "generate code", "implement component", provides Figma URLs, or asks to build components matching Figma specs. For Figma canvas writes via `use_figma`, use `figma-use`.

tmnhutwork/Landingpage-Photo-Retouch

Use the Figma MCP server to fetch design context, screenshots, variables, and assets from Figma, and to translate Figma nodes into production code. Trigger when a task involves Figma URLs, node IDs, design-to-code implementation, or Figma MCP setup and troubleshooting.

tmnhutwork/Landingpage-Photo-Retouch

Create strategic HTML presentations with Chart.js, design tokens, responsive layouts, copywriting formulas, and contextual slide strategies.

tmnhutwork/Landingpage-Photo-Retouch

Create beautiful, accessible user interfaces with shadcn/ui components (built on Radix UI + Tailwind), Tailwind CSS utility-first styling, and canvas-based visual designs. Use when building user interfaces, implementing design systems, creating responsive layouts, adding accessible components (dialogs, dropdowns, forms, tables), customizing themes and colors, implementing dark mode, generating visual designs and posters, or establishing consistent styling patterns across applications.

tmnhutwork/Landingpage-Photo-Retouch

UI/UX design intelligence for web, mobile, and desktop. This skill should be used when designing, building, reviewing, or fixing interfaces, including pages, components, design systems, accessibility, interaction, responsive layout, typography, color, charts, and stack-specific UI implementation. Searchable local data: 79 searchable styles (50 active), 192 product palettes and reasoning profiles, 74 font pairings, 119 UX guidelines, 105 icons, 17 GSAP presets, 25 chart types, and 22 stacks.

Skills associés