Aller au guide d’utilisation
Building Componentspar vercel

Building Components Skill.

Concevez des API de composants UI réutilisables en tenant compte de l’accessibilité et de la distribution.

  • API de composants
  • Accessibilité
Analyse de la source · building-componentsSKILL.md
Tâche Concevez des API de composants UI réutilisables en tenant compte de l’accessibilité et de la distribution. Livrables Pour une demande d’implémentation, un composant doté d’un modèle explicite de composition et d’état. Avant de commencer Le court fichier SKILL.md dépend des références fournies pour les instructions détaillées d’implémentation.
Synthèse éditoriale · source vérifiée le 2026-11-02 · pas un exemple généré

01 Fonctionnement

Concevez des API de composants UI réutilisables en tenant compte de l’accessibilité et de la distribution

Planifiez des API de composants accessibles, état contrôlé, styles, tokens et distribution avec le skill Building Components de Vercel.

Flux de travail fondé sur la sourcePas un benchmark d'exécution

La méthode de travail

Building Components guide les décisions techniques d’une bibliothèque UI réutilisable. Il dirige l’agent vers des références ciblées sur la composition, le clavier, la gestion d’état, les interfaces TypeScript et les styles. Le point d’entrée couvre primitives, composants, blocs et modèles afin d’adapter le niveau d’abstraction au livrable réel.

Ce skill convient à un composant destiné à plusieurs consommateurs plutôt qu’à un écran isolé. Il réunit conception d’API, accessibilité et distribution. La source est surtout un index de références : les fichiers liés font partie du skill utilisable et doivent accompagner le fichier d’entrée.

Livrables attendus

  • Pour une demande d’implémentation, un composant doté d’un modèle explicite de composition et d’état.
  • Pour une demande documentaire, un guide d’utilisation couvrant l’API du composant et les comportements pertinents.
  • Un plan adapté de packaging ou de registre lorsque la distribution fait partie de la demande.
Voir l'exemple de brief

Du brief à la revue

  1. 01
    Définir le contrat du composant

    Déterminez si la tâche concerne une primitive, un composant, un bloc ou un modèle. Établissez son interface publique et les contextes dans lesquels les appelants le composeront.

  2. 02
    Lire les références techniques pertinentes

    Consultez state.mdx pour l’état contrôlé ou non contrôlé, composition.mdx pour le modèle de composition public et accessibility.mdx pour le clavier et le focus. Utilisez types.mdx et styling.mdx pour l’implémentation. Ajoutez les références de polymorphisme ou d’as-child uniquement si les appelants ont besoin de ces formes d’API.

  3. 03
    Implémenter et documenter l’interface

    Reliez état et présentation par l’API choisie. Expliquez l’usage prévu et ne choisissez npm, un registre ou un autre canal documenté que si nécessaire.

02 Cas d’usage

Quand l’utiliser

Le court fichier SKILL.md dépend des références fournies pour les instructions détaillées d’implémentation.

Un bon choix

  • API de composants partagésUn composant partagé nécessite une API publique réfléchie avant son adoption par plusieurs équipes.
  • Ingénierie de bibliothèqueUne bibliothèque UI requiert des pratiques cohérentes d’accessibilité, de thèmes et de documentation.

Limites à vérifier

  • Références fourniesLe court fichier SKILL.md dépend des références fournies pour les instructions détaillées d’implémentation.
  • Portée de la vérificationLe fichier d’entrée ne certifie pas l’accessibilité d’un composant et ne garantit pas la compatibilité avec tous les frameworks.

Éléments à fournir

  • Consommateurs prévusLes consommateurs visés par le composant et des exemples d’utilisation.
  • Conventions du dépôtLa pile de composants, le système de tokens et les conventions TypeScript du dépôt.
  • Comportement et distributionLe comportement clavier requis, la responsabilité de l’état et la cible de distribution.

03 Décisions importantes

