Tutoriel 03 — Skills personnalisés : donnez de nouvelles capacités à votre IA
Objectif : écrire un Skill personnalisé pour que l'IA adopte automatiquement un comportement prédéfini dans des contextes précis.
Qu'est-ce qu'un Skill ?
Un Skill est un fichier Markdown (SKILL.md) qui est injecté dans le contexte de l'IA lorsque vous invoquez une commande slash. Il indique à l'IA « ce qu'elle doit faire et comment le faire ».
/revue-code → Injection de SKILL.md → L'IA applique les règles de revue prédéfinies
Les Skills sont stockés dans :
~/.openclaw/workspace/skills/<nom-du-skill>/SKILL.md
Étape 1 : Créer le répertoire du Skill
mkdir -p ~/.openclaw/workspace/skills/revue-codeÉtape 2 : Écrire le fichier SKILL.md
Créez ~/.openclaw/workspace/skills/revue-code/SKILL.md :
# Expert en revue de code
Vous êtes désormais un expert senior en revue de code. L'utilisateur va coller du code que vous devez analyser selon les critères suivants :
## Axes d'analyse
1. **Exactitude** — Y a-t-il des bugs logiques ? Les cas limites sont-ils gérés ?
2. **Sécurité** — Risques d'injection SQL, XSS, désérialisation non sécurisée ?
3. **Performance** — Goulots d'étranglement évidents ou complexité inutile ?
4. **Lisibilité** — Nommage clair, commentaires pertinents ?
5. **Bonnes pratiques** — Respect des conventions du langage/framework ?
## Format de sortie
Listez les problèmes dans un tableau Markdown :
| Ligne | Sévérité | Description du problème | Suggestion de correction |
|-------|----------|------------------------|--------------------------|
| ... | 🔴Haute/🟡Moyenne/🟢Faible | ... | ... |
Terminez par une note globale (1-10) et un commentaire de synthèse.
## Ton
Professionnel mais bienveillant — pointez les problèmes en proposant des exemples de correction.Étape 3 : Utiliser le Skill
Dans WebChat ou Telegram, saisissez :
/revue-code
def login(username, password):
query = f"SELECT * FROM users WHERE name='{username}' AND pwd='{password}'"
return db.execute(query)
L'IA appliquera automatiquement le rôle d'expert et produira un rapport de revue structuré.
Exemples supplémentaires de Skills
Briefing quotidien (/briefing)
# Assistant de briefing quotidien
Organisez les informations fournies par l'utilisateur en un briefing quotidien concis, selon le format suivant :
## 📅 [Date]
### Points clés
- ...
### Tâches à faire
- [ ] ...
### Notes
...
Style concis, priorité aux points essentiels, 300 mots maximum.Traduction et réécriture (/polir)
# Expert en traduction et réécriture
Vous êtes un expert bilingue français-anglais. L'utilisateur fournit un texte en français ou en anglais, et vous devez :
1. Identifier la langue
2. Traduire dans l'autre langue
3. Réécrire la traduction pour la rendre plus naturelle et idiomatique
4. Présenter trois versions : original, traduction littérale, version retravaillée
Respectez la précision des termes techniques et évitez le style machine.Génération de diagrammes (/diagramme)
# Générateur de diagrammes Mermaid
Convertissez la description textuelle de l'utilisateur en code de diagramme Mermaid.
Types supportés :
- flowchart (organigramme)
- sequenceDiagram (diagramme de séquence)
- classDiagram (diagramme de classes)
- gantt (diagramme de Gantt)
Format de sortie :
\```mermaid
...code du diagramme...
\```
Puis expliquez la structure du diagramme en texte.Structure du répertoire Skills
~/.openclaw/workspace/skills/
├── revue-code/
│ └── SKILL.md
├── briefing/
│ └── SKILL.md
├── polir/
│ └── SKILL.md
└── diagramme/
└── SKILL.md
Voir les Skills installés
pnpm openclaw skills listAvancé : appel d'outils dans les Skills
Dans SKILL.md, vous pouvez demander à l'IA d'utiliser des outils spécifiques :
# Résumé de page web
L'utilisateur fournit une URL. Vous devez :
1. Utiliser browser_navigate pour ouvrir la page
2. Utiliser browser_snapshot pour récupérer le contenu
3. Extraire les idées clés et produire un résumé de 3 à 5 pointsQuestions fréquentes
Comment déboguer une commande /nom-skill qui ne fonctionne pas ?
Lancez d'abord pnpm openclaw skills list pour confirmer que le Skill est reconnu. Causes fréquentes : ① le nom du répertoire ne correspond pas à la commande slash (sensible à la casse) ; ② le nom du fichier SKILL.md est mal orthographié ; ③ la hiérarchie du répertoire est incorrecte — elle doit être ~/.openclaw/workspace/skills/<nom-du-skill>/SKILL.md. Après modification, renvoyez simplement la commande sans redémarrer la passerelle.
Quels outils intégrés un Skill peut-il appeler ?
Dans SKILL.md, vous pouvez demander à l'IA d'utiliser n'importe quel outil intégré d'OpenClaw : outils navigateur (browser_navigate, browser_snapshot, browser_action), outils de lecture/écriture de fichiers, et tout autre outil activé par la configuration. Décrivez simplement le comportement souhaité en langage naturel dans SKILL.md — l'IA choisira les outils appropriés.
Y a-t-il des contraintes de longueur ou de format pour SKILL.md ?
Il n'y a pas de limite stricte, mais restez sous 500 mots. Un fichier SKILL.md trop long consomme davantage de tokens de contexte, augmentant les coûts et pouvant réduire la précision du suivi des instructions. Utilisez une hiérarchie Markdown claire (# titre principal, ## sections) pour que l'IA comprenne mieux la structure.
Faut-il redémarrer la passerelle après avoir modifié un Skill ?
Non. OpenClaw relit SKILL.md à chaque appel de commande slash — modifiez et utilisez directement. En revanche, si vous modifiez openclaw.json, un redémarrage de la passerelle est nécessaire.
Peut-on combiner plusieurs Skills ?
Oui. Invoquez /skillA dans un message — l'IA maintient ce comportement jusqu'à ce que vous envoyiez /new pour démarrer une nouvelle session. Vous pouvez aussi intégrer plusieurs capacités dans un seul SKILL.md pour créer un « assistant universel ».
Prochaines étapes
- Tutoriel 04 — Laisser l'IA automatiser la navigation web
- Tutoriel 05 — Configurer plusieurs modèles avec basculement automatique