Skill: Agent Plugin Doctor (Diagnose für Agent-Plugins)
Dieses Skill bietet Diagnose- und Validierungsfunktionen für Agent-Plugins.
Laufzeitanforderungen
Die Installation dieses Skills installiert nicht die Doctor-CLI. Doctor ist ein
eigenständiges npm-Paket (@agent-plugins-doctor/cli, als Binary
agent-plugins-doctor verfügbar), das dieses Skill über das Terminal aufruft:
- Bun —
bunx agent-plugins-doctor check <Plugin-Verzeichnis> - npm —
npx agent-plugins-doctor check <Plugin-Verzeichnis>
bunx/npx holen die CLI bei der ersten Verwendung aus der npm-Registry und führen sie aus —
es sind kein Source-Checkout, Workspace-Build oder eine globale Installation erforderlich.
Es muss mindestens Bun oder npm installiert, im PATH verfügbar und in der Lage sein, die
npm-Registry zu erreichen. Ist keines davon verfügbar, schlagen die folgenden Befehle mit
einem „Befehl nicht gefunden“-Fehler fehl.
Wann verwenden
Verwenden Sie dieses Skill, wenn Benutzer fragen:
- „Warum funktioniert mein Agent-Plugin nicht?“
- „Überprüfe dieses Agent-Plugin“
- „Repariere dieses Plugin“
- „Ist dieses Plugin mit Cursor/Codex/VS Code kompatibel?“
- „Prüfe dieses Agent-Plugin“
- „Validiere dieses Plugin“
Verwendung
Führen Sie die Doctor-CLI zur Plugin-Validierung aus:
# Ein Plugin prüfen
bunx agent-plugins-doctor check <Plugin-Verzeichnis>
# Sichere Korrekturen anwenden
bunx agent-plugins-doctor fix <Plugin-Verzeichnis>
# Einen Bericht erstellen
bunx agent-plugins-doctor report <Plugin-Verzeichnis> --format markdown
# Kompatibilität prüfen
bunx agent-plugins-doctor compatibility <Plugin-Verzeichnis>
(npx agent-plugins-doctor ... funktioniert unter npm identisch.)
Was geprüft wird
Doctor validiert:
- Plugin-Manifest (plugin.json) gegen das offizielle Schema
- Skill-Definitionen (SKILL.md-Dateien) auf Korrektheit
- MCP-Server-Konfigurationen (mcp.json) auf Gültigkeit
- Sicherheitsaspekte (Geheimnisse, Path-Traversal, Symlink-Escapes)
- Kompatibilität mit verifizierten Clients (VS Code, Cursor, GitHub Copilot, ChatGPT & Codex, Kiro)
Ausgabe
Doctor liefert:
- Klare Fehlermeldungen mit Diagnosecodes
- Dateipfade
- Erläuterungen, was falsch ist und warum
- Sichere automatische Korrekturen, wo möglich
- Kompatibilitätsberichte für alle verifizierten Clients
Beispiele
# Aktuelles Verzeichnis validieren
bunx agent-plugins-doctor check .
# Probleme in einem Plugin beheben
bunx agent-plugins-doctor fix ./my-plugin
# Einen Markdown-Bericht erstellen
bunx agent-plugins-doctor report ./my-plugin --format markdown > report.md
# Kompatibilität mit einem bestimmten Client prüfen
bunx agent-plugins-doctor compatibility ./my-plugin --client cursor