Guide Complet : Utilisez des Skills avec vos Agents IA

Comprendre les skills

De l’agent généraliste à l’agent spécialisé

Vous avez besoin d’aide pour réaliser une tâche technique ?

• Écrire un article optimisé pour le SEO
• Réduire le poids du code JavaScript de votre page web
• Effectuer une veille technologique
• Optimiser l’accessibilité de votre site web
• Refacto votre code CSS
• Etc.

Pendant des années, on a cherché de l’aide à travers des tutoriels et ressources en ligne via des moteurs de recherche. Mais depuis l’arrivée massive de l’IA avec ChatGPT fin 2022, la donne a changé : on passe progressivement des moteurs de recherche aux moteurs de réponse, portés par les IA.

Aujourd’hui, nous faisons constamment appel aux IA pour résoudre des problèmes techniques variés. Mais, à moins d’utiliser des modèles spécifiques « fine-tunés » (entraînés pour un domaine précis), ces IA restent souvent généralistes et ne possèdent pas de connaissances spécifiques à notre domaine de travail ni à la façon de faire.

Il devient alors nécessaire de structurer nos prompts en apportant du contexte à la volée afin de guider l’IA vers des réponses plus précises et pertinentes.

Pour pallier cela, des entreprises tech de référence comme Anthropic et Vercel ont commencé à développer des solutions pour enrichir les agents IA (Claude, GPT, etc.) avec des connaissances, workflows et bonnes pratiques spécifiques à un domaine ou usage précis.

Du côté de Vercel, cette solution a un nom : Skills.sh.

Cette approche de prompt engineering structuré transforme un agent généraliste en expert spécialisé dans un domaine précis : expert en SEO programmatique, développeur Python, designer UX/UI, obsédé des performances, etc.

Mais comment cela fonctionne-t-il vraiment ? 🤔

Qu’est-ce qu’un skill ?

Un skill est un dossier regroupant des fichiers markdown (instructions, docs de référence, scripts, etc.) organisés avec des instructions et des connaissances spécifiques.

Imaginons que nous souhaitons créer un skill sachant parfaitement comment chiffrer et déchiffrer un message avec le code de César (Caesar Cipher).

On pourrait ainsi avoir la structure suivante :

📂 caesar-cipher/
├── 📄 SKILL.md
├── 📂 references/
│   ├── 📄 alphabet.md
│   └── 📄 edge-cases.md
└── 📂 scripts/
    ├── 📄 encrypt.py
    ├── 📄 decrypt.py
    └── 📄 bruteforce.py

Architecture d’un skill

Progressive Disclosure

Analysons plus en détail la structure d’un skill, dont l’architecture de fichiers découpe le contenu en 3 grandes couches :

1. 🏷️ Les métadonnées (frontmatter)
2. ✅ Les instructions
3. 🗃️ Les ressources (références, scripts, etc.)

Cette architecture repose sur le principe du Progressive Disclosure.

Son avantage principal est de permettre à l’IA de charger les informations progressivement, uniquement quand elle en a besoin, au lieu d’ingérer tout le contexte dès le départ.

Elle va donc :

1. Charger le fichier principal 📄 SKILL.md de l’ensemble de vos skills, contenant à minima un nom et une description en frontmatter pour avoir connaissance du skill, si jamais il venait à être appelé.
2. Charger les instructions du skill lorsqu’il est appelé.
3. Charger les ressources correspondantes au besoin évoqué.

Voici un tableau récapitulatif des différents niveaux de chargement :

🏷️ Les métadonnées

Le fichier principal s’appelle 📄 SKILL.md et contient à minima un nom et une description en frontmatter.

---
name: your-skill-name
description: Brève description de ce que fait le skill et quand il est utile
---

---
name: caesar-cipher
description: Comment chiffrer et déchiffrer un message avec le code de César en indiquant une clé de décalage
---

✅ Les instructions

Le fichier 📄 SKILL.md contient à la suite des métadonnées les instructions pour utiliser le skill.

---
name: your-skill-name
description: Brève description de ce que fait le skill et quand il est utile
---

## Instructions
Des instructions claires, structurées et détaillées pour permettre à l'agent IA de suivre les étapes pour utiliser le skill.

## Exemples
Des exemples concrets de comment utiliser le skill.

Les sections Instructions et Exemples sont simplement des recommandations de structure (bonnes pratiques), mais vous restez totalement libre d’organiser le contenu de votre skill comme bon vous semble.

---
name: caesar-cipher
description: Comment chiffrer et déchiffrer un message avec le code de César en indiquant une clé de décalage
---

# Caesar Cipher Skill

## Instructions

### 🎯 Objectif

Ce skill permet de :
- Chiffrer un message avec le chiffrement de César
- Déchiffrer un message connaissant le décalage
- Expliquer le fonctionnement de l’algorithme

---

### 🧠 Contexte

