Éclair CMS
Hauptmenü
Gesamte Dokumentation

Skills: die Anleitung

Die Anleitung zu den Éclair-Skills: Voraussetzungen, Installation, Start-Prompt, Qualitätsstufen, Dos and Don’ts und eigene Skills erstellen.

Aktualisiert am 3 Min. Lesezeit

Inhalt
  1. Was brauchst du, bevor du anfängst?
  2. Wie installierst du die Skills im Projekt?
  3. Wie startest du den Agenten mit dem richtigen Prompt?
  4. Welche Prüfungen vor der Aktivierung einer Funktion?
  5. Was du tun solltest
  6. Was du lassen solltest
  7. Wie erstellst du einen eigenen Skill?
  8. Was tun, wenn etwas hakt?
  9. Fragen zur Nutzung der Skills

Die 57 Éclair-Skills in 8 Familien helfen deinem KI-Assistenten, deiner Éclair-2.0-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 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 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/.
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

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:

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/<id>/ an, ohne den Kern zu ändern. Bevor du die Aktivierung vorschlägst, führe php tools/validate.php <erweiterung> --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.

StufeWas geprüft wird
0Éclair-Version, Commit und echte Fähigkeiten der Website (Capabilities-API)
1Paket in site/extensions/<id>/, Manifest eclair-extension/1, Datei-Prüfsummen, Kern unverändert
2Offizieller Validator: php tools/validate.php <ordner> --json liefert valid: true
3Vollständige Testsuite: php tests/run.php
4Leistungsbudgets: php tools/measure.php --check
5Negative Sicherheitstests, Rechte pro Objekt, isolierter privater Cache, Sicherung und Wiederherstellung
6Menschliche 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/<id>/secrets.php.

Wie erstellst du einen eigenen Skill?

skills/eclair-meine-branche/
├── SKILL.md
└── references/
    ├── acceptance.md
    └── native-contract.md
  1. Lege einen Ordner skills/eclair-<name>/ 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-<name>. 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

Die 57 Skills, Familie für Familie