Fragmentierung von KI-Agenten-Skills mit npx skills lösen

Wenn Sie mehrere KI-Agenten oder Kommandozeilenwerkzeuge (CLIs) auf Ihrem Computer ausführen — sei es Hermes, Claude Code, Codex, Antigravity, Kimi oder andere unterstützte Tools —, sind Sie wahrscheinlich schon auf ein frustrierendes Problem gestoßen: Skill-Fragmentierung. Jeder Agent und jede CLI verwaltet einen eigenen, separaten skills-Ordner. Dies führt zu doppelten Installationen, abweichenden Versionen (Version Drift) und hohem Verwaltungsaufwand.

Bei unserer Arbeit mit KI-Agenten traten häufig folgende Probleme auf:

• Mehrfache Installationen: Man installiert einen neuen Skill für einen Agenten und muss ihn dann für jeden weiteren Agenten mühsam erneut installieren.
• Abweichende Versionen (Version Drift): Man passt einen Skill für einen Agenten an oder behebt einen Fehler, vergisst jedoch, die anderen zu aktualisieren — am Ende verhalten sich die Agenten unterschiedlich.
• Skill-Management: Man muss jeden einzelnen skills-Ordner aller Agenten im System durchsuchen, um überhaupt zu sehen, welche Skills installiert sind.

Die npx skills CLI, ein Open-Source-Tool von Vercel, löst dieses Problem: Sie verwalten nur noch einen einzigen, zentralisierten skills-Ordner, den Sie mit all Ihren Agenten teilen. Schauen Sie sich dazu gerne das npx skills GitHub-Repository an.

Zentralisierter Ordner

Das Konzept ist denkbar einfach: Wenn wir den skills-Ordner jedes Agenten auf denselben physischen Ordner verweisen lassen, verschwindet das Fragmentierungsproblem vollständig.

Wenn Sie einen Skill mit der npx skills CLI installieren, wird dieser in den zentralen Ordner auf Ihrem Rechner heruntergeladen (~/.agents/skills). Die CLI erstellt anschließend einen Symlink (einen symbolischen Link bzw. Zeiger) vom skills-Ordner des jeweiligen Agenten zurück zu diesem zentralen Ordner.

Wenn beispielsweise Claude Code unter ~/.claude/skills/ nach Skills sucht, wird es transparent zu ~/.agents/skills umgeleitet. Ändern Sie einen Skill in diesem zentralen Ordner, sieht jeder einzelne Agent diese Aktualisierung sofort. Kein manuelles Kopieren, keine Synchronisationsskripte und kein verschwendeter Speicherplatz.

npx skills installieren und einen Skill hinzufügen

Führen Sie den folgenden Befehl aus, um loszulegen und unseren ersten Skill hinzuzufügen:

npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram

Die CLI fragt Sie, ob Sie dies für ein bestimmtes Projekt oder global einrichten möchten. Wir empfehlen in der Regel global, damit alle unterstützten Agenten darauf zugreifen können:

Wählen Sie im nächsten Schritt unbedingt Symlink, um eine Single Source of Truth (eine einzige Quelle der Wahrheit) zu garantieren:

Sobald dies abgeschlossen ist, können wir überprüfen, ob der Skill im zentralen Ordner unter ~/.agents/skills installiert ist:

Öffnen Sie nun die Kimi CLI (oder einen anderen Agenten) — der excalidraw-diagram-Skill steht sofort bereit!

Einen Skill von Grund auf neu erstellen

Um eigene Skills zu erstellen, können Sie das Tool skill-creator von Anthropic verwenden. Installieren Sie es wie folgt:

npx skills add https://github.com/anthropics/skills --skill skill-creator

Geben Sie nun in Kimi oder einem anderen Agenten den folgenden Prompt ein:

Use the skill-creator to help me build a skill for creating a product landing page

Kimi oder Ihr Agent erkennt den skill-creator automatisch und führt Sie Schritt für Schritt durch den Prozess:

Weitere nützliche npx skills-Befehle

Hier sind einige weitere praktische Befehle:

• npx skills ls -g: Listet alle global installierten Skills auf
• npx skills update: Aktualisiert alle Skills mit einem einzigen Befehl
• npx skills remove: Deinstalliert/entfernt einen Skill interaktiv

Weitere Befehle und Referenzen finden Sie im npx skills GitHub-Repository.

Einen Schritt weitergehen

Da sich nun alle Skills an einem zentralen Ort befinden (~/.agents/skills), können wir diesen Ordner als Git-Repository initialisieren und auf GitHub oder GitLab hochladen.

cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main

Dadurch erhalten wir eine lückenlose Historie aller Skill-Änderungen und können diese bei fehlerhaften Updates problemlos rückgängig machen. Zudem lassen sich die Skills über mehrere Rechner hinweg (z. B. Laptop und Desktop) ganz einfach mit einem schnellen git pull synchronisieren.

Einige wichtige Hinweise (Sicherheit & Risiken)

• Unterschiedliche Kompatibilität: Noch unterstützen nicht alle Agenten-Plattformen jedes Feature (wie benutzerdefinierte Hooks oder bestimmte erlaubte Tools). Ein Skill kann bei einem Agenten hervorragend funktionieren, bei einem anderen jedoch fehlschlagen.
• Vertrauenswürdige Quellen: Installieren Sie Skills nur aus Quellen, denen Sie vertrauen.
• Vor der Ausführung prüfen: Wenn Sie einen benutzerdefinierten Skill oder den eines Drittanbieters nutzen, prüfen Sie die Dateien (insbesondere im Ordner scripts/), bevor Sie Ihren Agenten darauf zugreifen lassen.
• Minimalprinzip: Erteilen Sie einem Skill niemals mehr Werkzeug-Berechtigungen oder Systemzugriffe als unbedingt nötig.
• Keine Secrets fest codieren: Halten Sie API-Schlüssel und sensible Zugangsdaten unbedingt aus Ihren Skill-Dateien fern.

Die Einrichtung einer zentralen „Single Source of Truth“ mit npx skills hat unserem Team viel Frust und doppelte Arbeit erspart. Probieren Sie es unbedingt aus — die Fähigkeiten der KI skalieren mit Ihren Skills!