--- title: "Skills : le guide" description: "Le guide des skills Éclair : prérequis, installation, prompt de départ, portes de qualité, ce qu’il faut faire et éviter, et comment créer ton propre skill." url: "https://eclaircms.org/documentation/skills" lang: "fr" author: "Thierry Gustin" published: "2026-11-08" updated: "2026-11-10" --- # Skills : le guide > **L’essentiel** — Ce guide explique pas à pas comment utiliser les skills Éclair : installer la bibliothèque dans ton projet, lancer un agent avec le bon prompt, suivre les sept portes de qualité avant toute activation, éviter les erreurs courantes et créer tes propres skills. Il s’adresse aux personnes qui veulent ajouter une fonction à un site Éclair 2.0 avec Claude Code, Codex ou ChatGPT. Les 57 skills Éclair, répartis en 8 familles, aident ton assistant IA à ajouter une fonction à ton site [Éclair 2.0](https://eclaircms.org/telecharger) 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](https://eclaircms.org/documentation/mise-a-jour). ## 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](https://github.com/Jacckisback/eclair-skills) (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/`. ```bash 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 ``` > **Astuce** — Commence par la famille `foundation` : ses huit skills fixent les règles communes (architecture, stockage, droits, routes, cache, sécurité, tests) dont tous les autres dépendent. ## 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 : ```text 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// sans modifier le noyau. Avant de proposer l’activation, exécute php tools/validate.php --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. | Porte | Ce qui est vérifié | | --- | --- | | 0 | Version d’Éclair, commit et capacités réelles du site (API capabilities) | | 1 | Paquet rangé dans site/extensions/<id>/, manifeste eclair-extension/1, empreintes des fichiers, noyau intact | | 2 | Validateur officiel : php tools/validate.php <dossier> --json renvoie valid: true | | 3 | Suite de tests complète : php tests/run.php | | 4 | Budgets de performance : php tools/measure.php --check | | 5 | Tests de sécurité négatifs, droits par objet, cache privé isolé, sauvegarde et restauration | | 6 | Relecture humaine, activation depuis l’administration et retour arrière testé | ## 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//secrets.php`. ## Comment créer ton propre skill ? ```text skills/eclair-mon-metier/ ├── SKILL.md └── references/ ├── acceptance.md └── native-contract.md ``` 1. Crée un dossier `skills/eclair-/` 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. ## Questions sur l’utilisation des skills ### Où sont installés les skills ? Dans le dossier `.agents/skills/` de ton projet. Pour Claude Code, copie-les dans `.claude/skills/`. ### Puis-je installer un seul skill ? Oui, avec `--skill eclair-`. Tu peux répéter l’option pour en installer plusieurs. ### Comment mettre à jour un skill ? Télécharge la nouvelle version de la bibliothèque, relis les changements, puis réinstalle avec `--force`. ### Les skills fonctionnent-ils sans connexion à mon site en ligne ? Oui. Ils travaillent sur ta copie du projet ; c’est même recommandé. [Voir la bibliothèque sur GitHub](https://github.com/Jacckisback/eclair-skills) [Les 57 skills, famille par famille](https://eclaircms.org/skills)