skills.md +33 −33
644Plugin-Skills sind nicht von `skillOverrides` betroffen. Verwalten Sie diese stattdessen über `/plugin`.644Plugin-Skills sind nicht von `skillOverrides` betroffen. Verwalten Sie diese stattdessen über `/plugin`.
645 645
646<h2 id="evaluate-and-iterate-on-a-skill">646<h2 id="evaluate-and-iterate-on-a-skill">
647 Evaluieren und iterieren Sie einen Skill
648</h2>
649
650Zu sehen, dass ein Skill ausgelöst wird, sagt Ihnen, dass Claude ihn gefunden hat, nicht dass er das tat, was Sie beabsichtigten. Um zu wissen, dass ein Skill funktioniert, messen Sie zwei Dinge separat: ob Claude ihn auf den Eingaben aufruft, die er sollte, und ob die Ausgabe dem entspricht, was Sie erwarten, wenn er es tut.
651
652Die Überprüfung für beide ist ein Baseline-Vergleich. Sammeln Sie ein paar realistische Eingaben, führen Sie jede in einer neuen Sitzung mit dem verfügbaren Skill aus und erneut mit ihm [deaktiviert](#override-skill-visibility-from-settings), und vergleichen Sie die Ergebnisse. Eine neue Sitzung ist wichtig, da übrig gebliebener Kontext aus der Erstellung des Skills Lücken in den geschriebenen Anweisungen maskiert.
653
654<h3 id="run-evals-with-skill-creator">
655 Führen Sie Evals mit skill-creator aus
656</h3>
657
658Das [`skill-creator`-Plugin](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/skill-creator) automatisiert die Vergleichsschleife in Claude Code. Installieren Sie es aus dem offiziellen Marketplace:
659
660```text theme={null}
661/plugin install skill-creator@claude-plugins-official
662```
663
664Wenn Claude Code meldet, dass das Plugin in keinem Marketplace gefunden wird, fehlt Ihr Marketplace entweder oder ist veraltet. Führen Sie `/plugin marketplace update claude-plugins-official` aus, um es zu aktualisieren, oder `/plugin marketplace add anthropics/claude-plugins-official`, wenn Sie es noch nicht hinzugefügt haben. Versuchen Sie dann erneut zu installieren.
665
666Nach der Installation führen Sie `/reload-plugins` aus, um die Skills des Plugins in der aktuellen Sitzung verfügbar zu machen. Bitten Sie dann Claude, einen vorhandenen Skill zu evaluieren, zum Beispiel `evaluate my summarize-changes skill with skill-creator`. Das Plugin führt Sie durch das Schreiben von Testfällen und führt die Schleife aus:
667
668* **Testfälle**: speichert Eingaben, Eingabedateien und erwartetes Verhalten in `evals/evals.json` im Skill-Verzeichnis
669* **Isolierte Läufe**: spawnt einen [Subagent](/de/sub-agents) pro Testfall, sodass jeder Lauf mit einem sauberen Kontext beginnt, und zeichnet Token-Anzahl und Dauer auf
670* **Bewertung**: überprüft jede Assertion gegen die Ausgabe und schreibt Pass oder Fail mit Beweis in `grading.json`
671* **Benchmark**: aggregiert Pass-Rate, Zeit und Token für mit-Skill versus ohne-Skill in `benchmark.json`, sodass Sie die Pass-Rate-Verbesserung gegen den Token- und Zeit-Overhead vergleichen können
672* **Versionsvergleich**: führt einen blinden A/B zwischen zwei Versionen des Skills durch, sodass Sie bestätigen können, dass eine Bearbeitung eine Verbesserung ist, bevor Sie sie committen
673* **Beschreibungsabstimmung**: generiert sollte-auslösen und sollte-nicht-auslösen Eingaben, misst die Hit-Rate und schlägt Beschreibungsbearbeitungen vor, wenn der Skill auf den falschen Anfragen aktiviert wird
674* **Review-Viewer**: öffnet einen HTML-Bericht, in dem Sie jede Ausgabe überprüfen und qualitatives Feedback aufzeichnen, das die nächste Iteration liest
675
676Für das Eval-Dateiformat und den vollständigen Iterations-Workflow siehe [Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills) auf agentskills.io. Für Hintergrund zum Benchmark- und Vergleichsmodus siehe die [skill-creator-Ankündigung](https://claude.com/blog/improving-skill-creator-test-measure-and-refine-agent-skills).
677
678<h2 id="share-skills">
647 Skills teilen679 Skills teilen
648</h2>680</h2>
649 681
653* **Plugins**: Erstellen Sie ein `skills/`-Verzeichnis in Ihrem [Plugin](/de/plugins)685* **Plugins**: Erstellen Sie ein `skills/`-Verzeichnis in Ihrem [Plugin](/de/plugins)
654* **Verwaltet**: Stellen Sie organisationsweit über [verwaltete Einstellungen](/de/settings#settings-files) bereit686* **Verwaltet**: Stellen Sie organisationsweit über [verwaltete Einstellungen](/de/settings#settings-files) bereit
655 687
656688<h3 id="run-evals-with-skill-creator"><h3 id="generate-visual-output">
657 Visuelle Ausgabe generieren689 Visuelle Ausgabe generieren
658</h3>690</h3>
659 691
846 878
847Dieses Muster funktioniert für jede visuelle Ausgabe: Abhängigkeitsgraphen, Test-Coverage-Berichte, API-Dokumentation oder Datenbankschema-Visualisierungen. Das gebündelte Script erledigt die schwere Arbeit, während Claude die Orchestrierung übernimmt.879Dieses Muster funktioniert für jede visuelle Ausgabe: Abhängigkeitsgraphen, Test-Coverage-Berichte, API-Dokumentation oder Datenbankschema-Visualisierungen. Das gebündelte Script erledigt die schwere Arbeit, während Claude die Orchestrierung übernimmt.
848 880
849<h2 id="share-skills">
850 Evaluieren und iterieren Sie einen Skill
851</h2>
852
853Zu sehen, dass ein Skill ausgelöst wird, sagt Ihnen, dass Claude ihn gefunden hat, nicht dass er das tat, was Sie beabsichtigten. Um zu wissen, dass ein Skill funktioniert, messen Sie zwei Dinge separat: ob Claude ihn auf den Eingaben aufruft, die er sollte, und ob die Ausgabe dem entspricht, was Sie erwarten, wenn er es tut.
854
855Die Überprüfung für beide ist ein Baseline-Vergleich. Sammeln Sie ein paar realistische Eingaben, führen Sie jede in einer neuen Sitzung mit dem verfügbaren Skill aus und erneut mit ihm [deaktiviert](#override-skill-visibility-from-settings), und vergleichen Sie die Ergebnisse. Eine neue Sitzung ist wichtig, da übrig gebliebener Kontext aus der Erstellung des Skills Lücken in den geschriebenen Anweisungen maskiert.
856
857<h3 id="generate-visual-output">
858 Führen Sie Evals mit skill-creator aus
859</h3>
860
861Das [`skill-creator`-Plugin](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/skill-creator) automatisiert die Vergleichsschleife in Claude Code. Installieren Sie es aus dem offiziellen Marketplace:
862
863```text theme={null}
864/plugin install skill-creator@claude-plugins-official
865```
866
867Wenn Claude Code meldet, dass das Plugin in keinem Marketplace gefunden wird, fehlt Ihr Marketplace entweder oder ist veraltet. Führen Sie `/plugin marketplace update claude-plugins-official` aus, um es zu aktualisieren, oder `/plugin marketplace add anthropics/claude-plugins-official`, wenn Sie es noch nicht hinzugefügt haben. Versuchen Sie dann erneut zu installieren.
868
869Nach der Installation führen Sie `/reload-plugins` aus, um die Skills des Plugins in der aktuellen Sitzung verfügbar zu machen. Bitten Sie dann Claude, einen vorhandenen Skill zu evaluieren, zum Beispiel `evaluate my summarize-changes skill with skill-creator`. Das Plugin führt Sie durch das Schreiben von Testfällen und führt die Schleife aus:
870
871* **Testfälle**: speichert Eingaben, Eingabedateien und erwartetes Verhalten in `evals/evals.json` im Skill-Verzeichnis
872* **Isolierte Läufe**: spawnt einen [Subagent](/de/sub-agents) pro Testfall, sodass jeder Lauf mit einem sauberen Kontext beginnt, und zeichnet Token-Anzahl und Dauer auf
873* **Bewertung**: überprüft jede Assertion gegen die Ausgabe und schreibt Pass oder Fail mit Beweis in `grading.json`
874* **Benchmark**: aggregiert Pass-Rate, Zeit und Token für mit-Skill versus ohne-Skill in `benchmark.json`, sodass Sie die Pass-Rate-Verbesserung gegen den Token- und Zeit-Overhead vergleichen können
875* **Versionsvergleich**: führt einen blinden A/B zwischen zwei Versionen des Skills durch, sodass Sie bestätigen können, dass eine Bearbeitung eine Verbesserung ist, bevor Sie sie committen
876* **Beschreibungsabstimmung**: generiert sollte-auslösen und sollte-nicht-auslösen Eingaben, misst die Hit-Rate und schlägt Beschreibungsbearbeitungen vor, wenn der Skill auf den falschen Anfragen aktiviert wird
877* **Review-Viewer**: öffnet einen HTML-Bericht, in dem Sie jede Ausgabe überprüfen und qualitatives Feedback aufzeichnen, das die nächste Iteration liest
878
879Für das Eval-Dateiformat und den vollständigen Iterations-Workflow siehe [Evaluating skill output quality](https://agentskills.io/skill-creation/evaluating-skills) auf agentskills.io. Für Hintergrund zum Benchmark- und Vergleichsmodus siehe die [skill-creator-Ankündigung](https://claude.com/blog/improving-skill-creator-test-measure-and-refine-agent-skills).
880
881<h2 id="troubleshooting">881<h2 id="troubleshooting">
882 Fehlerbehebung882 Fehlerbehebung
883</h2>883</h2>