/ Verzeichnis / Playground / skill-doctor
← Alle Server ↗ GitHub
● Community marian2js ⚡ Sofort

skill-doctor

von marian2js · marian2js/skill-doctor

Überprüfen Sie Ihre Claude-Fähigkeiten vor dem Versenden – Frontmatter, Ressourcenrefs, Trigger-Klarheit, Bewertung der Hygiene, Bewertung von 0–100 mit Schweregraden.

Skill-Doctor ist eine CLI, die ein lokales Skill-Paket scannt und Probleme meldet, die die Aktivierung, Zuverlässigkeit oder Qualität beeinträchtigen. Es überprüft YAML-Frontmatter und Metadaten, stellt sicher, dass Ressourcenverweise intakt sind, wertet Triggerbeschreibungen auf Klarheit aus und validiert „evals/evals.json“. Das Ergebnis ist eine Bewertung von 0 bis 100 mit Befunden, die mit dem Schweregrad gekennzeichnet sind. unterstützt Text-, JSON- und Nur-Score-Modi – perfekt für Pre-Commit, Pre-Route oder CI-Gating.

▶ Demo ansehen 📦 Installieren 💡 Anwendungsfälle

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

skill-doctor-skill.replay ▶ bereit
0/0

Installation

Repository des Autors · Offizielle Dokumentation zu Claude Skills

Anwendungsfälle

Praxisnahe Nutzung: skill-doctor

Verbessern Sie Ihre Fähigkeiten, bevor Sie sie auf einem Marktplatz veröffentlichen

👤 Skill-Autoren sind dabei, einen SKILL.md zu teilen ⏱ ~15 min beginner

Wann einsetzen: Sie haben eine Fertigkeit abgeschlossen und möchten einen Sanity Pass, bevor jemand anderes sie installiert.

Voraussetzungen
  • Knoten 18+ — NVM-Installation 18
Ablauf
  1. Lass den Arzt laufen
    Führen Sie den Skill-Doctor im Skill-Root aus.✓ Kopiert
    → Bewertung + Liste der Befunde nach Schweregrad
  2. Beheben Sie Elemente mit hohem Schweregrad
    Beheben Sie zunächst schwerwiegende Probleme. Wiederholen, bis die Punktzahl ≥ 85 ist.✓ Kopiert
    → Punkte steigen; Kritikpunkte verschwinden

Ergebnis: Eine Fertigkeit, die aktiviert wird, wenn Sie es erwarten, und die keine fehlerhaften Referenzen aufweist.

Fallstricke
  • Auf der Suche nach den perfekten 100 — Artikel mit geringem Schweregrad (Stielnissen) sind oft in Ordnung; Konzentrieren Sie sich auf Auslöser und Ressourcen
Kombinieren mit: oaustegard-claude-skills

Erstellen Sie ein Kompetenz-Repo mit einem minimalen Qualitätsfaktor in CI

👤 Teams pflegen mehrere Fähigkeiten in einem Repo ⏱ ~30 min intermediate

Wann einsetzen: Sie versenden Ihre Fertigkeiten häufig und möchten Abdrift verhindern.

Voraussetzungen
  • GitHub-Aktionen (oder gleichwertig) — Repo mit .github/workflows/
Ablauf
  1. Fügen Sie den Workflow hinzu
    Fügen Sie einen GH Actions-Job hinzu, der „skill-doctor“ ausführt und bei einem Score < 80 fehlschlägt.✓ Kopiert
    → Workflow-Datei hinzugefügt; läuft auf PR
  2. Legen Sie die Strenge pro Pfad fest
    Produktionsfähigkeiten versagen < 90; Tiefgänge erlauben < 70.✓ Kopiert
    → Matrix- oder bedingte Schwellenwerte im Workflow

Ergebnis: PRs, die die Fähigkeitsqualität verschlechtern, werden vor der Zusammenführung abgefangen.

Fallstricke
  • Die Stange zu früh zu hoch verriegeln — Beginnen Sie mit einer lockeren Behandlung und verschärfen Sie sie im Laufe von 2–3 Monaten, sobald die Ergebnisse behoben sind
Kombinieren mit: agent-skills-cli-skill

Diagnostizieren Sie, warum eine Fertigkeit nicht aktiviert wird

👤 Skill-Benutzer mit Aktivierungsproblemen ⏱ ~15 min beginner

Wann einsetzen: Du hast einen Skill installiert, aber Claude löst ihn nie aus.

Ablauf
  1. Bearbeiten Sie die Beschreibung
    Schreiben Sie die Beschreibung so um, dass die konkreten Schlüsselwörter für die Benutzeraufgabe darin vorkommen.✓ Kopiert
    → Der Schweregrad der Triggerklarheit sinkt

Ergebnis: Klarere Aktivierung; Claude wählt die Fähigkeiten für die richtigen Aufgaben aus.

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

skill-doctor-skill + oaustegard-claude-skills

Lint vor der Veröffentlichung auf dem Markt

Führen Sie den Skill-Doctor lokal aus. Öffnen Sie dann eine PR für oaustegard/claude-skills.✓ Kopiert
skill-doctor-skill + agent-skills-cli-skill

Verketten Sie Skill-Doctor mit anderen Skill-Authoring-Tools

Verwenden Sie agent-skills-cli zum Gerüstbau. Der Skill-Doctor muss vor dem Festschreiben validiert werden.✓ Kopiert
skill-doctor-skill + claude-skill

Befolgen Sie die Autorenanleitung und dann Lint

Schreiben Sie gemäß dem Claude-Skill-Leitfaden. Überprüfen Sie dies mit dem Skill-Doctor.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
skill-doctor <path> skill directory path Vor der Veröffentlichung, in CI oder zur Diagnose von Aktivierungsproblemen 0

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
Keine – lokale statische Analyse
Tokens pro Aufruf
Keine (CLI, keine API)
Kosten in €
Frei
Tipp
Nur für Verzeichnisse ausführen, die sich geändert haben. Verwenden Sie in CI Pfadfilter, um zu vermeiden, dass bei jedem PR das gesamte Repo gescannt wird.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: Keine Anmeldeinformationen
Datenabfluss: Keine – nur lokale Analyse

Fehlerbehebung

Häufige Fehler und Lösungen

Der Arzt sagt, SKILL.md wurde nicht gefunden

Vom Skill-Root (Verzeichnis mit SKILL.md) ausführen, nicht vom Repo-Root.

Prüfen: ls SKILL.md in CWD
Schemafehler bei „evals/evals.json“.

Stellen Sie sicher, dass jede Auswertung über die erforderlichen Felder verfügt. Ein minimaler Stummel ist besser als kaputt.

Prüfen: jq . evals/evals.json
Die Punktzahl verbessert sich nach Änderungen nicht

Wiederholung; Wenn ein Befund weiterhin besteht, lesen Sie den Schweregrad und die Details – manchmal führen Korrekturen zu neuen Problemen mit geringem Schweregrad.

Prüfen: Diff the JSON reports between runs

Alternativen

skill-doctor vs. andere

AlternativeWann stattdessenKompromiss
agent-skills-cli-skillSie benötigen allgemeine CLI-Tools für Gerüstbau-/VerwaltungskenntnisseUnterschiedlicher Funktionsumfang; kein Linter
claude-skillSie möchten, dass der Autorenleitfaden versteht, wie „gut“ aussiehtDocs, kein Linter

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen