W

web-design-guidelines

Un skill qui relit ton code d'interface et signale les écarts ligne par ligne.

Skill· Vercel Labs· Licence MITComment démarrer ↓

EN UN COUP D’ŒIL

Ça sert à
  • Relire avant de livrer
  • Trier erreurs et conventions
  • Savoir où tester
Pour démarrer
  1. Ajouter
  2. Cadrer
  3. Lire le rapport
  4. Vérifier

C'est quoi ?

web-design-guidelines est un skill de Vercel Labs qui relit le code d'une interface et signale les écarts avec les Web Interface Guidelines, un référentiel de règles publié par Vercel Labs. L'agent récupère les règles à jour, lit les fichiers que tu indiques, puis restitue ses constats au format file:line, regroupés par fichier.

Deux dépôts se partagent le travail : web-interface-guidelines contient les règles, agent-skills distribue le skill qui va les chercher. La relecture est faite par ton agent de code (claude-code par exemple), pas par un programme qui analyserait la page dans un navigateur.

À quoi ça sert ?

Relire avant de livrer

Les règles visent par exemple les champs sans libellé, les boutons-icônes sans aria-label, les images sans dimensions ou les animations qui ignorent prefers-reduced-motion. Le rapport te renvoie au fichier et à la ligne, ce qui se corrige plus vite qu'un avis général sur l'accessibilité.

Trier erreurs et conventions

Le référentiel mélange accessibilité, focus, formulaires, animation, typographie, performance et thème sombre. Un bouton sans nom accessible et une préférence typographique n'ont pas le même poids : classe les constats par impact avant de demander des corrections.

Savoir où tester

Un focus manquant indique où parcourir la page au clavier, une image sans dimensions où regarder les décalages au chargement. La revue montre où chercher ; elle ne remplace pas ces essais.

Pourquoi ?

Pour un seul composant, une checklist à la main suffit. Le skill devient utile quand les points de contrôle sont nombreux et dispersés dans plusieurs fichiers. Face à un linter, qui applique une règle codée à l'identique, la revue par agent lit plus largement mais peut varier d'un passage à l'autre et se tromper : les deux se complètent. Pour guider l'agent pendant qu'il construit l'interface, regarde impeccable.

Les règles sont récupérées à chaque revue et le référentiel évolue : note leur date, ou leur commit, pour comparer deux rapports. Certaines dépendent du framework, par exemple React ou Next.js : relis le composant avant de corriger. Ce sont des règles maintenues par Vercel Labs, pas une norme d'accessibilité ni une certification, et la lecture du code ne mesure ni la performance réelle ni un vrai parcours.

Comment je m'en sers ?

  1. Ajouter

    Depuis la racine de ton projet, lance l'installateur de skills, retiens web-design-guidelines parmi ceux proposés et vérifie ce qui sera ajouté avant de valider.

    npx skills add vercel-labs/agent-skills
  2. Cadrer

    Demande une revue de ton interface en donnant un fichier ou un motif, par exemple src/components/Form.tsx. Sans périmètre, le skill te demande lesquels relire.

  3. Lire le rapport

    Chaque ligne donne un emplacement et le problème. Relis le code concerné avant de corriger.

  4. Vérifier

    Regarde le diff, lance les contrôles du projet et reteste les interactions touchées au clavier et à la souris. Une liste vide ne prouve pas la conformité.

Recevoir la newsletter

Des tutos, des essais et des retours bruts sur ce que je construis. Le lien pour te désabonner est en bas de chaque édition.

L’inscription se termine sur Substack, dans un nouvel onglet.