--- title: "Skills: die Anleitung" description: "Die Anleitung zu den Éclair-Skills: Voraussetzungen, Installation, Start-Prompt, Qualitätsstufen, Dos and Don’ts und eigene Skills erstellen." url: "https://eclaircms.org/de/dokumentation/skills" lang: "de" author: "Thierry Gustin" published: "2026-11-08" updated: "2026-11-10" --- # Skills: die Anleitung > **Das Wichtigste** — Diese Anleitung erklärt Schritt für Schritt, wie du die Éclair-Skills nutzt: die Bibliothek im Projekt installieren, einen Agenten mit dem richtigen Prompt starten, vor jeder Aktivierung die sieben Qualitätsstufen durchlaufen, typische Fehler vermeiden und eigene Skills erstellen. Sie richtet sich an alle, die einer Éclair-2.0-Website mit Claude Code, Codex oder ChatGPT eine Funktion hinzufügen wollen. Die 57 Éclair-Skills in 8 Familien helfen deinem KI-Assistenten, deiner [Éclair-2.0](https://eclaircms.org/de/herunterladen)-Website eine Funktion hinzuzufügen, ohne Funktionierendes zu beschädigen. Installiere sie im Projekt, starte den Agenten mit dem mitgelieferten Prompt und aktiviere nichts vor den 7 Qualitätsstufen. Diese Anleitung beschreibt jeden Schritt und erklärt, wie du eigene Skills schreibst. Mach vorher eine Sicherung, wie in [Updates, Backups und Umzug](https://eclaircms.org/de/dokumentation/updates) beschrieben. ## Was brauchst du, bevor du anfängst? - **Eine Éclair-2.0-Website** und idealerweise eine Arbeitskopie des Codes (das offizielle Repository geklont), damit der Agent die Tests ausführen kann. - **Python 3** zum Installieren und Prüfen der Skills, **PHP 8.1 oder neuer** für die Werkzeuge von Éclair. - **Einen Assistenten, der Skills liest**: zum Beispiel Claude Code oder Codex. - **Eine aktuelle Sicherung**: Sicherheit › Sicherung herunterladen. ## Wie installierst du die Skills im Projekt? 1. Lade die Bibliothek von [GitHub](https://github.com/Jacckisback/eclair-skills) herunter (Code › Download ZIP oder `git clone`). 2. Prüfe in ihrem Ordner mit `python3 scripts/validate_skills.py`, ob sie vollständig ist: Die Meldung muss 57 gültige Skills nennen. 3. Liste Familien und Skills mit `python3 scripts/install_skills.py --list` auf. 4. Installiere, was du brauchst, nach Familie (`--category design`) oder Name (`--skill eclair-seo-audit`), mit `--project /pfad/zu/meiner-website`. 5. Für Claude Code kopierst du die installierten Ordner von `.agents/skills/` nach `.claude/skills/`. ```bash python3 scripts/validate_skills.py python3 scripts/install_skills.py --list python3 scripts/install_skills.py --project /pfad/zu/meiner-website --category foundation python3 scripts/install_skills.py --project /pfad/zu/meiner-website --skill eclair-wordpress-migration python3 scripts/install_skills.py --project /pfad/zu/meiner-website --all ``` > **Tipp** — Beginne mit der Familie `foundation`: Ihre acht Skills legen die gemeinsamen Regeln fest (Architektur, Speicherung, Rechte, Routen, Cache, Sicherheit, Tests), auf denen alle anderen aufbauen. ## Wie startest du den Agenten mit dem richtigen Prompt? Öffne deinen Assistenten im Projektordner und gib ihm einen klaren Start-Prompt. Dieser liegt der Bibliothek bei: ```text Analysiere dieses Éclair-CMS-Projekt, beginnend mit eclair/index.php und docs/SKILLS-GUIDE.md. Nutze die Skills eclair-architecture, eclair-extension-builder, eclair-security-audit und eclair-test-suite. Beschreibe die gewünschte Funktion anhand der nativen Fähigkeiten von eclair-extension/1. Lege die Dateien der Erweiterung unter site/extensions// an, ohne den Kern zu ändern. Bevor du die Aktivierung vorschlägst, führe php tools/validate.php --json, php tests/run.php und php tools/measure.php --check aus. Fehlt eine Fähigkeit, stoppe diesen Teil und erstelle einen RFC und Tests; erfinde keine API. ``` Ergänze dann deine Anfrage in ein, zwei Sätzen, mit den Vorgaben, die dir wichtig sind: Zielgruppe, Sprachen, Umfang, personenbezogene Daten. ## Welche Prüfungen vor der Aktivierung einer Funktion? Die Bibliothek definiert sieben Qualitätsstufen. Eine Funktion wird erst aktiviert, wenn alle bestanden sind. | Stufe | Was geprüft wird | | --- | --- | | 0 | Éclair-Version, Commit und echte Fähigkeiten der Website (Capabilities-API) | | 1 | Paket in site/extensions/<id>/, Manifest eclair-extension/1, Datei-Prüfsummen, Kern unverändert | | 2 | Offizieller Validator: php tools/validate.php <ordner> --json liefert valid: true | | 3 | Vollständige Testsuite: php tests/run.php | | 4 | Leistungsbudgets: php tools/measure.php --check | | 5 | Negative Sicherheitstests, Rechte pro Objekt, isolierter privater Cache, Sicherung und Wiederherstellung | | 6 | Menschliche Durchsicht, Aktivierung in der Verwaltung und getestete Rücknahme | ## Was du tun solltest - Den fachlichen Bedarf beschreiben, nicht die Technik: Der Agent wählt die Skills. - Den Agenten die Fähigkeiten der Website lesen lassen, bevor er Code schreibt. - Auf einer Kopie der Website testen, nie direkt in Produktion. - Entscheidungen festhalten: Der Agent schreibt eine kurze Architekturnotiz. - Die Rücknahme einplanen: Das Deaktivieren einer Funktion behält ihre Daten. ## Was du lassen solltest - `app/`, `assets/`, `index.php` oder den Updater ändern: Ein Update würde alles überschreiben. - Eine Funktion aktivieren, die Validator und Tests nicht bestanden hat. - Einen Warenkorb, Mitgliederbereich oder ein Forum in Produktion nehmen, solange der Kern den Vertrag nicht liefert. - Glauben, ein SEO-, GEO- oder Lighthouse-Wert sei garantiert: Das sind Messungen, die man wiederholt. - Dem Agenten Geheimnisse im Klartext geben: Sie gehören in `data/ext//secrets.php`. ## Wie erstellst du einen eigenen Skill? ```text skills/eclair-meine-branche/ ├── SKILL.md └── references/ ├── acceptance.md └── native-contract.md ``` 1. Lege einen Ordner `skills/eclair-/` mit einer Datei `SKILL.md` an. 2. Setze am Dateianfang `name` und eine `description`, die sagt, wann er zu nutzen ist: Das liest der Agent, um zu entscheiden. 3. Schreibe die Pflichtdiagnose, das Vorgehen, die Ergebnisse, die Sicherheitsregeln und die Abnahmekriterien. 4. Lege deine nützlichen Dokumente in `references/` ab: Ein Skill muss eigenständig sein. 5. Trage ihn in `catalog.json` ein und führe `python3 scripts/validate_skills.py` sowie `python3 scripts/check_release.py --write` aus. 6. Teste ihn an einem echten Projekt und schlage ihn der Bibliothek per Pull Request vor. ## Was tun, wenn etwas hakt? **Der Validator lehnt das Paket ab**: Lies die JSON-Meldung: Sie nennt die betroffene Datei oder das Manifestfeld. Korrigiere und prüfe erneut. **Der Agent will den Kern ändern**: Lehne ab und erinnere an die Regel: Alles gehört nach site/. Fehlt eine Fähigkeit, verlange einen RFC und einen blockierenden Test. **Eine Fähigkeit fehlt (Kundenkonten, Zahlung …)**: Das ist bei manchen Familien normal: Behalte Konzept und Tests und warte, bis der Kern den Vertrag öffnet. ## Fragen zur Nutzung der Skills ### Wo werden die Skills installiert? Im Ordner `.agents/skills/` deines Projekts. Für Claude Code kopierst du sie nach `.claude/skills/`. ### Kann ich einen einzelnen Skill installieren? Ja, mit `--skill eclair-`. Du kannst die Option wiederholen, um mehrere zu installieren. ### Wie aktualisiere ich einen Skill? Lade die neue Version der Bibliothek, prüfe die Änderungen und installiere mit `--force` neu. ### Funktionieren die Skills ohne Verbindung zur Live-Website? Ja. Sie arbeiten mit deiner Projektkopie; das ist sogar empfohlen. [Bibliothek auf GitHub ansehen](https://github.com/Jacckisback/eclair-skills) [Die 57 Skills, Familie für Familie](https://eclaircms.org/de/skills)