Fünf Schritte zur Erstellung eines Skills
Eine Schritt-für-Schritt-Anleitung zur Erstellung Ihres ersten Agent Skills.
Schritt 1: Identifizieren Sie Ihren Kernbedarf
Bevor Sie Inhalte schreiben, definieren Sie klar:
- Problem: Welche Herausforderung löst Ihr Skill?
- Zielgruppe: Wer wird diesen Skill verwenden?
- Umfang: Was sollte der Skill abdecken (und was nicht)?
Zu beantwortende Fragen
- Welche Aufgaben wird die KI mit diesem Skill ausführen?
- Welches Fachwissen ist erforderlich?
- Welche Verhaltensweisen sollte die KI zeigen?
- Welche häufigen Fehler sollten vermieden werden?
Beispiel
Problem: Entwickler benötigen konsistentes Code-Review-Feedback Zielgruppe: Entwicklungsteams, die Pull Requests verwenden Umfang: Codequalität, Sicherheit und Stil - nicht Projektmanagement
Schritt 2: Schreiben Sie das Namensfeld
Der Name Ihres Skills sollte:
- Beschreibend: Klar angeben, was der Skill macht
- Prägnant: Maximal 3-5 Wörter
- Einzigartig: Sich von ähnlichen Skills unterscheiden
Gute Namen
- "React-Komponenten-Richtlinien"
- "API-Sicherheitsprüfer"
- "Markenstimmen-Leitfaden"
Schlechte Namen
- "Mein Skill" (nicht beschreibend)
- "Der ultimative vollständige Entwicklungsleitfaden für alles" (zu lang)
- "Helfer" (nicht spezifisch)
Schritt 3: Schreiben Sie die Beschreibung
Die Beschreibung erscheint in Suchergebnissen und Skill-Karten. Machen Sie sie aussagekräftig:
- Erste 100 Zeichen: Am wichtigsten - werden in Vorschauen angezeigt
- Schlüsselwörter einbeziehen: Helfen Benutzern, Ihren Skill zu finden
- Spezifisch sein: Hauptfunktionen oder Anwendungsfälle erwähnen
Vorlage
[Aktion] für [Zielgruppe], die [Hauptvorteil]. Deckt [Hauptfunktionen] ab.
Beispiel
Code-Review-Richtlinien für Entwicklungsteams, die konsistentes,
hochwertiges Feedback gewährleisten. Deckt Sicherheits-, Leistungs- und Stilprüfungen ab.
Schritt 4: Schreiben Sie den Hauptinhalt
Strukturieren Sie Ihren Inhalt für Klarheit und Effektivität:
Kontextabschnitt
Geben Sie Hintergrundinformationen:
markdown
## Kontext
Dieser Skill hilft KI-Assistenten, Code mit Fokus auf:
- Sicherheitslücken
- Leistungsoptimierung
- Code-Stil-Konsistenz
- Einhaltung von Best Practices
zu überprüfen.
Richtlinienabschnitt
Listen Sie spezifische Regeln auf:
markdown
## Richtlinien
1. Immer auf Eingabevalidierung prüfen
2. Nach potenzieller SQL-Injection suchen
3. Überprüfen, ob Fehlerbehandlung existiert
4. Auf hartcodierte Anmeldedaten prüfen
5. Logging-Praktiken überprüfen
Beispielabschnitt
Zeigen Sie erwartetes Verhalten:
markdown
## Beispiele
### Sicherheits-Review-Kommentar
"Erwägen Sie hier parametrisierte Abfragen zu verwenden, um SQL-Injection zu verhindern.
Die aktuelle String-Verkettung ist anfällig für bösartige Eingaben."
### Leistungs-Review-Kommentar
"Diese Schleife iteriert für jedes Element über das gesamte Array.
Erwägen Sie die Verwendung eines Sets oder einer Map für O(1)-Lookups statt O(n)."
Schritt 5: Hochladen und Testen
Repository erstellen
- Gehen Sie zu GitHub und erstellen Sie ein neues Repository
- Fügen Sie Ihre
SKILL.md-Datei zum Stammverzeichnis hinzu - Machen Sie das Repository öffentlich
Beim Marktplatz einreichen
- Besuchen Sie /submit auf dem Marktplatz
- Geben Sie Ihre Repository-URL ein
- Klicken Sie auf "Einreichen"
Skill testen
Nach dem Einreichen:
- Installieren Sie den Skill auf Ihrer bevorzugten Plattform
- Testen Sie mit verschiedenen Prompts
- Überprüfen Sie, ob die KI Ihren Richtlinien folgt
- Iterieren und verbessern Sie basierend auf den Ergebnissen
Test-Checkliste
Vor der Veröffentlichung testen Sie diese Szenarien:
Normaler Betrieb
- [ ] KI folgt den Hauptrichtlinien korrekt
- [ ] Beispiele werden angemessen angewendet
- [ ] Ton und Stil entsprechen den Erwartungen
Grenzfälle
- [ ] Behandelt ungewöhnliche Eingaben elegant
- [ ] Konfligiert nicht mit anderen Skills
- [ ] Funktioniert auf allen unterstützten Plattformen
Außerhalb des Umfangs
- [ ] KI verweist bei unverwandten Themen korrekt weiter
- [ ] Überschreitet Skill-Grenzen nicht
- [ ] Behandelt Anfragen außerhalb des Umfangs elegant
Nächste Schritte
- SKILL.md Format - Vollständige Formatreferenz
- Best Practices - Tipps für effektive Skills
- Beispiele - Lernen Sie von bestehenden Skills