Référence : format d'un fichier de skill

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# Référence : format d'un fichier de skill

> Description neutre des fichiers markdown servis par l'outil `read_skill`.

## Emplacement

| Règle | Valeur |
|-------|--------|
| Répertoire | `skillsDir` (défaut `skills`). |
| Motifs | `<skillsDir>/<nom>.md` (à plat) et `<skillsDir>/<nom>/SKILL.md` (un répertoire par skill), librement mélangés. Les autres fichiers du répertoire d'un skill sont ignorés. Un `README.md` à la racine du répertoire est de la documentation, pas un skill : il est ignoré. |
| Nom du skill sur disque | Le nom du fichier sans `.md`, ou le nom du répertoire pour un `SKILL.md`. |
| Les deux formes pour un même nom | `read_skill` renvoie le fichier à plat. |
| Répertoire absent | Pas une erreur : zéro skill, `read_skill` non déclaré. |

## En-tête (front matter)

Optionnel. Quand il est présent, le fichier commence par une ligne `---` et l'en-tête se termine à la ligne `---` suivante. Seules deux clés sont lues ; les autres sont ignorées.

| Clé | Type | Défaut | Description |
|-----|------|--------|-------------|
| `name` | chaîne | nom du fichier sans `.md` | Nom affiché dans le catalogue et accepté par `read_skill`. Une valeur vide garde le défaut. |
| `description` | chaîne | `""` | Résumé d'une ligne affiché dans le catalogue. |

Une ligne `description:` dans le corps, après le `---` de fermeture, n'est pas une métadonnée.

## Rendu du catalogue

La description de l'outil est :

```
Load a skill: the step-by-step procedure to follow for this kind of task. Call it BEFORE doing the work, with the name of the matching skill, and then follow what it says. Available skills:
  <name> — <description>
  <name>
```

Les entrées sont triées par nom ; la partie ` — <description>` est omise quand la description est vide.

### Exemple

```markdown
---
name: what-time-is-it
description: Give the current date and time.
keywords: time, date, clock
---

# What time is it?

Run:

```bash
date "+%A %d %B %Y — %H:%M:%S (%Z)"
```
```

La clé `keywords` est acceptée dans le fichier et ignorée par le chargeur.

## Exemples livrés

| Chemin | `name` | `description` |
|--------|--------|---------------|
| `skills/greetings/SKILL.md` | `greetings` | Greet somebody with a festive message. |
| `skills/vulcan-salute/SKILL.md` | `vulcan-salute` | Send a vulcan salute to somebody. |
| `skills/what-time-is-it/SKILL.md` | `what-time-is-it` | Give the current date and time. |

Ils utilisent la disposition un répertoire par skill ; lancé depuis la racine du dépôt, `mm` indique `skills: 3`.