Communitygithub.com

Cozythecoder/frontend-design-md

Détectez automatiquement le type de projet, analysez l'intention et appliquez le système de conception optimal parmi plus de 60 modèles de référence.

Qu'est-ce que frontend-design-md ?

Cette compétence fournit à un agent IA la capacité d'analyser un projet web, de détecter automatiquement sa catégorie (SaaS, tableau de bord, e-commerce, portfolio, etc.) et d'appliquer un système de conception pertinent parmi une bibliothèque de plus de 60 modèles de référence (Linear, Vercel, Apple, etc.). Elle effectue une analyse en quatre phases : détection automatique du projet, analyse des actifs existants (couleurs, typographie, espacements), application adaptative du système de conception, puis validation de la qualité (contraste, accessibilité, performance). L'outil est conçu pour être utilisé avec des agents comme Claude Code ou Cursor, et fonctionne en inspectant les fichiers du projet, en calculant un score de confiance avant de suggérer un système, et en adaptant les tokens de conception pour une intégration harmonieuse. Les scripts d'analyse inclus automatisent l'inspection du projet, la correspondance avec la bibliothèque, la validation et l'adaptation.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Cozythecoder/frontend-design-md/tree/HEAD/skills/design-systems

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 Intelligence Système de Conception

Détectez automatiquement le type de projet, analysez l'intention et appliquez le système de conception optimal parmi plus de 60 modèles de référence.

Déclencheurs de Détection Automatique

Cette compétence s'active lorsque :

  • L'utilisateur crée/modifie un fichier de projet web (HTML, CSS, JS, JSX, Vue, Svelte)
  • L'utilisateur dit "conçois ça", "rends-le beau", "améliore l'UI", "applique un système de conception"
  • L'utilisateur mentionne des catégories spécifiques : "page d'accueil", "tableau de bord", "portfolio", "e-commerce"
  • Aucun système de conception explicite n'est spécifié dans le projet

Phase 1 : Analyse du Projet (Automatique)

EXÉCUTEZ TOUJOURS l'analyse avant de sélectionner un système de conception.

Étape 1 : Détecter la Catégorie du Projet

Analysez les fichiers du projet pour déterminer le type :

# Vérifier les indicateurs
detections = {
    'saas-landing': ['pricing', 'signup', 'features', 'hero', 'testimonials'],
    'dashboard-app': ['dashboard', 'chart', 'table', 'sidebar', 'widget'],
    'e-commerce': ['product', 'cart', 'checkout', 'shop', 'inventory'],
    'portfolio': ['portfolio', 'gallery', 'project', 'creative', 'art'],
    'content-publication': ['blog', 'article', 'post', 'content', 'newsletter'],
    'brand-showcase': ['brand', 'story', 'about', 'mission', 'values'],
    'developer-tool': ['api', 'docs', 'code', 'terminal', 'github'],
    'service-business': ['service', 'contact', 'process', 'team', 'consulting']
}

Étape 2 : Analyser l'État Actuel

Vérifiez les tokens de conception existants :

  • Couleurs dans la configuration CSS/SCSS/Tailwind
  • Typographie (déclarations font-family, font-size)
  • Espacement (motifs margin, padding, gap)
  • Composants (classes de boutons, classes de cartes)

Étape 3 : Correspondance avec la Bibliothèque de Systèmes de Conception

Comparez avec plus de 60 modèles de référence :

Type de ProjetSystèmes de Conception Recommandés
Page d'accueil SaaSlinear.app, vercel.com, supabase.com, stripe.com, notion.so
Application/Tableau de bordlinear.app (UI), github.com, vercel.com/dashboard, supabase.com/dashboard
E-commerceapple.com, shopify.com, nike.com
Portfolioframer.com, webflow.com, cargo.site
Contenu/Blogmedium.com, substack.com, stripe.com/blog
Outil Développeurvercel.com, github.com, docs.rs, nextjs.org
Entreprise de Servicescursor.com, intercom.com, webflow.com
Marque/Agencetesla.com, apple.com, nike.com

Étape 4 : Score de Confiance

Calculez la confiance de correspondance :

