Créer des Skills
Une skill est simplement un fichier Markdown avec un frontmatter YAML. Si vous avez une expertise métier qui vaut la peine d'être partagée, rédigez-la dans un SKILL.md.
Structure du fichier
SKILL.md
--- name: my-skill description: One sentence shown in lazy-load preview. version: 1.0.0 author: your-github-username tags: - laravel - php - testing --- # My Skill ## Overview What this skill teaches Claude and when to apply it. ## Conventions - Always use X instead of Y - Prefer Z pattern for ABC scenarios ## Examples ```php // Your code examples here ```
Champs du frontmatter
| Champ | Obligatoire | Description |
|---|---|---|
| name | Obligatoire | Identifiant compatible URL. |
| description | Obligatoire | Une phrase — affichée dans l'aperçu de chargement différé et dans le catalogue. |
| version | Optionnel | Version sémantique, ex. 1.0.0. |
| author | Optionnel | Votre nom d'utilisateur GitHub. |
| tags | Optionnel | Tableau de tags pour la recherche et le filtrage. |
Directives de contenu
- ▸Soyez précis. "Toujours utiliser
$query->whereNull('deleted_at')" vaut mieux que "utiliser les soft deletes". - ▸Incluez des exemples. Les blocs de code rendent les instructions sans ambiguïté.
- ▸Précisez le contexte. À quel type de projet, framework ou situation cette skill s'applique-t-elle ?
- ▸Restez ciblé. Une skill = un domaine. Ne mélangez pas Laravel + sécurité + tests dans un seul fichier.
Soumettre au catalogue
- 1 Publiez votre skill dans un dépôt GitHub public.
- 2 Rendez-vous sur la page de soumission et saisissez l'URL du dépôt.
- 3 L'API Claude analyse votre skill pour la sécurité et la qualité.
- 4 Si approuvée, elle apparaît dans le catalogue en quelques minutes.
Analyse de sécurité
Chaque skill soumise est analysée par Claude pour détecter les injections de prompts, les accès non autorisés aux fichiers et les tentatives d'exfiltration de données. Les skills signalées comme dangereuses sont examinées par un administrateur. Garder votre skill centrée sur la connaissance — sans exécution de code ni requêtes externes — garantit une approbation sans accroc.