Was macht Agent-Skill-Architecture-Guide?
Ein umfassendes Referenzdokument für die Erstellung und Organisation von KI-Agenten-Skills in Claude Code, KiloCode, OpenClaw und OpenAI Codex. Deckt SKILL.md-Spezifikationen, Ordnerstrukturen, modusbezogene Skills, Agenten-Orchestrierung und Konfiguration selbstgehosteter Modelle ab.
Einleitung
Dieser Leitfaden beschreibt eine standardisierte Architektur für KI-Agenten-Skills, die auf mehreren Plattformen wie Claude Code, KiloCode, OpenClaw und OpenAI Codex funktioniert. Die Struktur ermöglicht es Entwicklern, Skills modular, kontextbezogen und wiederverwendbar zu gestalten.
SKILL.md Spezifikation
Jeder Skill muss eine SKILL.md-Datei im Stammverzeichnis enthalten. Diese Datei beschreibt den Zweck, die Konfiguration und die Nutzungsbedingungen des Skills.
Beispiel-SKILL.md
# Skill-Name
**Beschreibung**: Kurze Beschreibung des Skills.
**Plattformen**: Claude Code, KiloCode
**Modus**: development
**Voraussetzungen**: Node.js >= 18
**Konfiguration**:
- `ENV_VAR`: Beschreibung der Umgebungsvariable
Ordnerstruktur
Empfohlene Ordnerstruktur für einen Skill:
skills/
mein-skill/
SKILL.md
src/
index.js
tests/
test.js
config/
default.json
docs/
usage.md
src/: Enthält den Quellcode des Skills.tests/: Enthält Tests für den Skill.config/: Enthält Konfigurationsdateien.docs/: Enthält zusätzliche Dokumentation.
Modusbezogene Skills
Skills können auf bestimmte Modi beschränkt werden, z. B. development, debugging oder production. Die Angabe erfolgt im Modus-Feld der SKILL.md.
Beispiel
modus: development
Nur wenn der Agent im angegebenen Modus läuft, wird der Skill aktiviert.
Agenten-Orchestrierung
Komplexe Aufgaben können durch mehrere Skills orchestriert werden. Ein Orchestrator-Skill kann andere Skills sequenziell oder parallel aufrufen.
Beispiel-Orchestrator
def orchestrate(task):
if task.type == "refactoring":
run_skill("refactoring-skill")
run_skill("testing-skill")
Selbstgehostete Modelle
Skills können auch mit selbstgehosteten Modellen verwendet werden. Konfigurieren Sie die Modell-URL in der Skill-Konfiguration:
{
"modelUrl": "http://localhost:8080/v1"
}
Plattformunterstützung
| Plattform | Unterstützt |
|---|---|
| Claude Code | Ja |
| KiloCode | Ja |
| OpenClaw | Ja |
| OpenAI Codex | Ja |
Lizenz
Dieses Projekt steht unter der MIT-Lizenz – siehe die LICENSE-Datei für Details.