| 💾 Saved. d722711 k33g 8h ago | 1 | # Référence : format d'un fichier de skill |
| 2 | |
| 3 | > Description neutre des fichiers markdown servis par l'outil `read_skill`. |
| 4 | |
| 5 | ## Emplacement |
| 6 | |
| 7 | | Règle | Valeur | |
| 8 | |-------|--------| |
| 9 | | Répertoire | `skillsDir` (défaut `skills`). | |
| 10 | | 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. | |
| 11 | | Nom du skill sur disque | Le nom du fichier sans `.md`, ou le nom du répertoire pour un `SKILL.md`. | |
| 12 | | Les deux formes pour un même nom | `read_skill` renvoie le fichier à plat. | |
| 13 | | Répertoire absent | Pas une erreur : zéro skill, `read_skill` non déclaré. | |
| 14 | |
| 15 | ## En-tête (front matter) |
| 16 | |
| 17 | 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. |
| 18 | |
| 19 | | Clé | Type | Défaut | Description | |
| 20 | |-----|------|--------|-------------| |
| 21 | | `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. | |
| 22 | | `description` | chaîne | `""` | Résumé d'une ligne affiché dans le catalogue. | |
| 23 | |
| 24 | Une ligne `description:` dans le corps, après le `---` de fermeture, n'est pas une métadonnée. |
| 25 | |
| 26 | ## Rendu du catalogue |
| 27 | |
| 28 | La description de l'outil est : |
| 29 | |
| 30 | ``` |
| 31 | 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: |
| 32 | <name> — <description> |
| 33 | <name> |
| 34 | ``` |
| 35 | |
| 36 | Les entrées sont triées par nom ; la partie ` — <description>` est omise quand la description est vide. |
| 37 | |
| 38 | ### Exemple |
| 39 | |
| 40 | ```markdown |
| 41 | --- |
| 42 | name: what-time-is-it |
| 43 | description: Give the current date and time. |
| 44 | keywords: time, date, clock |
| 45 | --- |
| 46 | |
| 47 | # What time is it? |
| 48 | |
| 49 | Run: |
| 50 | |
| 51 | ```bash |
| 52 | date "+%A %d %B %Y — %H:%M:%S (%Z)" |
| 53 | ``` |
| 54 | ``` |
| 55 | |
| 56 | La clé `keywords` est acceptée dans le fichier et ignorée par le chargeur. |
| 57 | |
| 58 | ## Exemples livrés |
| 59 | |
| 60 | | Chemin | `name` | `description` | |
| 61 | |--------|--------|---------------| |
| 62 | | `skills/greetings/SKILL.md` | `greetings` | Greet somebody with a festive message. | |
| 63 | | `skills/vulcan-salute/SKILL.md` | `vulcan-salute` | Send a vulcan salute to somebody. | |
| 64 | | `skills/what-time-is-it/SKILL.md` | `what-time-is-it` | Give the current date and time. | |
| 65 | |
| 66 | Ils utilisent la disposition un répertoire par skill ; lancé depuis la racine du dépôt, `mm` indique `skills: 3`. |