Build reliable Claude skills: SKILL.md structure, triggers, validation
Créer, structurer et améliorer des skills Claude — conception de la description comme déclencheur, nommage kebab-case, règles de frontmatter, gabarit Instructions → Exemples → Dépannage, scripts de validation et tests de déclenchement
- Quoi
- Créer, structurer et améliorer des skills Claude — conception de la description comme déclencheur, nommage kebab-case, règles de frontmatter, gabarit Instructions → Exemples → Dépannage, scripts de validation et tests de déclenchement
- Coût
- Gratuit
- Prérequis
- aucun — le skill est un guide pour créer des skills Claude, pas un logiciel à installer
- Installation
- Copiez le prompt d’installation ci-dessous dans votre Muse — votre agent fait le reste.
Sélectionné par Skill Harbor — le guide de @dboeckli pour créer, structurer et améliorer des skills Claude : un workflow en 7 étapes. Étape 1, identifier la catégorie de cas d'usage — Document & Asset Creation, Workflow Automation ou MCP Enhancement — et définir d'abord 2–3 cas d'usage concrets. Étape 2, créer le dossier kebab-case avec exactement `SKILL.md` dedans. Étape 3, écrire la description — la partie la plus critique — avec CE qu'il fait ET QUAND l'utiliser (phrases de déclenchement précises que les utilisateurs disent vraiment, moins de 1024 caractères, pas de balises XML). Étape 4, écrire les instructions du corps selon le gabarit : `## Instructions` → étapes numérotées → `## Examples` → `## Troubleshooting`, spécifique et actionnable, détails dans `references/`, SKILL.md sous 5 000 mots. Étape 5, mettre à jour les tables de skills dans CLAUDE.md et README.md. Étape 6, lancer le `validate-skills.sh` fourni (corriger chaque FAIL ; vérifier scalaires du frontmatter, indentation, caractères interdits). Étape 7, tester le déclenchement avec 10–20 requêtes (cible ~90 % sur les requêtes pertinentes, jamais sur les autres) et itérer sur les signaux — sous-déclenchement → ajouter des phrases ; sur-déclenchement → ajouter des déclencheurs négatifs ; instructions ignorées → remonter les étapes critiques en haut. Inclut les principes de design (divulgation progressive, composabilité, portabilité), cinq patterns de workflow, une table de dépannage (échec d'upload, sous/sur-déclenchement, instructions ignorées, contexte gonflé), et une checklist rapide. Bémols honnêtes : méthodologie seulement — quelques étapes sont spécifiques au repo de l'auteur (colonne README en allemand, vérification distante `npx skills`) ; les ignorer ou les adapter pour vos propres projets. Licence MIT. Skill Harbor ne vérifie jamais le code, examinez-le vous-même avant usage. Découvert via skills.sh.
Version :
Installation
Prérequis : aucun — le skill est un guide pour créer des skills Claude, pas un logiciel à installer Installe-moi « Créer des skills Claude fiables : structure SKILL.md, déclencheurs, validation ». Il enseigne à mon agent le guide de création de skills de @dboeckli : choisir une catégorie de cas d'usage (Document & Asset Creation, Workflow Automation, MCP Enhancement) ; créer le dossier kebab-case avec exactement SKILL.md ; écrire la description comme QUOI + QUAND avec de vraies phrases de déclenchement (moins de 1024 caractères) ; suivre le gabarit Instructions → Exemples → Dépannage avec divulgation progressive ; lancer validate-skills.sh et corriger chaque FAIL ; tester le déclenchement sur 10–20 requêtes et itérer sur les signaux de sous/sur-déclenchement. Licence MIT. Dépôt : https://github.com/dboeckli/ai-agent-skills/blob/main/.claude/skills/skill-best-practices/SKILL.md 1. Récupère le fichier SKILL.md (et les fichiers d'aide éventuels) depuis le chemin du dépôt dans un dossier temporaire et résume en une ou deux phrases ce qu'il fait. 2. Vérification de sécurité : examine le SKILL.md et les scripts pour tout contenu suspect (appels réseau inattendus, commandes shell, collecte d'identifiants). Ce dépôt ne devrait contenir aucun secret en dur, les identifiants uniquement via le coffre sécurisé, les hôtes autorisés déclarés dans le SKILL.md. Vérifie que c'est bien le cas ici ; STOP sur tout signal d'alerte et dis-le-moi. 3. Installe-le comme skill : copie le SKILL.md et ses fichiers d'aide dans le répertoire des skills de l'agent, dans un dossier nommé « skill-best-practices ». 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 (p. ex. le charger dès que je crée, révise ou dépanne un skill Claude — plus le skill compagnon cc-best-practices du même repo). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. 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.