API and Interface Design
Concevoir des interfaces stables et bien documentées, difficiles à mal utiliser — loi de Hyrum, contrat d'abord, règle de la version unique
- Quoi
- Concevoir des interfaces stables et bien documentées, difficiles à mal utiliser — loi de Hyrum, contrat d'abord, règle de la version unique
- Coût
- Gratuit
- Prérequis
- aucun — une interface publique à concevoir ou réviser
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — un skill de conception d'interfaces issu de la collection de workflows d'ingénierie d'Addy Osmani : rendre la bonne chose facile et la mauvaise difficile. Il parcourt la loi de Hyrum (tout comportement observable devient un contrat de facto), la règle de la version unique (étendre plutôt que forker), la conception contrat d'abord (définir l'interface avant de l'implémenter), et la planification de la dépréciation dès la conception. S'applique aux API REST, schémas GraphQL, frontières de modules, props de composants — toute surface où un morceau de code parle à un autre. Distinct des skills addyosmani déjà publiés — aucun ne couvre la conception de surfaces d'API. Crédit : @addyosmani. Bémols honnêtes : guidance de conception uniquement — il ne générera pas votre spec OpenAPI ; le suivre veut dire dire non à « expose juste ce petit champ interne », ce qui est tout l'intérêt et aussi la partie difficile. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage.
Version :
Installation
Prérequis : aucun — une interface publique à concevoir ou réviser Installe-moi « Conception d'API et d'interfaces ». Concevoir des interfaces stables et bien documentées, difficiles à mal utiliser — loi de Hyrum, contrat d'abord, règle de la version unique Dépôt : https://github.com/addyosmani/agent-skills/blob/main/skills/api-and-interface-design/SKILL.md 1. Récupère le fichier SKILL.md du skill addyosmani-api-and-interface-design depuis le dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Contrôle de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, récolte d'identifiants). Ce dépôt ne doit contenir aucun secret dans le code ; les identifiants passent uniquement par le coffre sécurisé, les hôtes autorisés sont déclarés dans le SKILL.md. Vérifie que c'est bien le cas ; STOP sur le moindre signal d'alerte et préviens-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers auxiliaires dans le répertoire des skills de l'agent, dans un dossier nommé « addyosmani-api-and-interface-design ». 4. Vérifie sans appels réseau : frontmatter valide, fichiers en place. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (ex. tout compte, clé API ou outil CLI mentionné dans les prérequis ci-dessus). GitHub est optionnel : si j'ai un compte GitHub ou le CLI gh, tu peux l'utiliser ; sinon, l'accès public suffit. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Ne me demande jamais de coller des secrets dans le chat ; les identifiants passent par le coffre sécurisé ou des variables d'environnement. Si quelque chose semble anormal, arrête-toi et demande-moi.
Questions
Comment installer une création ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe la création pour vous — sans configuration manuelle.
Où va mon argent ?
Directement au vendeur. Skill Harbor ne traite jamais les paiements : le paiement se fait sur la page du vendeur, généralement via Stripe.
Que signifie le ✓ à côté du nom d’un créateur ?
Il signifie que nous avons confirmé l’identité de la personne derrière la fiche. Il ne dit rien sur le code lui-même — vérifiez toujours une création avant de l’installer.