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 :
Réponse rapide
API and Interface Design est un skill gratuit pour Muse qui vous aide à concevoir des interfaces stables et bien documentées, difficiles à mal utiliser, avec la loi de Hyrum, le contrat d'abord et la règle de la version unique, pour que la surface livrée reste compréhensible, fiable et sûre à faire évoluer sans casser chaque appelant.
Installation
Copiez le dossier d’installation ci-dessous, puis collez-le dans Muse🧪 Installation exécutée dans notre sandbox de test · 11 nov. 2026📌 Version épinglée : commit 1401c8bÉtape 0 — avant d'installer quoi que ce soit : lis ce prompt d'installation, résume en quelques lignes ce que ce build fait et ce que l'installation implique, puis demande-moi de confirmer avant de continuer. 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://raw.githubusercontent.com/addyosmani/agent-skills/1401c8b8030e023baeebb31781a6653fe8e93026/skills/api-and-interface-design/SKILL.md Version épinglée : installe le code au commit 1401c8b8030e023baeebb31781a6653fe8e93026 exactement (Skill Harbor a testé cette version). Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Récupère le fichier SKILL.md du skill addyosmani-api-and-interface-design depuis le dépôt dans un dossier temporaire 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.
Enregistré dans vos installs récentes. Retrouvez-le à tout moment sur /connect.
🔒 Sécurité, provenance et ce que ça touche
Le prompt d'installation ci-dessous inclut déjà les étapes de vérification : votre agent suit la checklist communautaire avant d'installer tout ce qui contient du code exécutable. Vous en voulez plus ?
Certificat de vérification
Faits datés sur ce qui a été vérifié pour cette fiche, et comment. Ce n’est pas une certification de sécurité.
- Version épinglée
- 1401c8b · 2026-10-13
- Test d’installation en sandbox
- Installation exécutée dans notre sandbox de test · 11 nov. 2026
- Identité du créateur
- Non vérifiée
- Veille d’empreinte
- Dernière vérification · 19 nov. 2026 : aucun changement détecté dans les fichiers liés par ce prompt d’installation
- Analyse du prompt d’installation
- 2026-10-13 : Aucune commande, appel réseau, paquet, écriture de fichier ni clé API détecté.
Skill Harbor ne révise jamais le code des skills listés. Ce sont des faits datés sur le prompt d’installation et notre test d’installation, pas une certification de sécurité. Révisez un skill vous-même avant de l’installer. Comment nous vérifions
Questions
Comment installer un skill ?
Chaque fiche produit contient un prompt d’installation à copier-coller. Collez-le dans votre Muse et il installe le skill 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 un skill avant de l’installer.