Was macht agent-skills-authoring?
Führt Agenten durch die Erstellung, Validierung und Optimierung von Agent Skills (SKILL.md-Dateien) aus Benutzeranfragen.
Übersicht
Diese Skill-Anleitung ermöglicht es KI-Agenten, aus unstrukturierten Benutzeranfragen professionelle, wiederholbare und gut dokumentierte Agent Skills zu generieren. Sie deckt den gesamten Lebenszyklus ab: von der Analyse der Anforderung über den Entwurf, die Validierung bis zur finalen Optimierung.
Workflow
- Anfrage analysieren – Erfasse die Absicht des Benutzers (z. B. „Tool zum Suchen von GitHub-Repos“).
- Skill skizzieren – Lege Namen, Beschreibung, Eingaben, Ausgaben und Aktionen fest.
- Entwurf erstellen – Formuliere die SKILL.md mit Standard-Sektionen (
Name,Description,Usage,Configuration). - Validieren – Prüfe mit folgender Checkliste:
- Name ist eindeutig und beschreibend
- Beschreibung fasst den Zweck in 1–2 Sätzen zusammen
- Nutzungshinweise sind konkret und für den Agenten ausführbar
- Konfiguration (z. B. API-Keys, Umgebungsvariablen) ist dokumentiert
- Optimieren – Stelle sicher, dass die SKILL.md klar, präzise und konsistent mit dem Agenten-Framework (Claude Code, Cursor, Codex) ist.
Verwendung
Starte den Prozess mit einem Befehl wie:
Erstelle eine SKILL.md für einen Agenten, der automatisch Codekommentare auf Deutsch übersetzt.
Der Agent erzeugt dann Schritt für Schritt eine vollständige SKILL.md, die der Benutzer speichern und in seinem bevorzugten Tool verwenden kann.
Validierungskriterien
- Lesbarkeit: Die Datei muss für Menschen und Maschinen verständlich sein.
- Ausführbarkeit: Der beschriebene Skill muss durch einen Agenten ausführbar sein (z. B. CLI-Befehle, API-Aufrufe, Dateioperationen).
- Wartbarkeit: Vermeide übermäßige Länge und redundante Informationen.
Hinweise
- Verwende
#für den Titel und##für Abschnitte. - Codeblöcke bitte mit dreifachen Backticks kennzeichnen (```).
- Verweise auf externe Ressourcen (Links, APIs) sollten als absolute URLs angegeben werden.
Beispiel
# code-comment-translator
Übersetzt Codekommentare aus einem Repository in die gewünschte Zielsprache.
## Verwendung
```bash
agent-skills run code-comment-translator --source . --target de
Konfiguration
OPENAI_API_KEY– API-Schlüssel für Übersetzungsdienste.
## Lizenz
MIT