web-design-guidelines
Un skill qui relit ton code d'interface et signale les écarts ligne par ligne.
EN UN COUP D’ŒIL
- Relire avant de livrer
- Trier erreurs et conventions
- Savoir où tester
- Ajouter
- Cadrer
- Lire le rapport
- 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.
Alternatives sur le site
D’autres façons de régler le même problème, et quand les préférer.
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.
Comment je m'en sers ?
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-skillsDemande 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.Chaque ligne donne un emplacement et le problème. Relis le code concerné avant de corriger.
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é.