Agent Skill Loader 🧠

Agent Skill Loader ist ein Model Context Protocol (MCP) Server, der als Brücke zwischen Ihrer statischen Claude Code Skills-Bibliothek und dynamischen KI-Agenten (wie Claude Desktop, Cursor oder jedem anderen MCP-Client) fungiert.

Er stellt Skills sowohl als MCP Prompts (Slash-Befehle, keine Tool-Aufrufe erforderlich) als auch als MCP Tools (für die programmatische Nutzung) bereit. Skills werden automatisch aus konfigurierten Verzeichnissen erkannt und bleiben aktiv — fügen Sie eine neue SKILL.md hinzu und der Client wird automatisch benachrichtigt.

🚀 Funktionen

• MCP Prompts: Skills erscheinen als Slash-Befehle in Clients. Kein Tool-Aufruf erforderlich, um sie einzufügen.

• Live-Updates: listChanged-Benachrichtigung wird ausgelöst, wenn Skills hinzugefügt oder entfernt werden (via Datei-Watcher).

• Discovery: list_skills — scannt konfigurierte Skill-Verzeichnisse, mit optionalem Suchfilter.

• Dynamisches Lernen: read_skill — ruft den Inhalt der SKILL.md ab.

• Persistenz: install_skill — kopiert einen Skill dauerhaft in Ihr Projekt.

• Konfiguration: manage_search_paths — fügt Skill-Verzeichnisse zur Laufzeit hinzu oder entfernt sie.

• Fehlerbehebung: debug_info — diagnostiziert Konfigurations- und Pfadprobleme.

🛠️ Einrichtung

Voraussetzungen

• Node.js >= 18

Option A: Installation via npm (Empfohlen)

npm install -g agent-skill-loader

Dann in .mcp.json registrieren:

"agent-skill-loader": {
  "command": "agent-skill-loader"
}

Option B: Build aus dem Quellcode

git clone https://github.com/back1ply/agent-skill-loader.git
cd agent-skill-loader
npm install
npm run build

Dann in .mcp.json registrieren:

"agent-skill-loader": {
  "command": "node",
  "args": ["<path-to-repo>/build/index.js"]
}

📂 Konfiguration

Der Server erkennt automatisch seinen Arbeitsbereich und aggregiert Skill-Pfade aus:

1. Standard: %USERPROFILE%\.claude\plugins\cache (Standard-Speicherort)

2. Dynamische Konfiguration: skill-paths.json (befindet sich im Projekt-Root)

Umgebungsvariablen

Dynamische Pfadverwaltung

Sie müssen Konfigurationsdateien nicht manuell bearbeiten. Verwenden Sie das Tool, um Pfade zur Laufzeit zu verwalten:

• Hinzufügen: manage_search_paths(operation="add", path="F:\\My\\Deep\\Skills")

• Entfernen: manage_search_paths(operation="remove", path="...")

• Auflisten: manage_search_paths(operation="list") erstellt/aktualisiert skill-paths.json.

🤖 Verwendung

MCP Prompts (Slash-Befehle)

Wenn Ihr Client MCP Prompts unterstützt (Claude Desktop, Cursor, etc.), erscheinen Skills automatisch als Slash-Befehle. Wählen Sie einen Skill aus dem Slash-Befehlsmenü, um dessen Inhalt direkt einzufügen — keine Tool-Aufrufe erforderlich.

Tools

Der Agent hat Zugriff auf fünf Tools:

• list_skills(query?): Gibt eine JSON-Liste der verfügbaren Skills zurück. Optional filtert query nach Teilstrings in Name/Beschreibung (Groß-/Kleinschreibung wird ignoriert).

• read_skill(skill_name): Gibt die Markdown-Anweisungen für einen Skill zurück.

• install_skill(skill_name, target_path?): Kopiert den Skill-Ordner nach .agent/skills/<name>. Aus Sicherheitsgründen muss target_path innerhalb des aktuellen Arbeitsbereichs liegen.

• manage_search_paths(operation, path?): Skill-Suchpfade hinzufügen, entfernen oder auflisten.

• debug_info(): Gibt Diagnoseinformationen zurück (Pfade, Status, Warnungen).

Beispiel für einen Agent-Prompt

"Ich muss ein DAX-Measure schreiben, bin mir aber bei den Best Practices unsicher."

Der Agent ruft automatisch list_skills auf, findet writing-dax-measures, ruft read_skill auf und antwortet mit Expertenwissen. Alternativ kann der Benutzer den Skill direkt als Slash-Befehl aufrufen.

🔧 Fehlerbehebung

Wenn Skills nicht erkannt werden, verwenden Sie debug_info(), um Folgendes zu sehen:

• search_paths: Welche Verzeichnisse gescannt werden

• path_status: Ob jeder Pfad existiert und lesbar ist

• warnings: Alle Fehler, die während des Scannens aufgetreten sind (Zugriff verweigert, leere Dateien, etc.)

Beispielausgabe:

{
  "workspace_root": "C:/projects/agent-skill-loader",
  "search_paths": {
    "base": ["C:/Users/pc/.claude/plugins/cache"],
    "dynamic": ["F:/My/Skills"],
    "effective": ["C:/Users/pc/.claude/plugins/cache", "F:/My/Skills"]
  },
  "path_status": [
    { "path": "C:/Users/pc/.claude/plugins/cache", "exists": true, "readable": true },
    { "path": "F:/My/Skills", "exists": false, "readable": false }
  ],
  "skills_found": 12,
  "warnings": [
    { "path": "F:/My/Skills", "reason": "Directory does not exist" }
  ]
}

📦 Projektstruktur

• src/index.ts: Haupt-Serverlogik (Tools + Prompts + Watcher).

• src/utils.ts: Skill-Scanning, Extraktion von Beschreibungen, Prompt-Helfer, Debounce.

• build/: Kompilierte JavaScript-Ausgabe.

• package.json: Abhängigkeiten (@modelcontextprotocol/sdk, chokidar, zod).

🤝 Mitwirken

Um neue Skills hinzuzufügen, erstellen Sie einen Ordner mit einer SKILL.md-Datei in einem der überwachten Verzeichnisse. Der Server erkennt diese automatisch und sendet eine listChanged-Benachrichtigung — kein Neustart erforderlich.