Le chiffrement de César est une méthode de cryptographie simple utilisée dans la Rome antique par Jules César.

Principe :
Chaque lettre du message est décalée d’un nombre fixe de positions dans l’alphabet.

Exemple avec un décalage de 3 :

A → D  
B → E  
C → F  

---

### 📚 Références

Le skill peut consulter les fichiers suivants :

- `references/alphabet.md` → gestion des alphabets
- `references/edge-cases.md` → caractères spéciaux, majuscules, accents

---

### ⚙️ Scripts disponibles

- `scripts/encrypt.py` → chiffre un message
- `scripts/decrypt.py` → déchiffre un message
- `scripts/bruteforce.py` → teste tous les décalages possibles

---

### 📝 Instructions d’utilisation

1. Identifier si l’utilisateur souhaite chiffrer ou déchiffrer.
2. Vérifier la valeur du décalage.
3. Conserver la casse des lettres.
4. Ne pas modifier les caractères non alphabétiques.
5. Retourner uniquement le résultat final sauf demande d’explication.

## Examples

"Hello" (clé de 2) => Fcjjm
"Hello" (clé de -2) => Jgnnq
"Eléphant" (clé de 3) => Hohskdqw
"Zorro" (clé de 1) => Apssp

Les références et les scripts constituent ici des ressources spécifiques au skill. Leurs liens seront explorés par l’agent IA au besoin.

🗃️ Les ressources

Les ressources sont des fichiers qui seront chargés à la demande selon le besoin de l’agent IA utilisant le skill.

Différence entre skill et RAG

En IA, le RAG (Retrieval Augmented Generation) consiste à injecter des informations contextuelles à l’agent IA pour qu’il puisse répondre de manière plus précise.

Concrètement, cela consiste à lui donner à manger des informations spécifiques pour qu’il puisse mieux répondre. Et on peut être tenté d’assimiler l’usage des skills à celui du RAG.

Mais en vérité, les skills vont bien plus loin.

Ils ne se contentent pas de fournir du contenu métier à un agent IA, mais ils lui transmettent également une manière de travailler.

Là où le RAG injecte du contenu, les skills encapsulent une expertise et un workflow.

👉 Le RAG injecte du savoir, le skill injecte une façon d’agir (quel raisonnement suivre, quel script exécuter, quel format de sortie retourner, etc.).

Tutoriel : prendre en main skills.sh

Claude propose sur son site web un guide complet pour créer des skills, mais je vais ici utiliser l’outil proposé par Vercel : skills.sh, qui a l’avantage d’être agnostique de l’agent IA utilisé.

Il n’est pas nécessaire d’installer skills.sh sur votre machine car cet outil sera directement exécuté avec l’exécuteur de paquet npx.

1. Installer un skill

Pour installer un skill, on tape la commande :

npx skills add <skill-package>

Lors de l’installation d’un skill, skills.sh va télécharger le dossier du skill en question (fichier 📄 SKILL.md, sous-dossiers, etc.) depuis le repository GitHub du skill et l’ajouter à votre configuration, locale (interne à un projet) ou globale (sur votre machine).

Pour chaque skill installé, il sera possible de spécifier pour quels agents il sera exploitable.

Des milliers de skills sont déjà disponibles sur skills.sh.

Certains sont créés par des organismes reconnus comme Vercel et Anthropic, d’autres par des développeurs indépendants.

On peut par exemple citer :

• Find Skill : permet de trouver des skills répondant à un besoin sur skills.sh
• SEO Audit : permet d’auditer un site web pour améliorer son référencement
• Brainstorming : permet de brainstormer sur un sujet
• Web Design Guidelines : permet de suivre des bonnes pratiques de design web
• Vercel React Best Practices : permet de suivre des bonnes pratiques de développement React
• Etc.

2. Lister les skills installés

Pour lister les skills installés, on tape la commande :

npx skills list

Pour afficher les skills installés globalement, on rajoutera l’option -g.

3. Supprimer un skill

Pour supprimer un skill, on tape la commande :

npx skills remove <nom-skill>

4. Mettre à jour les skills installés

Pour mettre à jour les skills installés, on tape la commande :

npx skills update

5. Utiliser un skill

Pour utiliser un skill, 2 approches s’offrent à vous :

Implicitement

Il peut être déclenché en invoquant un besoin qui peut être résolu par ce skill. L’agent IA utilisera alors automatiquement le skill pour répondre à votre demande.

Chiffre le mot "hello" avec le code de César et une clé de 3.

Explicitement

Vous pouvez directement appeler le skill en le citant dans votre demande.

En utilisant le skill "cipher-code", chiffre le mot "hello" avec une clé de 3.

6. Créer un skill

Pour créer un skill, on tape la commande :

npx skills init <nom-skill>

Une fois le skill créé, un dossier 📁 nom-skill sera créé à l’endroit dans lequel vous vous trouvez avec votre terminal.