Skills : le guide

Les 57 skills Éclair, répartis en 8 familles, aident ton assistant IA à ajouter une fonction à ton site Éclair 2.0 sans casser ce qui marche. Installe-les dans ton projet, lance l’agent avec le prompt fourni, et n’active rien avant les 7 portes de qualité.

Ce guide détaille chaque étape et explique comment écrire tes propres skills. Avant de commencer, fais une sauvegarde comme l’explique le guide Mettre à jour, sauvegarder, déménager.

De quoi as-tu besoin avant de commencer ?

• Un site Éclair 2.0 et, idéalement, une copie de travail du code (le dépôt officiel cloné), pour que l’agent puisse lancer les tests.
• Python 3 pour installer et valider les skills, PHP 8.1 ou plus pour les outils d’Éclair.
• Un assistant qui lit les skills : Claude Code ou Codex, par exemple.
• Une sauvegarde récente : Sécurité › Télécharger une sauvegarde.

Comment installer les skills dans ton projet ?

1. Télécharge la bibliothèque depuis GitHub (bouton Code › Download ZIP, ou git clone).
2. Dans son dossier, vérifie qu’elle est intacte avec python3 scripts/validate_skills.py : le message doit annoncer 57 skills valides.
3. Liste les familles et les skills avec python3 scripts/install_skills.py --list.
4. Installe ce dont tu as besoin, par famille (--category design) ou par nom (--skill eclair-seo-audit), avec --project /chemin/vers/mon-site.
5. Pour Claude Code, copie les dossiers installés de .agents/skills/ vers .claude/skills/.

python3 scripts/validate_skills.py
python3 scripts/install_skills.py --list
python3 scripts/install_skills.py --project /chemin/vers/mon-site --category foundation
python3 scripts/install_skills.py --project /chemin/vers/mon-site --skill eclair-wordpress-migration
python3 scripts/install_skills.py --project /chemin/vers/mon-site --all

Comment lancer l’agent avec le bon prompt ?

Ouvre ton assistant dans le dossier du projet et donne-lui un prompt de départ clair. Celui-ci est fourni avec la bibliothèque :

Analyse ce projet Éclair CMS en commençant par eclair/index.php et docs/SKILLS-GUIDE.md. Utilise les skills eclair-architecture, eclair-extension-builder, eclair-security-audit et eclair-test-suite. Décris la fonctionnalité demandée en la ramenant aux capacités natives eclair-extension/1. Crée les fichiers de l’extension sous site/extensions/<id>/ sans modifier le noyau. Avant de proposer l’activation, exécute php tools/validate.php <extension> --json, php tests/run.php et php tools/measure.php --check. Si une capacité manque, arrête ce volet et crée une RFC et des tests ; n’invente pas d’API.

Ajoute ensuite ta demande en une ou deux phrases, avec les contraintes qui comptent pour toi : public visé, langues, volume, données personnelles.

Quelles vérifications avant d’activer une fonction ?

La bibliothèque définit sept portes de qualité. Une fonction ne s’active que lorsque toutes sont franchies.

Ce qu’il faut faire

• Décrire le besoin métier, pas la technique : l’agent choisit les skills.
• Laisser l’agent lire les capacités du site avant d’écrire du code.
• Tester sur une copie du site, jamais directement en production.
• Garder la trace des décisions : l’agent rédige une courte note d’architecture.
• Prévoir le retour arrière : désactiver une fonction garde ses données.

Ce qu’il ne faut pas faire

• Modifier app/, assets/, index.php ou l’updater : une mise à jour écraserait tout.
• Activer une fonction qui n’a pas passé le validateur et les tests.
• Mettre en production un panier, un espace membre ou un forum tant que le noyau n’en fournit pas le contrat.
• Croire qu’un score SEO, GEO ou Lighthouse est garanti : ce sont des mesures à refaire.
• Donner à l’agent des secrets en clair : ils vont dans data/ext/<id>/secrets.php.

Comment créer ton propre skill ?

skills/eclair-mon-metier/
├── SKILL.md
└── references/
    ├── acceptance.md
    └── native-contract.md

1. Crée un dossier skills/eclair-<nom>/ avec un fichier SKILL.md.
2. En tête du fichier, indique name et une description qui dit quand l’utiliser : c’est ce que lit l’agent pour décider.
3. Rédige le diagnostic obligatoire, la procédure, les livrables, les invariants de sécurité et les critères d’acceptation.
4. Ajoute tes documents utiles dans references/ : un skill doit être autonome.
5. Déclare-le dans catalog.json, puis lance python3 scripts/validate_skills.py et python3 scripts/check_release.py --write.
6. Teste-le sur un vrai projet, puis propose-le à la bibliothèque par une pull request.

Que faire si quelque chose bloque ?

Le validateur refuse le paquet : Lis le message JSON : il indique le fichier ou le champ du manifeste en cause. Corrige, puis relance la validation.

L’agent veut modifier le noyau : Refuse et rappelle la règle : tout doit vivre dans site/. S’il manque une capacité, demande une RFC et un test bloquant.

Une capacité manque (comptes clients, paiement…) : C’est normal pour certaines familles : garde la conception et les tests, et attends que le noyau ouvre le contrat.

Voir la bibliothèque sur GitHub

Les 57 skills, famille par famille