de agent-skills12,553
Guide la conception d'API et d'interfaces stables et prévisibles — modèles contract-first, sémantique d'erreur, pagination et conventions de nommage pour des intégrations robustes.
Conseils pratiques pour concevoir des API stables et bien documentées ainsi que des interfaces de composants. Il codifie les principes (loi de Hyrum, règle d'une seule version), la conception contract-first, une sémantique d'erreur cohérente, la validation aux frontières et les modèles de pagination/nommage afin que les ingénieurs créent des API difficiles à utiliser incorrectement.
À utiliser lors de la création de nouveaux points de terminaison REST/GraphQL, de la définition des limites de modules, de la modification d'interfaces publiques ou de l'établissement de contrats d'API entre les équipes. Utile lors des revues de conception d'API, des décisions de schéma et de la planification des dépréciations.
Recommandé pour les agents de codage/conception qui rédigent des API ou du code (assistants de type Copilot/Codex/GitHub Copilot, Claude Code, Cursor). Utile pour les agents qui génèrent ou révisent du code d'API et de la documentation.
Une compétence de référence bien conçue couvrant les principes de conception d'API et d'interface — modèles contract-first, sémantique d'erreur, pagination, conventions de nommage et modèles TypeScript. Aucun script ; contenu purement instructif avec d'excellents exemples de code et une liste de vérification claire. Couverture approfondie de la loi de Hyrum, des unions discriminées, des types brandés et des rationalisations courantes.
Aucun script à tester — analyse statique uniquement. Le fichier SKILL.md est complet et bien structuré. Pourrait bénéficier d'un répertoire references/ pour des liens de lecture approfondie. Le frontmatter est propre et complet.