confiance = (
  correspondance_catégorie * 0.40 +      # Le contenu correspond-il ?
  similarité_tokens * 0.30 +            # Chevauchement couleur/typographie ?
  motifs_composants * 0.20 +            # Motifs boutons/cartes ?
  structure_disposition * 0.10          # Motifs grille/flex ?
)

Si confiance > 0.75 : Suggérer automatiquement la meilleure correspondance
Si 0.50-0.75 : Proposer 2-3 alternatives
Si < 0.50 : Demander la préférence de catégorie à l'utilisateur

Phase 2 : Protocole Pré-Vol

Liste de Vérification d'Inspection des Actifs

AVANT d'appliquer un système de conception :

  1. Vérifier project-context.md

    • Existe-t-il à la racine du projet ?
    • Si non : Créer à partir du modèle avec le nom du projet, l'objectif, le public
  2. Analyser les Actifs Actuels

    # Exécuté automatiquement
    python3 ~/.claude/skills/design-systems/scripts/inspect-project.py
    

    Vérifications :

    • Logo existe ? (SVG de préférence)
    • Images produit ? (PNG transparents pour héros ?)
    • Schéma de couleurs déjà défini ?
    • Typographie déjà définie ?
    • Bibliothèque de composants existante ?
  3. Déterminer la Hiérarchie de Composition

    • Élément Hero : Visuel le plus grand (photo produit, illustration, titre)
    • Éléments de support : Fonctionnalités, avantages, preuve sociale
    • Accents : Éléments décoratifs, motifs
  4. Valider les Contraintes Techniques

    • Framework détecté (React, Vue, vanilla, etc.)
    • Approche CSS (Tailwind, CSS-in-JS, SCSS, etc.)
    • Capacité d'animation (GSAP chargé ? Framer Motion ?)
    • Budget performance (mobile-first ? desktop ?)

Phase 3 : Application du Système de Conception

Étape 1 : Sélectionner et Charger

Sur base de l'analyse, charger le DESIGN.md recommandé :

Recommandé : Système de conception Linear.app
Confiance : 87%

Raisons de correspondance :
- Page d'accueil SaaS détectée (sections tarifs, fonctionnalités)
- Préférence mode sombre détectée
- Typographie propre (Inter-like) trouvée
- Motifs de mise en page basés sur des cartes présents

Étape 2 : Adapter au Projet

NE COPIEZ PAS-COLLEZ brut. Adaptez en fonction de l'analyse du projet :

Couleurs :

  • Si le projet a des couleurs de marque : Map aux rôles du système de conception
  • Si pas de couleurs : Utiliser directement la palette du système de conception
  • Exemple : "Votre bleu #3B82F6 → Rôle Accent Principal"

Typographie :

  • Si utilisation d'Inter/Système : Conserver l'échelle du système de conception
  • Si utilisation d'une police différente : Adapter les tailles/poids
  • Exemple : "Roboto au lieu d'Inter → Ajuster les poids 400→500"

Espacement :

  • Vérifier l'échelle d'espacement existante
  • Mapper au système de conception ou conserver si cohérent

Composants :

  • Mapper les classes existantes aux motifs du système de conception
  • Exemple : "Votre .btn-primary → Bouton Principal du système de conception"

Étape 3 : Liste de Vérification d'Implémentation

Appliquer le système de conception par ordre de priorité :

  1. Fondations (Critique)

    • Variables CSS couleur mappées
    • Échelle de typographie définie
    • Système d'espacement établi
    • Réinitialisation/normalisation de base appliquée
  2. Mise en Page (Haute)

    • Espacement des sections (hero, contenu, pied de page)
    • Largeurs de conteneur (max-width, padding)
    • Système de grille (si applicable)
  3. Composants (Moyenne)

    • Boutons (principal, secondaire, fantôme)
    • Cartes (si utilisées)
    • Formulaires/saisies (si utilisés)
    • Navigation (en-tête, pied de page)
  4. Polissage (Faible)

    • Ombres/altitude
    • Cohérence du rayon de bordure
    • États de focus
    • Transitions au survol

Phase 4 : Validation

Portes de Qualité

