Comment creer et evaluer des Skills OpenClaw

Ce que tu vas construire

Un workflow de developpement et d'evaluation de Skills qui te permet de :

1. Creer des Skills personnalises — developper de nouveaux Skills OpenClaw adaptes a tes besoins specifiques
2. Evaluer les Skills communautaires — verifier les Skills de ClawHub en termes de qualite, securite et fiabilite
3. Decomposer des taches complexes — diviser les workflows multi-etapes en chaines de Skills reutilisables
4. Iterer et ameliorer — tester, deboguer et affiner les Skills avec un feedback assiste par IA

A la fin de ce guide, tu seras capable de creer des Skills de qualite production et d'evaluer en toute confiance n'importe quel Skill avant de l'installer.

Pourquoi creer des Skills personnalises

ClawHub propose des centaines de Skills communautaires, mais parfois tu as besoin de quelque chose de specifique :

• Outils internes — les API, dashboards et workflows de ton entreprise ne sont pas couverts par les Skills publics
• Integrations sur mesure — tu utilises des outils de niche ou des systemes proprietaires qui necessitent des connecteurs personnalises
• Optimisation des workflows — combiner plusieurs Skills en un seul Skill simplifie fait gagner du temps
• Controle qualite — creer tes propres Skills signifie que tu sais exactement ce qu'ils font
• Avantage concurrentiel — des workflows d'automatisation uniques que tes concurrents n'ont pas

Pourquoi evaluer les Skills avant de les installer

Tous les Skills sur ClawHub ne sont pas prets pour la production. Avant d'installer un Skill communautaire :

• Securite — un Skill pourrait acceder a ton systeme de fichiers, reseau ou identifiants de maniere inattendue
• Qualite — certains Skills sont des prototypes ou des preuves de concept, pas du code production-ready
• Maintenance — les Skills abandonnes peuvent ne plus fonctionner avec les nouvelles versions d'OpenClaw
• Dependances — un Skill peut necessiter des services externes ou des cles API que tu n'as pas
• Permissions — comprends exactement les acces qu'un Skill demande avant de les accorder

Prerequis

• OpenClaw installe et configure (Guide de demarrage)
• Familiarite avec YAML et le scripting basique
• Node.js 18+

Etape 1 : Installer les outils de developpement de Skills

# 1. Skill builder — te guide dans la creation de Skills bien structures
npx clawhub@latest install skill-builder

# 2. Skill reviewer — analyse de qualite et de structure
npx clawhub@latest install skill-reviewer

# 3. Task decomposer — decompose les taches complexes en chaines de Skills
npx clawhub@latest install task-decomposer

Etape 2 : Creer ton premier Skill personnalise

Comprendre la structure d'un Skill

Un Skill OpenClaw est centre autour d'un fichier SKILL.md — c'est le document d'instructions principal qui indique a l'agent IA comment effectuer une tache. Le Skill Builder te guide dans la creation de Skills bien structures en suivant les bonnes pratiques.

La structure typique d'un Skill ressemble a :

my-custom-skill/
  ├── SKILL.md             # Instructions principales pour l'agent
  ├── [topic].md           # Fichiers de detail a la demande (charges si necessaire)
  ├── references/          # Documentation detaillee, exemples
  └── scripts/             # Scripts d'automatisation optionnels

Ecrire ton SKILL.md

Le SKILL.md est le coeur de ton Skill. Demande a OpenClaw (avec le Skill Builder installe) de t'aider a en ecrire un :

Aide-moi a creer un Skill qui recherche des produits via une API personnalisee.
L'API est a https://api.example.com/search et necessite une cle API.

Le Skill Builder te guide a travers :

• Structure modulaire — garder le SKILL.md principal concis et utiliser des fichiers separes pour les sujets detailles
• Divulgation progressive — charger les fichiers de detail uniquement quand l'agent en a besoin
• Conception econome en tokens — minimiser l'utilisation de la fenetre de contexte
• Entrees/sorties claires — definir ce que le Skill attend et retourne

Exemple de SKILL.md

# Product Search Skill

Search the product catalog API for items matching a query.

## Configuration
- `API_URL`: Base URL of the product API
- `API_KEY`: API key for authentication (set as environment variable)

## Usage
When the user asks to search for products, use the API:

GET {API_URL}/search?q={query}
Authorization: Bearer {API_KEY}

## Response Format
Return results as a structured list with name, price, and URL for each product.

Tester le Skill

Installe ton Skill en local et teste-le :

clawhub install ./my-custom-skill

Puis essaie de l'utiliser dans OpenClaw pour verifier qu'il fonctionne comme prevu.

Etape 3 : Evaluer un Skill communautaire

Avant d'installer un Skill depuis ClawHub, evalue-le :

clawhub run skill-reviewer --skill "clawhub-username/skill-name"

Le reviewer analyse le SKILL.md et les fichiers associes, en verifiant :

=== Skill Review: awesome-slack-bot ===

