Communitygithub.com

kumaran-is/claude-code-onboarding

Audite le code UI par rapport aux Directives d'Interface Web de Vercel — récupère les règles en direct, lit les fichiers spécifiés et produit des violations formatées fichier:ligne. À utiliser pour examiner l'interface, vérifier l'accessibilité, auditer le design, revoir l'UX ou valider un composant. Complète /lint-design-system (tokens) et accessibility-auditor (WCAG) avec la conformité aux motifs d'interaction web.

Qu'est-ce que claude-code-onboarding ?

Cette compétence audite automatiquement le code UI (par exemple Angular, React, Vue) par rapport aux Directives d'Interface Web de Vercel, garantissant que les composants respectent les motifs d'interaction web modernes comme les états de chargement, les états vides, la gestion des erreurs et le focus. Elle récupère d'abord les règles les plus récentes depuis une URL source distante via WebFetch, lit les fichiers spécifiés par l'utilisateur, puis applique chaque règle pour signaler les violations dans un format structuré fichier:ligne. Cette approche évite tout biais de mémoire ou règles obsolètes, rendant chaque revue fraîche et alignée sur les dernières directives. Conçue pour être le troisième niveau d'une pile de revue UI complète, elle fait suite à des outils de vérification des tokens de design et d'accessibilité WCAG pour couvrir les motifs d'interaction web. En cas d'échec de récupération, elle ne procède pas avec des règles supposées mais signale l'erreur, garantissant ainsi une fiabilité et une intégrité maximales du processus de revue.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kumaran-is/claude-code-onboarding/tree/HEAD/.claude/skills/web-design-guidelines

Demander à votre IA préférée

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

Documentation

Loi Fondamentale

RÉCUPÉREZ LES DIRECTIVES EN DIRECT AVANT D'EXAMINER TOUT FICHIER. N'appliquez jamais de règles mémorisées ou supposées — récupérez toujours les règles fraîches depuis l'URL source. Si WebFetch échoue, signalez l'échec et ne procédez pas avec des règles devinées.

Revue des Directives d'Interface Web

Audite le code UI par rapport aux Directives d'Interface Web de Vercel. Produit des résultats structurés fichier:ligne.

Quand Utiliser Cette Compétence

Chargez cette compétence lorsque l'utilisateur demande :

  • « Examine mon interface »
  • « Vérifie l'accessibilité »
  • « Audite le design »
  • « Revise l'expérience utilisateur »
  • « Vérifie mon site/composant par rapport aux directives »
  • Lancer une vérification de conformité design avant une PR

Comment Ça Fonctionne

  1. Récupérer les directives — obtenir les dernières règles depuis l'URL source via WebFetch
  2. Lire les fichiers — lire les fichiers spécifiés (ou demander à l'utilisateur quels fichiers/motif examiner)
  3. Appliquer les règles — vérifier tous les fichiers par rapport à chaque règle des directives récupérées
  4. Produire les résultats — signaler les violations au format fichier:ligne: [règle violée]

Source des Directives

Récupérez les directives fraîches avant chaque session de revue :

https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md

Utilisez WebFetch pour obtenir les dernières règles. Le contenu récupéré contient toutes les règles et les instructions de format de sortie. Ne mettez pas en cache et ne mémorisez pas les règles entre les sessions — récupérez toujours des règles fraîches.

Utilisation

Lorsque l'utilisateur fournit des fichiers ou un motif de chemin :

  1. Récupérer les directives depuis l'URL source
  2. Lire les fichiers spécifiés
  3. Appliquer toutes les règles des directives récupérées
  4. Produire les résultats en utilisant le format spécifié dans les directives

Lorsqu'aucun fichier n'est spécifié :

Demandez à l'utilisateur : « Quels fichiers ou répertoires dois-je examiner ? (par ex. src/app/features/dashboard/ ou *.component.html) »

Format de sortie

Suivez exactement le format spécifié dans les directives récupérées. Structure par défaut :

fichier:ligne — [Nom de la règle]: [Description de la violation]

Exemple :

dashboard.component.html:34 — État Vide : Aucun état vide défini pour la condition de données nulles
dashboard.component.html:67 — Gestion du Focus : L'élément interactif manque d'indicateur de focus visible
order-list.component.ts:89 — État de Chargement : L'opération asynchrone n'a pas de retour de chargement

Gestion des Échecs

Si WebFetch échoue à récupérer l'URL des directives :

  1. Signaler : « Impossible de récupérer les Directives d'Interface Web depuis l'URL source. Échec de récupération : [erreur] »
  2. Ne PAS procéder avec des règles devinées ou mémorisées
  3. Suggérer : « Réessayez, ou vérifiez l'accès réseau à raw.githubusercontent.com »

N'inventez jamais de résultats de règle si la récupération échoue.

Comment Cela S'intègre à la Pile de Revue

Cette compétence est le troisième niveau de revue UI — exécutez les trois pour une couverture complète :

NiveauOutilCe qu'il détecte
Niveau 1 — Tokens de design/lint-design-systemCouleurs codées en dur, espacements bruts, typographie inline, violations de taille de zone tactile
Niveau 2 — Accessibilité WCAGaccessibility-auditor agentRapports de contraste, labels ARIA, navigation clavier, HTML sémantique
Niveau 3 — Motifs d'interface webweb-design-guidelines (cette compétence)États de chargement, états vides, gestion des erreurs, motifs d'interaction, gestion du focus

Compétences Associées

  • frontend-design — exécuter AVANT cette compétence pour établir la direction esthétique et le score DFII
  • design-system — application de la conformité des tokens (Angular + Flutter)
  • angular-ui-patterns — doctrine spécifique Angular pour les états de chargement/erreur/vide
  • accessibility-audit — auditeur de conformité WCAG 2.1 AA

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés