Principes d'écriture de compétences pour Claude Code, issus de 159 compétences open-source

Un développeur a publié 10 principes pour écrire des compétences efficaces pour Claude Code, dérivés de la création et de la maintenance d'un registre de compétences open-source avec 159 compétences. Les principes se concentrent sur des modèles de mise en œuvre pratiques observés à travers l'utilisation réelle des agents.

Principaux principes d'écriture de compétences

• Ne pas énoncer l'évident - Poussez Claude hors de ses paramètres par défaut plutôt que de les renforcer
• Section pièges courants - Considérée comme le contenu avec le meilleur retour sur investissement dans toute compétence
• Les compétences sont des dossiers, pas des fichiers - Utilisez des sous-répertoires references/, scripts/, assets/
• Ne pas imposer un chemin unique - Fournissez des directives au lieu de séquences d'étapes rigides
• Configuration initiale via config.json - Placez les fichiers de configuration directement dans le dossier de la compétence
• Le champ description est une condition de déclenchement - Pas seulement un résumé
• Donnez de la mémoire aux compétences - Utilisez des journaux, JSON ou SQLite entre les exécutions
• Livrez des scripts avec la prose - Exemple : fetch_events.py est plus précieux que 200 lignes d'explication
• Crochets à la demande - Utilisez des blocs /careful pour restreindre les commandes destructives uniquement lorsqu'elles sont invoquées
• Les compétences se composent - Référencez d'autres compétences par nom ; Claude les invoquera si elles sont installées

Détails de mise en œuvre

Les principes proviennent du référentiel AbsolutelySkilled (github.com/AbsolutelySkilled/AbsolutelySkilled), qui contient 159 compétences open-source. Toutes les compétences sont installables via npx skills add. Le développeur souligne que ces modèles ont émergé en observant comment les agents utilisent réellement les compétences en pratique, et non à partir d'une conception théorique.

Pour les développeurs créant des compétences pour les agents d'IA de codage, ces principes fournissent des conseils concrets sur la structuration efficace des compétences. L'accent mis sur la mise en œuvre pratique - comme l'utilisation de dossiers au lieu de fichiers uniques et l'inclusion de scripts réels plutôt que de simples explications - reflète les modèles d'utilisation réels.