Notre avis
Cette compétence explique la structure et la création des fichiers SKILL.md pour les compétences Claude Code, y compris les métadonnées frontmatter et les meilleures pratiques de découverte.
Points forts
- Définit clairement le champ description pour le déclenchement automatique
- Distingue les compétences des plugins, hooks et commandes slash
- Fournit des exemples de descriptions bonnes et mauvaises
- Documente les champs obligatoires et optionnels du frontmatter
Limites
- Ne couvre que le format du fichier, pas le contenu de la compétence
- Spécifique à Claude Code, non applicable à d'autres plateformes
- N'inclut pas de modèle pour des cas d'utilisation avancés
Utilisez cette compétence lorsque vous créez ou modifiez un fichier SKILL.md pour définir une nouvelle compétence.
Ne l'utilisez pas pour implémenter des fonctionnalités avancées comme des outils CLI, des serveurs MCP ou des hooks, qui nécessitent un plugin.
Analyse de sécurité
SûrThe skill only uses safe tools (Read, Glob, Grep) that do not alter the system. It contains no destructive commands, exfiltration attempts, or obfuscated content. It is purely informational documentation.
Aucun point d'attention détecté
Exemples
I want to create a new skill for my project. Can you explain the SKILL.md format and what fields are required?How do I write a good description for skill discovery in SKILL.md? Give me examples of good and bad descriptions.What is the difference between a skill and a plugin in Claude Code? When should I use each?name: example-skill description: Use when working with examples, tutorials, or skill documentation. Invoke when the user asks about skill configuration, manifest structure, or creating new skills. allowed-tools: Read, Glob, Grep
Example Skill
This is an example skill demonstrating the SKILL.md format.
What Skills Provide
Skills are instructions and context injected into the agent's system prompt. They help the agent understand:
- When to use certain techniques or tools
- Project-specific conventions and patterns
- Domain knowledge and best practices
What Skills Do NOT Provide
Skills are not for:
- CLI tools (use package managers or plugins)
- MCP servers (use plugins with plugin.json)
- Hooks (use plugins)
- Slash commands (use plugins)
For those capabilities, create a full Claude Code plugin with .claude-plugin/plugin.json.
SKILL.md Format
Skills are defined by a single SKILL.md file with YAML frontmatter:
---
name: my-skill
description: When to use this skill...
allowed-tools: Read, Write, Bash
---
# My Skill
Instructions and documentation here...
Required Frontmatter Fields
| Field | Description |
|-------|-------------|
| name | Skill identifier (kebab-case, 1-64 chars) |
| description | Critical - tells Claude when to invoke the skill |
Optional Frontmatter Fields
| Field | Description |
|-------|-------------|
| allowed-tools | Comma-separated or YAML array of allowed tools |
Discovery
The description field is crucial for skill discovery. Claude uses it to decide when to invoke the skill.
Good descriptions:
- "Use when managing git branches, resolving merge conflicts, or reviewing commit history"
- "Use when working with React components, hooks, or state management"
Bad descriptions:
- "Git utilities" (too vague)
- "React helper" (won't trigger reliably)
Example Use Cases
This skill covers:
- Explaining skill structure and format
- Helping users create new skills
- Demonstrating best practices for skill documentation
Generateur de Documentation API
Documentation
Genere automatiquement de la documentation API OpenAPI/Swagger.
Rédacteur Technique
Documentation
Rédige de la documentation technique claire selon les meilleurs style guides.
Décision de Pivot Stratégique
Documentation
Documente une décision stratégique de pivot ou de persévérance avec preuves, analyse et justification. À utiliser pour évaluer s'il faut changer de cap sur un produit, une fonctionnalité ou une stratégie en fonction des retours du marché.