writing-skills

SKILL.md

Comprehensive guide for creating and managing skills in Claude Code with auto-activation system, following Anthropic's official best practices including the 500-line rule and progressive disclosure pattern.

Guardrail skills with blocking enforcement ("block") are designed but not yet implemented. These would enforce critical patterns and prevent common mistakes.

✅ Keep SKILL.md under 500 lines ✅ Use progressive disclosure with reference files ✅ Add table of contents to reference files > 100 lines ✅ Write detailed description with trigger keywords ✅ Test with 3+ real scenarios before documenting ✅ Iterate based on actual usage

Créer et gérer les compétences Claude Code dans le référentiel HASH en suivant les meilleures pratiques d'Anthropic. À utiliser lors de la création de nouvelles compétences, de la modification de skills-rules.json, de la compréhension des modèles de déclenchement, de l'utilisation de hooks, du débogage de l'activation des compétences ou de la mise en œuvre de la divulgation progressive. Couvre la structure des compétences, le contenu YAML, les types de déclencheurs (mots clés, modèles d'intention), le hook UserPromptSubmit et la règle des 500 lignes. Inclut la validation et le débogage avec SKILL_DEBUG. Les exemples incluent les compétences en matière de pile d'erreurs de rouille, de dépendances de fret et de documentation sur la rouille. Source : microck/ordinary-claude-skills.

Voir l'original