Les choix importants

  1. Responsabilité de l’état explicite

    L’état contrôlé ou non contrôlé devient un choix d’API délibéré.

  2. Choix de composition

    Les références couvrent slots, render props et as-child pour composer une API publique de composant.

  3. Planifier la distribution

    Publication et documentation sont considérées avec l’implémentation.

04 Exemple de brief

Essayez un brief ciblé

L'exemple de brief ci-dessous n'a pas été testé. Vérifiez la configuration du skill avant de l'utiliser.

Examiner la source et la configuration

Les consommateurs visés par le composant et des exemples d’utilisation.

Fichier source amont
https://github.com/vercel/components.build/blob/ba727450437385af662810329fa19896215f76d5/skills/building-components/SKILL.md

La référence ci-dessous ouvre les instructions d’origine. Vérifiez la configuration du dépôt avant de les utiliser ; ce n’est pas une commande d’installation.

Commencer par un seul livrable

Adaptez le périmètre, les sources et les contraintes de ce brief avant d’exécuter le skill.

Exemple de brief
Utilise building-components pour concevoir un composant dépliable réutilisable dans notre bibliothèque React. Examine d’abord nos primitives, tokens et modèles TypeScript existants. Propose l’API publique, avec état contrôlé et non contrôlé, avant l’implémentation. Lis les références pertinentes de composition, accessibilité et état. Couvre les interactions clavier et le focus, donne des exemples de composition du déclencheur et du contenu, et documente les styles via nos tokens existants. Garde la publication sur un registre ou npm comme proposition distincte, sauf si la tâche actuelle inclut explicitement une livraison.

Vérifier le résultat

Comparez le résultat réel à ces critères observables.

  • Les exemples utilisent l’API publique documentée plutôt que les éléments internes privés.
  • Les comportements de clavier, focus et état disposent de résultats de vérification explicites.
  • Les instructions de packaging correspondent au canal de distribution prévu.

OpenDesign fournit un espace de travail de design local pour les agents de code. Cette fiche ne signifie pas que le skill est fourni avec ses outils externes, ses identifiants et ses dépendances logicielles.

05 Source et licence

Source et licence

Cette page décrit la révision source figée liée ci-dessous. Le comportement et les exigences en amont peuvent changer.

Propriétaire de la source
vercel
Fichier du skill
SKILL.md
Version examinée
2026-11-02 · ba7274504373

Notes de lecture

  1. Portée de la licenceLes déclarations amont se contredisent dans la même révision figée : le fichier LICENSE racine indique explicitement Apache License 2.0, tandis que la section License de README.md annonce MIT et renvoie à ce fichier. Aucune dérogation locale n’existe sous skills/building-components. N’affichez pas une étiquette MIT sans réserve ; une clarification amont est nécessaire pour résoudre le conflit.
Résumé éditorial de la source
Concevez des API de composants UI réutilisables en tenant compte de l’accessibilité et de la distribution.

Résumé original de OpenDesign, fondé sur la source liée. Les étoiles du dépôt sont un indicateur de popularité daté, pas une mesure d'utilisation du skill ni une note de qualité.

06 Questions avant de commencer

Questions avant de commencer

Ce skill fournit-il un thème visuel prêt à l’emploi ?

Son point d’entrée traite de l’ingénierie des composants et renvoie aux références sur les tokens et les styles. Le produit doit toujours fournir ses exigences visuelles.

Chaque composant doit-il être polymorphe ?

Non. Le polymorphisme et as-child sont des références disponibles à sélectionner lorsque l’API en a besoin.

Peut-il aider à distribuer via un registre ?

Oui. Distribution par registre, publication npm et places de marché de composants disposent chacune d’une référence dédiée.

OpenDesign

Gardez votre brief et votre travail de design au même endroit.

Gardez votre brief, vos sources et votre travail de design ensemble dans un espace de travail local. Vérifiez la configuration propre au skill avant de l'ajouter à votre flux de travail.

Fichier source amont
https://github.com/vercel/components.build/blob/ba727450437385af662810329fa19896215f76d5/skills/building-components/SKILL.md