Documentation

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. 1 Publiez votre skill dans un dépôt GitHub public.
  2. 2 Rendez-vous sur la page de soumission et saisissez l'URL du dépôt.
  3. 3 L'API Claude analyse votre skill pour la sécurité et la qualité.
  4. 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.