riqxa/skills-best-practices

Was macht skills-best-practices?

Bietet klare Richtlinien zum Erstellen, Validieren und Organisieren effizienter Agent-Fähigkeiten mit fokussiertem Kontextmanagement.

Übersicht

Dieses Skill definiert bewährte Methoden für die Entwicklung von Agent-Fähigkeiten, die:

• Kontextbewusst sind: Reduzierung von Token-Overhead durch fokussiertes Kontextmanagement
• Modular aufgebaut sind: Klare Trennung von Verantwortlichkeiten und Wiederverwendbarkeit
• Validierbar sind: Strukturierte Prüfungen zur Sicherstellung der Qualität

Warum Skills-Best-Practices?

• Effizienzsteigerung: Optimierte Skills verbrauchen weniger Tokens und arbeiten schneller
• Konsistenz: Einheitliche Struktur und Namenskonventionen erleichtern die Zusammenarbeit
• Wartbarkeit: Klare Richtlinien reduzieren technische Schulden und verbessern die Lesbarkeit
• Skalierbarkeit: Modular aufgebaute Skills lassen sich leichter erweitern und kombinieren

Richtlinien

Namenskonventionen

• Skill-Name: {author}/{skill-name} (z. B. riqxa/skills-best-practices)
• Keine Sonderzeichen: Verwende nur Kleinbuchstaben, Zahlen und Bindestriche
• Eindeutigkeit: Der Name sollte den Zweck des Skills klar widerspiegeln

Modulorganisation

• Hauptdatei: SKILL.md im Stammverzeichnis
• Hilfsdateien: Nutze Unterverzeichnisse für Hilfsskripte, Vorlagen oder Konfigurationen
• Trennung von Belangen: Jede Fähigkeit sollte eine klar abgegrenzte Aufgabe erfüllen

Implementierungsmuster

• Klarer Zweck: Jeder Skill sollte eine präzise Beschreibung seines Zwecks enthalten
• Eingabe/Ausgabe: Definiere klare Schnittstellen für die Kommunikation mit dem Agenten
• Kontextmanagement: Minimiere den Kontextbedarf durch gezielte, relevante Informationen
• Fehlerbehandlung: Implementiere robuste Fehlerbehandlung und Fallback-Mechanismen

Validierung

• Syntaxprüfung: Stelle sicher, dass Markdown und Code gültig sind
• Funktionstests: Teste die Skill-Funktionalität mit verschiedenen Eingaben
• Kontextüberprüfung: Analysiere den Token-Verbrauch und optimiere bei Bedarf

Beispiel

# mein/beispiel-skill

Kurze Beschreibung des Skills.

## Verwendung

- **Zweck**: Automatische Formatierung von Texten
- **Eingabe**: Rohtext als String
- **Ausgabe**: Formatierter Text

## Implementierung

Hier die Logik des Skills

Plattformunterstützung

• Claude Code: Vollständig unterstützt
• Cursor: Teilweise unterstützt (Kontextmanagement optimiert)
• Codex: Grundlegende Kompatibilität

Lizenz

MIT