writing-skills
Écrire des compétences d'agent IA de haute qualité
Également disponible depuis: Cygnusfear,Cycleaddict,ZhanlinCui,davila7,obra,Dimon94,DYAI2025,CodingCossack
Cette compétence fournit des modèles, des arborescences de décision et des bonnes pratiques pour créer et améliorer les compétences d'agent IA. Elle aide les utilisateurs à éviter les erreurs courantes et à suivre des modèles standardisés.
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Tester
Utilisation de "writing-skills". I want to create a skill for handling API errors
Résultat attendu:
A complete SKILL.md with: name: api-error-handler, description: 'Use when API request fails or returns error status', metadata with triggers: api-error, network-failure, 503, with references/ folder for detailed handling procedures
Utilisation de "writing-skills". My skill description is 'This skill helps with file operations' - it's not triggering
Résultat attendu:
Optimized description: 'Use when user asks to read, write, or modify files. Triggers on: file-create, file-edit, file-delete, touch, mkdir, rm command'
Audit de sécurité
SûrThis is a documentation and reference skill providing guidance on writing AI agent skills. All static findings are false positives - the scanner detected patterns in markdown documentation (code formatting with backticks, mentions of cryptographic terms, URLs in documentation) rather than actual executable code. The render-graphs.js is a build script for documentation generation, not runtime functionality.
Score de qualité
Ce que vous pouvez construire
Créer une nouvelle compétence
Utilisez l'arborescence de décision pour sélectionner le bon niveau d'architecture et le bon modèle pour une nouvelle compétence, puis suivez la structure du modèle.
Améliorer les compétences existantes
Diagnostiquez pourquoi une compétence n'est pas déclenchée ou ignorée par les agents, puis appliquez des techniques anti-rationalisation ou CSO.
Standardiser les compétences de l'équipe
Assurez-vous que toutes les compétences de l'équipe suivent des conventions de nommage cohérentes, des normes de métadonnées et des structures de répertoire.
Essayez ces prompts
I need to create a new skill called [skill-name]. It should [what it does]. Use the Tier 1 template from the writing-skills reference.
My skill [skill-name] is not being triggered by Claude. The description is: [description]. Apply CSO optimization from writing-skills.
I have a discipline skill with rules that Claude keeps ignoring. The rules are: [rules]. Apply anti-rationalization techniques.
I need to create a complex skill with multiple concepts (200-1000 lines). Use Tier 2 expanded architecture with proper references.
Bonnes pratiques
- Commencez toujours les descriptions par 'Use when...' suivi de conditions de déclenchement spécifiques
- Incluez au moins 3 mots-clés dans metadata.triggers pour une meilleure découvrabilité
- Gardez les compétences à fichier unique sous 200 lignes ; utilisez references/ pour un contenu plus long
- Divisez les compétences monolithiques en plusieurs fichiers en utilisant le système de niveaux
Éviter
- Décrire le flux de travail au lieu des déclencheurs (par exemple, 'This skill helps you create files' au lieu de 'Use when user wants to create a file')
- Utiliser des noms de compétence génériques comme 'helper' ou 'utility' au lieu de gérondifs descriptifs
- Manquer le champ metadata.triggers ou avoir moins de 3 mots-clés de déclenchement
- Créer de longs fichiers SKILL.md monolithiques au lieu de modulariser avec references/