Exécuter après application :

Vérification de Cohérence Visuelle :

# Vérifier les violations
violations = []

# 1. Comptage de couleurs
if couleurs_uniques > 8 :
    violations.append("Trop de couleurs - simplifier la palette")

# 2. Échelle de typographie
if tailles_police > 12 :
    violations.append("Typographie non systématique - consolider les tailles")

# 3. Cohérence d'espacement
if base_espacement not in [4, 8, 16] :
    violations.append("Espacement ne suit pas la grille 4/8px")

# 4. Cibles tactiles
if cibles_tactiles < 44 :
    violations.append("Cibles tactiles en dessous de 44px")

Vérification d'Accessibilité :

  • Contraste de couleur >= 4.5:1 pour le texte
  • Indicateurs de focus visibles
  • Mouvement réduit respecté
  • Étiquettes ARIA si nécessaire

Vérification de Performance :

  • Aucune animation provoquant des sauts de mise en page
  • Images optimisées
  • Polices sous-ensembles (si personnalisées)

Références

Analyse de Système de Conception

Guides d'Adaptation

Validation

Modèles Spécifiques aux Catégories

Scripts

  • scripts/analyze-project.py — Détecter la catégorie, les tokens actuels
  • scripts/match-design-system.py — Comparer avec la bibliothèque
  • scripts/validate-application.py — Portes de qualité
  • scripts/generate-adaptation.py — Mapper l'existant au système de conception
  • scripts/inspect-assets.py — Vérifier images, logos, actifs de marque

Bibliothèque de Systèmes de Conception

60+ systèmes organisés par catégorie dans ../design-systems/ :

SaaS / Outils Développeur

  • linear.app (sombre, Inter, poids 510)
  • vercel.com (Geist, ombre-bordure)
  • supabase.com (chaleureux, inspiré postgres)
  • stripe.com (riche en contenu, dégradés)
  • notion.so (convivial, arrondi)
  • github.com (fonctionnel, dense)
  • cursor.com (axé éditeur, couleurs syntaxe)

E-commerce / Produit

  • apple.com (SF Pro, contraste binaire, CTA en pilule)
  • shopify.com (polarisé, tokens Polaris)
  • nike.com (audacieux, dynamique, axé image)

Créatif / Portfolio

  • framer.com (ludique, dégradés, rebondissant)
  • webflow.com (professionnel, structuré)

Contenu / Publication

  • medium.com (axé lecture, police serif pour le corps)
  • substack.com (chaleureux, centré newsletter)

Entreprise

  • ibm.com (Carbon design, systématique)
  • salesforce.com (fonctionnel, dense)

Automobile / Luxe

  • tesla.com (minimal, centré produit)
  • ferrari.com (dramatique, accent rouge)
  • bmw.com (technique, précis)

Flux d'Utilisation

Utilisateur : "Construis une page d'accueil pour mon SaaS"
↓
Compétence : Analyse le projet...
       Détecte : Intention page d'accueil SaaS
       État actuel : Aucun système de conception
↓
Compétence : Recommande linear.app (confiance 87%)
       Propose alternatives : vercel.com, stripe.com
↓
Utilisateur : "Utilise le style Linear"
↓
Compétence : Lance le protocole pré-vol
       - Crée project-context.md
       - Analyse les actifs
       - Vérifie la pile technique
↓
Compétence : Applique le système de conception Linear
       - Mappe les tokens de couleur
       - Définit l'échelle de typographie
       - Implémente les composants
↓
Compétence : Valide la sortie
       - Vérification de contraste couleur
       - Cohérence d'espacement
       - Revue des portes de qualité
↓
Sortie : Projet avec un design inspiré de Linear

Configuration

Remplacez la détection automatique en créant .design-system à la racine du projet :

{
  "system": "linear.app",
  "theme": "dark",
  "adaptations": {
    "primaryColor": "#3B82F6",
    "fontFamily": "Inter"
  }
}

Cette compétence fusionne votre collection de 60+ systèmes de conception avec un workflow de style épique : auto-détection, vérifications pré-vol, validation et adaptation intelligente.

Skills associés