## Evaluation de la structure
✓ SKILL.md bien organise avec des sections claires
✓ Description specifique et actionnable
✓ Attentes d'entrees/sorties documentees
✓ Exemples d'utilisation inclus
⚠ Fichiers de detail a la demande manquants — tout le contenu est dans un seul SKILL.md

## Score de qualite
✓ Metadonnees completes (nom, description, version)
✓ Instructions economes en tokens — divulgation progressive utilisee
✓ Consignes de gestion d'erreurs incluses
⚠ Pas de consignes de rate limiting — risque d'atteindre les limites API en usage intensif

## Qualite de la description : 8.5/10
Recommandation : Skill bien structure, pret a l'emploi

Ce qu'il faut verifier

Signaux d'alerte

• Le Skill demande des permissions dont il ne devrait pas avoir besoin (ex. un Skill de recherche qui demande l'acces en ecriture aux fichiers)
• Pas de tests ni de documentation
• Derniere mise a jour il y a plus de 6 mois
• URLs ou identifiants codes en dur dans le code source
• Code obfusque ou minifie

Bons signaux

• Declarations de permissions claires correspondant a l'usage reel
• Couverture de tests complete
• Maintenance active et engagement communautaire
• Code source transparent
• Configuration bien documentee

Etape 4 : Decomposer des taches complexes

Le Skill Task Decomposer aide a decouper des requetes complexes en etapes executables. Demande a OpenClaw :

Decompose cette tache : Surveiller les pages de tarifs des concurrents quotidiennement et m'alerter quand les prix changent

Exemple de resultat :

=== Decomposition de tache ===

Tache : Surveiller les pages de tarifs des concurrents et alerter quand les prix changent

## Chaine de Skills

1. **browser-use** — Naviguer vers chaque page de tarifs de concurrent
   Entree : Liste des URLs de concurrents
   Sortie : Contenu de la page / captures d'ecran

2. **web-scraper** — Extraire les donnees de tarifs de chaque page
   Entree : Contenu de la page
   Sortie : Donnees de tarifs structurees (JSON)

3. **file_read** — Charger les donnees de tarifs de la veille pour comparaison
   Entree : Chemin du fichier de donnees stockees
   Sortie : Donnees de tarifs precedentes

4. **summarize** — Comparer les tarifs actuels vs. precedents et identifier les changements
   Entree : Donnees actuelles + donnees precedentes
   Sortie : Rapport de changements

5. **telegram** (ou email) — Envoyer une alerte si des changements sont detectes
   Entree : Rapport de changements
   Sortie : Notification envoyee

## Skills necessaires
- browser-use (installe : oui)
- web-scraper (installe : oui)
- summarize (installe : oui)
- telegram (installe : non — installer avec : npx clawhub@latest install telegram)

## Temps de mise en place estime : 20 minutes

De la decomposition au workflow

Transforme la decomposition en un workflow reutilisable :

# .openclaw/price-monitor.yml
name: competitor-price-monitor
schedule: "0 9 * * *"
steps:
  - skill: browser-use
    action: navigate
    urls:
      - "https://competitor1.com/pricing"
      - "https://competitor2.com/pricing"

  - skill: web-scraper
    action: extract
    format: json
    target: "pricing tables"

  - skill: summarize
    action: compare
    current: "{{step_2.output}}"
    previous: "./data/last-pricing.json"

  - skill: telegram
    action: send
    condition: "changes_detected"
    message: "{{step_3.output}}"

  - action: save
    data: "{{step_2.output}}"
    path: "./data/last-pricing.json"

Etape 5 : Publier ton Skill

Quand ton Skill est pret, publie-le sur ClawHub :

clawhub publish my-custom-skill

Avant de publier, assure-toi que :

• Le SKILL.md est complet et bien structure
• La description est specifique et actionnable
• Aucun secret n'est code en dur dans les fichiers
• Le numero de version suit le semver

Depannage

Le Skill ne fonctionne pas comme prevu

• Verifie que les instructions du SKILL.md sont claires et specifiques
• Teste avec differents prompts pour voir si l'agent interprete correctement le Skill
• Consulte les recommandations du Skill Builder pour les erreurs courantes d'instructions

« Permission denied » pendant l'execution du Skill

• Verifie les acces du Skill — fichiers, reseau, identifiants
• Assure-toi d'avoir accorde les permissions requises lors de l'installation
• Certaines permissions necessitent une approbation explicite de l'utilisateur au premier lancement

Le Skill Reviewer affiche des faux positifs

• Le reviewer est conservateur — il signale tout ce qui pourrait poser probleme
• Examine les avertissements specifiques et decide s'ils s'appliquent a ton cas d'usage
• Chaque avertissement n'est pas forcement un vrai probleme — fais confiance a ton jugement

Le Skill publie n'apparait pas sur ClawHub

• La publication peut prendre quelques minutes a se propager
• Verifie que ton compte ClawHub est verifie
• Verifie que le nom du Skill n'entre pas en conflit avec un Skill existant