Ein KI-Coding-Agent frisch aus der Box ist wie eine brillante neue Kraft an ihrem ersten Morgen. Er kann denken, Code schreiben und Befehle ausführen, aber er weiß nicht, wie dein Team die Dinge macht, und er hat keine Schlüssel zu deinen Systemen. Agent Skills und MCP-Server schließen genau diese beiden Lücken. Ein Skill ist ein geschriebenes Playbook, das der Agent aus dem Regal nimmt, sobald eine Aufgabe es braucht. Ein MCP-Server ist ein Satz Schlüssel: ein kleines Programm, das dem Agenten etwas nutzbar macht, das er vorher nicht erreichen konnte – etwa deine GitHub-Issues, einen echten Browser oder aktuelle Dokumentation.
Dieser Leitfaden erklärt beides in einfachen Worten und zeigt dir dann, wie du sie in OpenCode, Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot und Hermes Agent installierst, aktualisierst, entfernst und Fehler behebst. Das meiste funktioniert überall gleich, weil beides inzwischen offene Standards ist. Auf der Skill-Seite hält ein kleines Kommandozeilenwerkzeug alles zusammen, npx skills, und ich gehe es Befehl für Befehl durch.
Ich bin von der Ausbildung her kein Entwickler. Ich führe in Deutschland ein kleines IT-Unternehmen und baue mit KI-Agenten Software, deshalb habe ich das meiste so gelernt, wie du es wahrscheinlich auch tun wirst: indem ich Dinge kaputt gemacht habe. Teil 6 entstand aus meinen eigenen Terminal-Sitzungen auf einem Mac und einem Raspberry Pi, inklusive dem Moment, in dem das Werkzeug mir meldete, alle meine Skills seien aktuell, obwohl es keinen einzigen hatte prüfen können.
Alles unten wurde gegen die offizielle Dokumentation jedes Agenten geprüft und, für das Fähigkeiten CLI, gegen den veröffentlichten Quellcode der Versionen 1.5.18 bis 1.8.1, am 15. November 2026. Diese Werkzeuge ändern sich wöchentlich: allein diese Woche hat das CLI zwei Releases veröffentlicht, und OpenCode erreichte am 13. November Version 2.3.0. Versionsnummern und Verhalten sind dort markiert, wo sie sich wahrscheinlich ändern. Prüfe sie, bevor du dich auf sie verlässt.
Offenlegung: Kein im Beitrag genanntes Unternehmen hat ihn gesponsert, geprüft oder genehmigt, und er enthält keine Affiliate-Links. Produkte werden nur im Text genannt; die Bilder verwenden meine eigenen Logos.
TL;DR — Agent Skills und MCP-Server in zehn Punkten
- Ein Skill ist ein Ordner mit einer
SKILL.mdDatei: oben ein Name und eine Beschreibung, darunter die Anweisungen und optional Skripte oder Referenzdateien. Agenten lesen nur die Beschreibung, bis eine Aufgabe den Skill braucht, also kostet ein ungenutzter Skill ungefähr 100 Token der Aufmerksamkeit des Agenten. - Ein MCP-Server gibt dem Agenten neue Werkzeuge, etwa GitHub, einen Browser oder aktuelle Dokumentation. Tool-Beschreibungen können mit jeder Anfrage mitgeschickt werden, also verbinde nur die Server, die du nutzt. Claude Code lädt sie inzwischen erst bei Bedarf, und OpenCode gruppiert sie nach Server.
- Die Faustregel: Hausregeln für jede Aufgabe gehören in
AGENTS.md; Know-how, das für manche Aufgaben nötig ist, wird zu einem Skill; Live-Zugriff auf ein System braucht einen MCP-Server; und wenn es bereits ein gutes Kommandozeilenwerkzeug gibt, ist ein Skill, der dem Agenten dieses Werkzeug beibringt, oft günstiger als ein Server. - Beides sind offene Standards unter der Agentic AI Foundation der Linux Foundation: MCP seit Dezember 2025, Agent Skills seit 22. Oktober 2026. Ein für einen Agenten geschriebener Skill funktioniert meist auch in den anderen.
.agents/skillsist der gemeinsame Ordner. Codex, OpenCode, Cursor, Gemini CLI und GitHub Copilot lesen alle.agents/skillsin einem Projekt und~/.agents/skillsin deinem Home-Verzeichnis. Claude Code liest nur.claude/skills, und Hermes Agent liest~/.hermes/skillsplus alle Ordner, die du hinzufügst.npx skillsist npm für Skills. Vercels Open-Source-CLI (Version 1.8.1) installiert Skills in 79 Agenten:npx skills add owner/repo,-gfür jedes Projekt,-a opencode -a claude-codeum Agenten auszuwählen,npx skills lszum Auflisten undnpx skills removezum Deinstallieren.- Um zu sehen, ob deine Skills aktuell sind, starte
npx skills@latest check. Seit Version 1.7.5 (2. November 2026) meldet es nur;npx skills updateinstalliert. In früheren Versionen hatcheckstill das Update ausgeführt. - Vertrau dem grünen Haken nie allein. Als GitHubs Limit von 60 anonymen Anfragen pro Stunde jede Prüfung auf meinem Mac blockierte, gab die CLI trotzdem “All global skills are up to date” aus. Führe
gh auth loginaus oder setzeGITHUB_TOKEN, und lies die ✗-Zeilen. - Verwende niemals
sudomit Skills oder Agenten, und führe die CLI nicht aus deinem Home-Ordner aus. Root hat ein eigenes Home, alsosudolegt einen zweiten, unsichtbaren Skill-Speicher an; und von~hält die CLI deinen Home-Ordner für ein Projekt. - Behandle Skills und MCP-Server wie Software, die du installierst. Eine Prüfung von 3.984 öffentlichen Skills im Februar 2026 fand Sicherheitslücken in 36,82 % davon und bestätigte schädliche Payloads in 76. Lies, bevor du installierst, bevorzuge Skills von den Herstellern des Tools selbst, pinne Versionen und halte riskante Tools auf “ask”.
Die vier Bausteine auf einen Blick
| Baustein | Was es ist, in einer Zeile | Stell es dir vor als | Wann der Agent es liest | Was es kostet | Beispiel |
|---|---|---|---|---|---|
| AGENTS.md (CLAUDE.md in Claude Code) | Eine Markdown-Datei mit Hausregeln für ein Projekt | Das Mitarbeiterhandbuch | Zu Beginn jeder Sitzung, vollständig | Seine volle Länge, in jeder Anfrage | “Verwende britisches Englisch. Führe die Tests aus, bevor du sagst, dass du fertig bist.” |
| Skill | Ein Ordner mit einem SKILL.md Rezept, plus optionalen Skripten und Referenzen |
Eine Rezeptkarte in einem Ordner | Name und Beschreibung am Anfang; das ganze Rezept erst, wenn eine Aufgabe es braucht | Etwa 100 Tokens pro Skill, bis er genutzt wird | “Wie wir Release Notes schreiben” |
| MCP-Server | Ein kleines Programm, das dem Agenten neue Tools gibt | Ein Satz Schlüssel und Adapter | Die Toolliste am Anfang (außer dein Agent lädt sie verzögert); einzelne Tools beim Aufruf | Tool-Beschreibungen, oft in jeder Anfrage | GitHub-Issues, ein echter Browser, aktuelle Bibliotheksdokumentation |
| Plugin oder Erweiterung | Ein Bündel aus Skills, MCP-Servern und manchmal Hooks | Ein Willkommenspaket | Hängt davon ab, was drin ist | Die Summe seiner Teile | Superpowers, das Starterkit eines Anbieters |

Inhaltsverzeichnis
- Teil 1 — Agent Skills und MCP-Server einfach erklärt
- Teil 2 — Skill, MCP-Server oder AGENTS.md? Der Fünf-Fragen-Test
- Teil 3 — Wo jeder Agent nach Skills sucht
- Teil 4 — Das
FähigkeitenCLI: npm für Agent Skills, Schritt für Schritt - Teil 5 — “Mein Skill-Paket wurde vor zwei Tagen aktualisiert. Woran erkenne ich, dass ich es habe?”
- Teil 6 — Fünf echte Probleme von meinem Mac und Raspberry Pi und wie du sie behebst
- Teil 7 — MCP-Server ohne Fachchinesisch
- Teil 8 — Einen MCP-Server in sechs Agenten hinzufügen: Rezepte zum Kopieren
- Teil 9 — Plugins: Skills und MCP-Server in einer Box
- Teil 10 — Schreib deinen ersten Skill in zehn Minuten
- Teil 11 — Sicher bleiben: Skills und Server sind Software
- Teil 12 — Eine Zwei-Minuten-Routine pro Woche
- Teil 13 — Welches Setup solltest du wählen? Fünf Szenarien
- Häufig gestellte Fragen
- Das Fazit
Teil 1 — Agent Skills und MCP-Server einfach erklärt
Das Bild vom neuen Mitarbeiter
Stell dir vor, du stellst jemanden Brillantes ein. Am ersten Tag würdest du ihr drei Dinge geben: ein kurzes Handbuch mit den Regeln, die alle befolgen, einen Ordner mit Rezepten für die Aufgaben, die dein Team auf seine ganz eigene Art erledigt, und einen Satz Schlüssel und Ausweise, damit sie in die Systeme kommt, die sie braucht. Manche Leute bekämen außerdem ein Willkommenspaket, das ein paar Rezepte und Schlüssel bündelt.
KI-Agenten brauchen genau dasselbe, und jeder Baustein hat inzwischen einen Standardnamen:
- Das Handbuch ist
AGENTS.md(Claude Code nennt seine VersionCLAUDE.md). - Die Rezepte sind Skills.
- Die Schlüssel sind MCP-Server.
- Die Willkommenspakete sind Plugins, in manchen Agenten Extensions genannt.
Der Rest dieses Leitfadens handelt von den Rezepten und den Schlüsseln, denn dort steckt der größte Teil der Verwirrung.
Was ein Skill ist
Ein Skill ist ein Ordner. Darin liegt eine erforderliche Datei, SKILL.md, und optional alles andere, was die Aufgabe braucht:
release-notes/
├── SKILL.md ← erforderlich: Name, Beschreibung, Anweisungen
├── references/ ← optional: längere Dokumente, nur bei Bedarf gelesen
├── scripts/ ← optional: Code, den der Agent ausführen kann
└── assets/ ← optional: Vorlagen, Bilder, Datendateien
Die SKILL.md Datei beginnt mit einem kurzen Kopf zwischen zwei --- Zeilen (dieser Kopf heißt Front Matter), gefolgt von einfachen Anweisungen:
---
name: release-notes
description: Schreibt "What's New"-Notizen für den App Store aus den letzten Commits. Verwenden, wenn nach Release Notes, einem Changelog oder einem "What's New"-Text gefragt wird.
---
# Release Notes
1. Lies die Commits seit dem letzten Git-Tag.
2. Behalte nur Änderungen, die ein Nutzer bemerken würde.
3. Schreibe drei bis fünf kurze Stichpunkte in klarem Deutsch, insgesamt unter 400 Zeichen.
Der offene Standard verlangt zwei Felder. Der Name darf nur Kleinbuchstaben, Zahlen und Bindestriche enthalten, höchstens 64 Zeichen lang sein und muss mit dem Namen des Ordners übereinstimmen. Die Beschreibung Beschreibung kann bis zu 1.024 Zeichen lang sein und sollte sagen, was der Skill tut und wann du ihn einsetzt, denn anhand der Beschreibung entscheidet der Agent, ob er den Skill überhaupt öffnet.
Warum du Dutzende Skills installieren kannst: der Trick mit den drei Schichten
Skills werden schichtweise geladen, was der Standard Progressive Disclosure. Denk an ein Bücherregal:
- Die Rückseiten. Wenn eine Sitzung startet, liest der Agent nur den Namen und die Beschreibung jedes Skills. Die Spezifikation sieht dafür etwa 100 Tokens pro Skill vor. (Ein Token ist ungefähr ein kurzes Wort oder ein Teil davon; es ist die Einheit, in der Modelle ihr Arbeitsgedächtnis messen.)
- Das Kapitel. Wenn eine Aufgabe zu einer Beschreibung passt, liest der Agent die vollständige
SKILL.md. Der Standard empfiehlt, sie unter 5.000 Tokens und 500 Zeilen zu halten. - Der Anhang. Referenzdateien und Skripte werden nur geladen, wenn die Anweisungen darauf verweisen.
Deshalb kosten hundert ungenutzte Skills weit weniger als ein einziges langes Regelwerk. Umsonst ist das trotzdem nicht: Beschreibungen summieren sich, und die Agenten begrenzen sie. Codex begrenzt seine anfängliche Skill-Liste auf 2 % des Arbeitsgedächtnisses des Modells (8.000 Zeichen, wenn es die Größe nicht bestimmen kann), und Claude Code schneidet den Listentext jedes Skills bei 1.536 Zeichen ab. Installiere, was du auch benutzt.
Was ein MCP-Server ist
MCP, das Model Context Protocol, ist ein offener Standard, um KI-Agenten mit Werkzeugen und Daten zu verbinden. Anthropic stellte es im November 2024 vor und übergab es im Dezember 2025 an die neue Agentic AI Foundation der Linux Foundation, zusammen mit OpenAIs AGENTS.md und Blocks goose.
Eine MCP-Server ist ein kleines Programm, das deinem Agenten sagt: “Hier sind die Werkzeuge, die ich anbiete”. Ein GitHub-Server bietet zum Beispiel create_issue und search_code; ein Browser-Server bietet navigate und take_screenshot; ein Dokumentationsserver bietet query_docs. Dein Agent ist der MCP-Client: Er zeigt dem Modell die Liste, und wenn das Modell ein Tool nutzen will, prüft der Agent deine Berechtigungen, bittet den Server, es auszuführen, und gibt das Ergebnis zurück.
Es gibt zwei Arten von Servern:
- Lokale Server laufen auf deinem eigenen Rechner. Der Agent startet sie mit einem Befehl wie
npx @playwright/mcp@latestund spricht über die Ein- und Ausgabe des Programms mit ihnen (der Fachbegriff ist stdio). - Remote-Server laufen auf den Rechnern des Anbieters. Du verbindest dich über eine Webadresse wie
https://mcp.context7.com/mcp, und meldest dich normalerweise über deinen Browser an oder fügst einen API-Schlüssel ein. Der Fachbegriff für die Verbindung ist Streamable HTTP.
Der Haken dabei: Jedes Tool kommt mit einem Namen, einer Beschreibung und einer Parameterliste, geschrieben, damit das Modell sie liest. Wenn dein Agent sie nicht zurückstellt, reisen diese Beschreibungen mit jeder Anfrage mit, und zwanzig Server mit je zehn Tools machen jede Antwort langsamer, teurer und weniger fokussiert. Teil 7 zeigt, was die einzelnen Agenten dagegen tun.
AGENTS.md und Plugins, kurz erklärt
AGENTS.md ist eine einfache Markdown-Datei im Stammordner deines Projekts, die der Agent zu Beginn jeder Sitzung liest: der Zweck des Projekts, seine Befehle, seine unverhandelbaren Regeln. OpenCode, Codex, Cursor und GitHub Copilot lesen sie direkt. Claude Code liest CLAUDE.md stattdessen, und seine Dokumentation schlägt eine CLAUDE.md vor, die die andere Datei einfach mit einer Zeile importiert, die lautet @AGENTS.md. Weil sie jedes Mal geladen wird, halte sie kurz und verschiebe alles Aufgabenspezifische in Skills.
Plugins bündeln die anderen Bausteine. Ein Claude-Code-Plugin kann Skills, Subagenten, Hooks (Skripte, die bei Ereignissen laufen) sowie MCP- und LSP-Server enthalten. Auch Codex, Cursor, GitHub Copilot CLI und Hermes Agent haben Plugins, und Gemini CLI nennt sie Extensions. Teil 9 behandelt sie.
Ein kleines Glossar
| Begriff | Was er hier bedeutet |
|---|---|
| Agent (oder Harness) | Das Programm, mit dem du sprichst: OpenCode, Claude Code, Codex und so weiter. Es führt das Modell aus, liest Dateien und ruft Tools auf |
| Modell | Die KI, die denkt, etwa GLM, Claude oder GPT |
| Kontextfenster | Das Arbeitsgedächtnis des Modells für eine Anfrage. Alles, was du lädst, konkurriert darum |
| Token | Die Einheit, in der Modelle Text zählen; ungefähr ein kurzes Wort oder ein Teil davon |
| Skill | Ein Ordner mit einem SKILL.md Datei, die dem Agenten eine Aufgabe beibringt |
| Front Matter | Der Kopfbereich oben in SKILL.md, zwischen zwei --- Zeilen |
| MCP-Server | Ein Programm, das dem Agenten Tools über das Model Context Protocol anbietet |
| Werkzeug | Eine Aktion, die ein MCP-Server anbietet, etwa create_issue |
| stdio / Streamable HTTP | Wie der Agent mit einem lokalen Server und einem Remote-Server spricht |
| OAuth | Der “Anmelden mit…”-Ablauf in deinem Browser, der dem Agenten ein Token gibt, ohne dass du ein Passwort einfügst |
| Projektbereich / globaler Bereich | Nur für ein Projekt installiert oder für jedes Projekt auf deinem Rechner |
| Lock-Datei | Ein Beleg, der auflistet, was du installiert hast, woher es kam, und einen Fingerabdruck jedes Skills |
| Symlink | Eine Verknüpfung zu einem Ordner. Die Skills-CLI behält eine echte Kopie und verlinkt die Agenten darauf |
Teil 2 — Skill, MCP-Server oder AGENTS.md? Der Fünf-Fragen-Test
Wenn du willst, dass ein Agent etwas besser macht, stelle diese Fragen der Reihe nach und halte beim ersten “Ja” an. Frage 4 ist die einzige mit einer Rückfrage:
- Muss es für jede einzelne Aufgabe in diesem Projekt gelten? Schreib es in
AGENTS.md. “Britische Schreibweise verwenden” und “die Tests laufen lassen, bevor du fertig meldest” gehören hierhin. - Muss es erzwungen werden, nicht nur vorgeschlagen? Nutze eine Berechtigungsregel oder einen Hook. Skills und
AGENTS.mdsind Anweisungen, und ein Modell kann Anweisungen ignorieren. “Niemals nach main pushen” braucht einedenyRegel. - Ist es Know-how, das nur bei manchen Aufgaben zählt? Schreib oder installiere einen Skill. Release-Routinen, Review-Checklisten, deine Markenstimme und dein Test-First-Workflow sind alles Skills.
- Braucht der Agent Live-Zugriff auf ein System außerhalb seiner Dateien? Deine Crash-Reports hinter einem Login, einen Browser, den er steuern kann, eine Projektmanagement-App. Wenn ja, stelle Frage 5, bevor du zu einem Server greifst.
- Gibt es für dieses System schon ein gutes Kommandozeilen-Tool? Wenn ja, schlägt ein Skill, der dem Agenten dieses Tool beibringt, meist einen Server: Der Agent weiß bereits, wie man Befehle ausführt, eine CLI kostet nichts, bis sie genutzt wird, und ihre Ausgabe lässt sich filtern, bevor sie das Modell erreicht. Gibt es keine gute CLI, kann dein Agent keine Befehle ausführen oder ist die Aufgabe interaktiv (etwa einen Browser steuern), dann füge einen MCP-Server hinzu.
Hier ist der Test auf zehn Alltagswünsche angewandt:
| Du willst, dass der Agent… | Verwende | Warum |
|---|---|---|
| Immer britische Schreibweise verwenden | AGENTS.md |
Gilt für jede Aufgabe |
| Niemals in den main-Branch pushen | Eine Berechtigungsregel | Es muss erzwungen werden, nicht nur vorgeschlagen |
| Release Notes so schreiben, wie du sie magst | Ein Skill | Know-how, gelegentlich nötig |
| Einem strikten Test-First-Workflow folgen | Ein Skill (Superpowers hat einen) | Ein Verfahren für manche Aufgaben |
| GitHub-Issues lesen und anlegen | Ein Skill, der es beibringt gh, oder GitHubs MCP-Server |
gh ist günstiger; der Server passt zu Agenten, die keine Befehle ausführen können |
| Die aktuellen Docs einer Bibliothek nachschlagen | Ein MCP-Server (Context7) oder seine CLI mit einem Skill (ctx7) |
So oder so Live-Daten |
| Klick dich durch deine Web-App und mach Screenshots | Ein MCP-Server (Playwright) | Es braucht einen laufenden Browser, den der Agent steuern kann |
| Prüf die Abstürze von letzter Nacht | Ein MCP-Server (Sentry) | Live-Daten hinter einem Login |
| Erstelle einen PDF-Bericht aus deiner Vorlage | Ein Skill mit einem Skript und der Vorlage darin assets/ |
Ein Vorgehen plus ein mitgeliefertes Werkzeug |
Halt fern von deinen .env Dateien |
Eine Berechtigungsregel | Es muss erzwungen werden |
Skills und MCP-Server sind keine Rivalen. Einige der besten Setups kombinieren sie: Ein Skill erklärt wenn und wie wie man die Tools eines Servers benutzt, und der Server erledigt die Arbeit. Codex erlaubt es einem Skill sogar, die MCP-Server anzugeben, von denen es abhängt, in einer optionalen agents/openai.yaml Datei.

Teil 3 — Wo jeder Agent nach Skills sucht
Jeder Agent sucht an zwei Arten von Orten. Projektordner liegen in deinem Repository, sodass die Skills mit dem Code reisen und deine Teamkollegen sie auch bekommen. Persönliche Ordner liegen in deinem Home-Verzeichnis und gelten für jedes Projekt auf deinem Rechner. Die meisten Tools nennen persönliche Installationen global.
2026 konvergierten die Agenten auf einen gemeinsamen Ort: .agents/skills in einem Projekt und ~/.agents/skills in deinem Home-Verzeichnis. Leg ein Skill dort ab, und die meisten Agenten finden es ohne zusätzliche Arbeit.
| Agent | Projektordner | Persönliche Ordner | Ein Skill selbst aufrufen | Gut zu wissen |
|---|---|---|---|---|
| OpenCode | .opencode/skills, .agents/skills, .claude/skills |
~/.config/opencode/skills, ~/.agents/skills, ~/.claude/skills |
Erwähne @skill-id in deinem Prompt |
Die ID ist der Name des Ordners. Schütze Skills mit der skill Berechtigung |
| Claude Code | .claude/skills |
~/.claude/skills |
/skill-name |
Liest nicht .agents/skills. Plugin-Skills erscheinen als /plugin-name:skill-name |
| Codex | .agents/skills, in jedem Ordner von deinem Startpunkt bis zum Repository-Root |
~/.agents/skills, plus /etc/codex/skills für Administratoren |
$skill-name, oder /skills |
Wird mit einem integrierten $skill-installer |
| Gemini CLI | .agents/skills, .gemini/skills |
~/.agents/skills, ~/.gemini/skills |
/skills list; das Modell fragt dich um Erlaubnis, bevor es einen aktiviert |
.agents/skills gewinnt, wenn zwei Skills denselben Namen haben |
| Cursor | .agents/skills, .cursor/skills (und liest .claude/skills und .codex/skills) |
~/.agents/skills, ~/.cursor/skills |
/skill-name |
A Pfade Feld beschränkt einen Skill auf passende Dateien |
| GitHub Copilot | .github/skills, .agents/skills, .claude/skills |
~/.copilot/skills, ~/.agents/skills |
Lädt Skills, wenn sie relevant sind | Funktioniert in Copilot CLI, im Cloud-Agenten und im Agentenmodus in VS Code und JetBrains |
| Hermes Agent | .hermes/skills, .agents/skills, nachdem du hermes skills trust |
~/.hermes/skillsausgeführt hast, sowie alle Ordner, die in skills.external_dirs |
/skill-nameaufgeführt sind, und bis zu fünf hintereinander |
Prüft jede Hub-Installation auf schädliche Inhalte |
Pfade aus der Dokumentation der einzelnen Agenten vom 15. November 2026. Agenten ergänzen regelmäßig neue Orte; schau auf der Skills-Seite deines Agenten nach, wenn etwas nicht auftaucht.
Drei Details, die Verwirrung ersparen
- Claude Code ist die Ausnahme. Er liest nur
.claude/skillsund~/.claude/skills. Die Skills-CLI erledigt das für dich und legt einen Link vom Claude-Code-Ordner auf die gemeinsame Kopie. Wenn du Skills von Hand kopierst, musst du sie (oder einen Symlink) selbst in den Claude-Code-Ordner legen. - Hermes Agent pflegt seine eigene Bibliothek. Sein Hauptordner ist
~/.hermes/skills. Damit er den gemeinsamen Ordner ebenfalls liest, trage ihn in~/.hermes/config.yaml:
yaml
skills:
external_dirs:
- ~/.agents/skills
Oder installiere mit der Skills-CLI und gib -a hermes-agentan. Wähle einen Weg, nicht beide, sonst hast du jeden Skill doppelt.
– Doppelte Namen sorgen für stille Überraschungen. Jeder Agent hat seine eigene Regel, welche Kopie gewinnt. OpenCode registriert seine Ordner in einer festen Reihenfolge, und der letzte gewinnt, wobei der deines Projekts .opencode/skills ganz am Ende steht. Claude Code macht es umgekehrt: Ein persönlicher Skill schlägt einen Projekt-Skill mit demselben Namen. Gemini CLI bevorzugt den Workspace gegenüber dem Benutzer und .agents gegenüber .gemini, und Codex zeigt einfach beide an. Die Lösung ist langweilig und verlässlich: Behalte nicht zwei Skills mit demselben Namen.
OpenCode hat zwei Extras, die du kennen solltest. Eine einzelne Markdown-Datei direkt oben in einem Skills-Ordner (etwa skills/review.md) zählt ebenfalls als Skill, und ein Eintrag Fähigkeiten Array in opencode.jsonc kann zusätzliche Ordner oder sogar einen Webkatalog mit Skills hinzufügen. Mein OpenCode-Leitfaden geht ausführlicher auf seine Skill-Berechtigungen ein.

Teil 4 — Das Fähigkeiten CLI: npm für Agent Skills, Schritt für Schritt
Du kannst Skills installieren, indem du Ordner herumkopierst, und für ein oder zwei ist das in Ordnung. Darüber hinaus willst du einen Paketmanager: etwas, das weiß, wo jeder Agent sucht, eine Kopie statt fünf behält, sich merkt, woher jeder Skill stammt, und dir sagen kann, wenn es eine neuere Version gibt. Das ist es, was Fähigkeiten macht. Es ist ein Open-Source-Kommandozeilenwerkzeug (MIT) von Vercel Labs, du startest es mit npx skills, und sein Verzeichnis öffentlicher Skills liegt unter skills.sh.
Die Fakten, die am 15. November 2026 zählen:
- Version 1.8.1, veröffentlicht am 11. November. Es ist schnell unterwegs: von 1.7.5 auf 1.8.1 dauerte es neun Tage.
- Es benötigt Node.js 22.20 oder neuer.
- Es unterstützt 79 Agenten, darunter OpenCode, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot und Hermes Agent.
- Es installiert aus GitHub (
owner/repo), GitLab, Azure Repos, einer beliebigen Git-Adresse, einem lokalen Ordner oder einem direkten Download-Link zu einerSKILL.mdoder einem Archiv.
Schritt 0 — Node.js prüfen und immer die neueste Version verlangen
node --version # braucht v22.20.0 oder neuer
Wenn das eine ältere Version oder “command not found” ausgibt, installiere die aktuelle LTS-Version von nodejs.org. Auf einem Mac mit Homebrew funktioniert brew install node auch. Auf einem Raspberry Pi ist die Version in der Paketliste des Betriebssystems selbst oft zu alt, also nutze die Installer, die auf derselben Seite verlinkt sind.
Dann automatisiere eine Gewohnheit: Tippe npx skills@latest statt einfach npx skills bei allem, was prüft oder aktualisiert. Ein einfaches npx kann eine Kopie wiederverwenden, die es vor Wochen heruntergeladen hat, und bei diesem Werkzeug ändert die Version, die du ausführst, was die Befehle tun (Teil 5 erklärt das größte Beispiel).
Schritt 1 — Erst schauen, dann installieren
npx skills@latest add vercel-labs/agent-skills --list
--list zeigt jeden Skill im Repository mit seiner Beschreibung und installiert nichts. Dann öffne das Repository im Browser und lies die SKILL.md von allem, was du gleich installierst, plus alle Skripte daneben. Auf skills.sh zeigt die Seite jedes Skills außerdem die Ergebnisse des Sicherheitsaudits (Teil 11).
Schritt 2 — Installiere einen Skill für die Agenten, die du nutzt
# Ein Skill, für OpenCode und Claude Code, im aktuellen Projekt
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a opencode -a claude-code
# Derselbe Skill für jedes Projekt auf diesem Rechner
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -g -a opencode -a claude-code
# Ein Release-Tag oder einen vollständigen Commit festnageln, damit Updates bewusst passieren
npx skills add owner/[email protected] --skill my-skill
Lässt du --skill und -a weg, fragt die CLI dich interaktiv: welche Skills, welche Agenten und ob verlinkt oder kopiert werden soll. Hier landen die Dinge:
| Umfang | Die eine echte Kopie | Links für Agenten mit eigenem Ordner | Die Aufzeichnung dessen, was du installiert hast |
|---|---|---|---|
| Projekt (Standard) | ./.agents/skills/<name> |
z. B. ./.claude/skills/<name> für Claude Code |
./skills-lock.json |
Global (-g) |
~/.agents/skills/<name> |
z. B. ~/.claude/skills/<name>, ~/.hermes/skills/<name> |
~/.agents/.skill-lock.json |
Die CLI hält eine echte Kopie in .agents/skills, die die meisten Agenten direkt lesen, und erstellt Links (Symlinks, im Grunde Verknüpfungen) für Agenten, die woanders nachsehen. Eine Kopie bedeutet ein Update. Wenn dein System mit Symlinks nicht gut umgehen kann, was unter Windows passieren kann, füge --copy hinzu, um stattdessen unabhängige Kopien zu erhalten.
Schritt 3 — Sieh nach, was installiert ist
npx skills ls # Skills dieses Projekts
npx skills ls -g # deine globalen Skills
npx skills ls -a opencode # nur, was OpenCode bekommt
npx skills ls --json # maschinenlesbar, für Skripte
Bei Projekt-Skills zeigen aktuelle Versionen zusätzlich einen Status: getrackt (stimmt mit der Lock-Datei überein), verändert (du oder der Agent hat ihn bearbeitet), nicht getrackt (kein Eintrag in der Lock-Datei, etwa ein Skill, den du von Hand geschrieben hast) oder fehlt (in der Lock-Datei, aber nicht auf der Festplatte).
Schritt 4 — Skills finden
npx skills find # interaktive Suche
npx skills find seo # Suche nach Stichwort
npx skills find react --owner vercel # nur die Repositories einer Organisation
Oder durchstöbere skills.sh, das Skills nach Installationen sortiert und sie nach Thema gruppiert. Der heute am häufigsten installierte Skill dort ist find-skills aus Vercels eigenem Repository, der deinem Agenten beibringt, selbst nach Skills zu suchen. Die Installationszahlen ändern sich täglich, sieh die Rangliste also als Hinweis, nicht als Bewertung.
Schritt 5 — Probiere einen Skill aus, ohne ihn zu installieren
npx skills use vercel-labs/agent-skills@web-design-guidelines
Das gibt einen fertigen Prompt für diesen Skill aus, den du per Pipe oder Einfügen an einen Agenten auf demselben Computer übergeben kannst. Füge --agent claude-code hinzu, und die CLI startet Claude Code mit geladenem Skill. Das ist eine gute Möglichkeit, einen Skill zu testen, bevor er Teil deines Setups wird.
Schritt 6 — Skills entfernen
npx skills remove web-design-guidelines # aus diesem Projekt
npx skills rm --global web-design-guidelines # aus deinen globalen Skills
npx skills remove --agent claude-code my-skill # nur von einem Agenten
npx skills remove vercel-labs/agent-skills # alles aus dieser Quelle
npx skills remove # aus einer Liste auswählen
npx skills remove --all entfernt jeden Skill der in der Lock-Datei erfasst ist und überspringt Ordner, die es nicht installiert hat, etwa Skills, die du selbst geschrieben hast, damit deine eigene Arbeit nicht gelöscht wird.
Schritt 7 — Eigene erstellen
npx skills init my-skill erstellt my-skill/SKILL.md aus einer Vorlage. Teil 10 führt durch ein vollständiges Beispiel.
Das ganze Werkzeug auf einer Karte
| Ich möchte… | Befehl |
|---|---|
| Sehen, was ein Repository bietet | npx skills@latest add owner/repo --list |
| Eine Skill in diesem Projekt installieren | npx skills add owner/repo --skill name |
| Für jedes Projekt installieren | add -g |
| Die Agenten auswählen | add -a opencode -a claude-code (oder --agent '*' für alle) |
| Ohne Rückfragen installieren | add -y |
| Eine Version fixieren | npx skills add owner/[email protected] --skill name |
| Installierte Skills auflisten | npx skills ls · npx skills ls -g |
| Suche | npx skills find keyword |
| Auf Updates prüfen (schreibgeschützt) | npx skills@latest check · add -g oder -p |
| Updates installieren | npx skills update · -g · -p · -y · oder die Skills benennen |
| Entfernen | npx skills remove name · add -g für global |
| Die Skills eines Projekts aus seiner Lock-Datei wiederherstellen | npx skills install |
| Eine neue Skill anlegen | npx skills init name |
Befehle für skills 1.8.1. npx skills install (ein Alias für experimental_install) und der experimental_sync Befehl für Skills, die in npm-Paketen ausgeliefert werden, sind als experimentell gekennzeichnet und können sich ändern.

--list bevor du installierst, und @latest wann immer du prüfst oder aktualisierst.Was ist eine Lock-Datei, und should ich sie committen?
Eine Lock-Datei ist ein Beleg. Für jede Skill hält sie fest, woher sie kam, und einen Fingerabdruck ihres Ordners (technisch ein Hash: ein kurzer Code, der sich ändert, sobald sich irgendeine Datei im Ordner ändert). Die CLI kennt zwei Arten:
skills-lock.jsonin einem Projekt. Committe sie in Git. Auf einem anderen Rechner oder für ein Teammitgliednpx skills installstellt genau dieselben Skills wieder her, und--frozen-lockfile(der Standard in CI) bricht ab, wenn etwas abweicht. Das macht die Skills eines Projekts reproduzierbar, so wiepackage-lock.jsones für Code tut.~/.agents/.skill-lock.jsonfür deine globalen Skills. Sie gehört zu deinem Benutzerkonto (oder liegt unter$XDG_STATE_HOME/skills/.skill-lock.jsonwenn du diese Variable gesetzt hast). Bearbeite sie nicht von Hand, und beachte, dass jeder Benutzer auf einem Computer seine eigene hat, was in Teil 6 wichtig wird.
Telemetrie, kurz gefasst
Die CLI sendet anonyme Nutzungsdaten. Laut ihrer Dokumentation werden GitHub-Repository- und Skill-Namen nur dann aufgenommen, wenn GitHub bestätigt, dass das Repository öffentlich ist; auch andere Arten von Quellen können genannt werden. Um sie abzuschalten, füge export DISABLE_TELEMETRY=1 (oder DO_NOT_TRACK=1) zu deinem Shell-Profil hinzu. Das schaltet auch die Abfragen zur Sicherheitsprüfung ab, die die CLI für öffentliche Skills macht, also entscheide, was dir mehr wert ist.
Weitere Installer, die dir begegnen
Die Skills-CLI ist nicht der einzige Weg hinein. Mehrere Agenten und Tools haben ihre eigenen Installationsprogramme, und alle folgen demselben offenen Standard:
| Werkzeug | Beispiel | Gut zu wissen |
|---|---|---|
GitHub CLI (gh skill, Version 2.90 oder neuer, in der Vorschau) |
gh skill install owner/repo skill-name --agent claude-code |
gh skill preview zeigt einen Skill, bevor du ihn installierst; --pin fixiert eine Version |
| Hermes Agent | hermes skills install <identifier> |
Sein Hub umfasst skills.sh, und jede Installation wird sicherheitsgeprüft |
| Gemini CLI | gemini skills install <git-url> |
--scope workspace für ein einziges Projekt; fragt nach Zustimmung, außer du setzt --consent |
| Codex | $skill-installer <name> |
Ein eingebauter System-Skill |
| Claude Code | /plugin install name@marketplace |
Plugins bündeln Skills mit MCP-Servern und Hooks (Teil 9) |
Eine Regel erspart dir die meisten Kopfschmerzen: aktualisiere einen Skill mit demselben Werkzeug, mit dem du ihn installiert hast. Jedes Installationsprogramm führt seine eigenen Aufzeichnungen, und keines weiß, was die anderen getan haben.
Teil 5 — “Mein Skill-Paket wurde vor zwei Tagen aktualisiert. Woran erkenne ich, dass ich es habe?”
Genau das war meine Frage, als Superpowers, die beliebte Skill-Bibliothek von Jesse Vincent, ein Update angekündigt hat. npx skills ls listet Namen, keine Versionen, kann dir also nicht weiterhelfen. Hier erfährst du, wie die CLI es tatsächlich herausfindet.
Wie die Prüfung funktioniert
Wenn du einen Skill installierst, speichert die CLI den Fingerabdruck seines Ordners in der Lock-Datei. Wenn du prüfst, fragt sie die Quelle (meist GitHub) nach dem Fingerabdruck desselben Ordners von heute. Gleicher Fingerabdruck: aktuell. Anders: Es gibt ein Update. Der Abgleich nutzt keine Versionsnummern oder Daten, deshalb funktioniert er auch für Skills, die beides nicht haben.
cd /tmp # oder ein Projektordner, aber niemals dein Home-Ordner
npx skills@latest check -g # deine globalen Skills
cd ~/code/my-app
npx skills@latest check -p # die Skills dieses Projekts
Ein typisches Ergebnis in 1.8.1 sieht so aus:
↑ brainstorming hat ein Update
↑ writing-plans hat ein Update
2 Skill(s) können aktualisiert werden; führe npx skills update aus, um sie zu installieren
check meldet außerdem Projekt-Skills, deren Dateien nicht mehr zur Lock-Datei passen (hat lokale Änderungen), und es endet mit einem Fehlercode, sobald etwas veraltet oder geändert ist, sodass du damit einen CI-Build stoppen kannst, der abgedriftet ist.
check hat sich im November geändert, also nutze die neueste Version
Seit Version 1.7.5 (2. November 2026), check meldet es nur. In früheren Versionen, mindestens von 1.5.18 bis 1.7.4, check war einfach ein anderer Name für update: Es fragte “Update-Umfang?” und installierte dabei Updates. Wenn du npx skills check vor November genutzt hast und dich gefragt hast, warum es Dinge “aktualisiert” hat, dann liegt es daran. Nutze npx skills@latest check und du bekommst das Nur-Lese-Verhalten.
Zwei weitere Details, über die Leute stolpern:
checkwählt von selbst einen Bereich. Wenn der Ordner, in dem du dich befindest, eineskills-lock.jsonDatei oder einen.agents/skillsOrdner mit einem Skill darin enthält, prüft es die Projekt Skills; andernfalls prüft es die globalen global Skills. Füge-goder-phinzu, um zu sagen, welchen du meinst.- Es gibt keine Option “alles aus einem Repository aktualisieren”. Aktualisiere entweder alles in einem Bereich oder nenne die Skills.
Dann aktualisiere
npx skills update # fragt: Projekt, global oder beides
npx skills update -g # alle globalen Skills
npx skills update -p # alle Projekt-Skills
npx skills update brainstorming writing-plans -g # nur diese
npx skills update -y # keine Fragen: Projekt, wenn du in einem bist, sonst global
Lies die Änderungen, bevor du etwas Wichtiges aktualisierst. Öffne die Commit-Historie des Repositorys auf GitHub und schau nach, was sich in den Skill-Ordnern geändert hat: Ein Update sind neue Anweisungen, die dein Agent mit deinen Berechtigungen ausführt.
Wenn du es als Plugin installiert hast, aktualisiere es als Plugin
Viele Skill-Pakete werden inzwischen als Plugins verteilt, und Superpowers ist ein gutes Beispiel. Die README listet für fast jeden Agenten einen anderen Installationsweg:
| Agent | Superpowers installieren, laut eigener README | So läuft das Update |
|---|---|---|
| Claude Code | /plugin install superpowers@claude-plugins-official |
Automatisch, aus Anthropics offiziellem Marketplace |
| Codex CLI | /plugins, suche nach “superpowers”, Plugin installieren |
Über den Plugin-Manager |
| Cursor | /add-plugin superpowers im Agent-Chat |
Über den Plugin-Manager |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
gemini extensions update superpowers |
| GitHub Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace, dann copilot plugin install superpowers@superpowers-marketplace |
Über den Plugin-Manager |
| Hermes Agent | hermes plugins install obra/superpowers --enable |
Über den Plugin-Manager |
| OpenCode | Hinzufügen "superpowers@git+https://github.com/obra/superpowers.git" zur Plugin- Liste in opencode.json, wie die OpenCode-Installationsanleitung beschreibt |
Nach dem Neustart; leere den Paket-Cache von OpenCode, wenn eine neue Version nicht erscheint, oder füge #v5.0.3-artige Tags an, um zu pinnen |
Aus der README von Superpowers und der zugehörigen OpenCode-Installationsanleitung, geprüft am 15. November 2026.
Ich habe Superpowers auf meinem Mac installiert mit npx skills -g, sodass sich meines über die skills CLI aktualisiert. Das ist in Ordnung. Nicht in Ordnung ist, dasselbe Paket über zwei Kanäle zu installieren: Am Ende hast du von jedem Skill zwei Kopien unter identischen Namen und keine Möglichkeit zu sagen, welche der Agent auswählt.

check vergleicht Fingerabdrücke, nicht Versionsnummern. Seit 1.7.5 meldet der Befehl nur; update ist der Befehl, der überhaupt etwas ändert.Teil 6 — Fünf echte Probleme von meinem Mac und Raspberry Pi und wie du sie behebst
Alles in diesem Teil ist mir im Sommer 2026 mit Version 1.5 der CLI passiert. Jedes Problem wurde inzwischen gegen den Quellcode der aktuellen Version 1.8.1 geprüft, damit du weißt, welche behoben sind und welche immer noch zuschlagen. Die Terminalausgabe ist echt; ich habe sie gekürzt und Rechnernamen entfernt.
Problem 1: “Alle globalen Skills sind aktuell”, obwohl nichts geprüft wurde
Auf meinem Mac npx skills check ergab das:
graham@mac my-app % npx skills check
◇ Update scope
│ Both
Checking for skill updates…
Global Skills
Checking skills from source: anthropics/skills
│ GitHub API request limit reached; checking existing gh authentication…
✗ Failed to fetch tree for anthropics/skills
Checking skills from source: vercel-labs/skills
✗ Failed to fetch tree for vercel-labs/skills
… (six more sources, every one ✗)
Checking skills from source: obra/superpowers
✗ Failed to fetch tree for obra/superpowers
✓ All global skills are up to date
Was passiert ist. Um ein Repository zu prüfen, fragt die CLI bei der GitHub-API die Dateiliste des Repositorys ab. GitHub erlaubt 60 anonyme Anfragen pro Stunde pro Internetadresse, und mein Kontingent für diese Stunde war bereits verbraucht (das Werkzeug sagt es in der ersten Zeile), also schlug jede Abfrage fehl. Die letzte Zeile zählt nur die Aktualisierungen, die das Werkzeug gefunden hat, und es hatte keine gefunden, also gab es einen grünen Haken aus. Die alte Version versuchte außerdem, hinter den Kulissen eine Anmeldung der GitHub CLI auszuleihen (das ist die Zeile “checking existing gh authentication”); da jede Anfrage weiterhin fehlschlug, gab es offensichtlich keine Anmeldung zum Ausleihen.
Ist es behoben? Teilweise. Version 1.8.1 unternimmt mehr Versuche, bevor sie aufgibt: zuerst anonym, dann ein Token aus deiner Umgebung, dann die eigene Anmeldung der GitHub CLI über gh api, und bei Update-Prüfungen als letztes Mittel einen einfachen Git-Download. Aber der Quellcode von 1.8.1 zeigt: Wenn eine Quelle weiterhin nicht geprüft werden kann, zählt die Zusammenfassungszeile trotzdem nur die Aktualisierungen, die sie gefunden hat. Ein grüner Haken unter roten Kreuzen ist also weiterhin möglich, darum lies die ✗-Zeilen.
Die Lösung. Gib der CLI eine Anmeldung, was das Limit auf 5.000 Anfragen pro Stunde hebt:
- Am einfachsten: installiere die GitHub CLI und führe
gh auth loginaus. Aktuelle Versionen der skills CLI bittenghdarum, den API-Aufruf zu machen, und sehen deine Zugangsdaten nie. - Oder verwende ein Token: erstelle ein fein abgestuftes persönliches Zugriffstoken mit Lesezugriff auf öffentliche Repositories, und füge es dann deinem Shell-Profil hinzu (
~/.zshrcauf einem Mac,~/.bashrcauf einem Raspberry Pi):
bash
export GITHUB_TOKEN="github_pat_…" # read-only, public repositories
Öffne danach ein neues Terminal. Behandle den Token wie ein Passwort: Füge ihn niemals in einen Chat, einen Skill oder eine Datei ein, die du committest.
3. Aktualisieren und erneut prüfen: npx skills@latest check -g.
Problem 2: sudo bescherte mir zwei Skill-Speicher und einen npm-Fehler
Auf meinem Raspberry Pi hatte ich mir angewöhnt, sudo su zuerst einzutippen. Das hat es ausgegeben:
graham@pi:~ $ sudo su
root@pi:/home/graham# npx skills update
npm error config prefix cannot be changed from project config: /home/graham/.npmrc.
◇ Update scope
│ Both
Checking for skill updates…
Global Skills
…
Found 6 global update(s)
…
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…
Und einen Moment später, wieder als mein normaler Benutzer:
graham@pi:~ $ ls ~/.agents/skills | wc -l
7
graham@pi:~ $ sudo ls /root/.agents/skills | wc -l
37
Was passiert ist. sudo su macht dich zu root, und root hat sein eigenes Home-Verzeichnis, /root. Skills werden pro Benutzer gespeichert, die globalen Skills von root liegen also in /root/.agents/skills und meine in /home/graham/.agents/skills. Jede globale Installation, die ich je als root gemacht hatte, war im Speicher von root gelandet: 37 Skills dort, 7 bei mir. Wenn deine Agenten als dein normaler Benutzer laufen, was die übliche Einrichtung ist, ist alles im Speicher von root für sie unsichtbar.
Der npm-Fehler hat dieselbe Ursache. Unter root ist die persönliche Einstellungsdatei von npm /root/.npmrc, sodass die /home/graham/.npmrc im Ordner, in dem ich mich befand, stattdessen als eine Projekt Projekt-Einstellungsdatei gelesen wird. Der Code von npm selbst lässt nicht zu, dass eine Projektdatei die prefix Einstellung ändert, und protokolliert genau diesen Fehler. Es gibt ein drittes Risiko, das du nicht sofort siehst: Alles, was root in dein Home-Verzeichnis schreibt, gehört danach root, und dein normaler Benutzer kann es später nicht aktualisieren.
Die Lösung.
- Verlasse root: Typ
exit. Führe die CLI und deine Agenten ab jetzt als du selbst aus. - Finde heraus, unter welchem Benutzer deine Agenten laufen. Das Home-Verzeichnis, das ihre Einstellungen enthält, ist das entscheidende:
bash
ls -d ~/.claude ~/.config/opencode ~/.hermes 2>/dev/null
sudo ls -d /root/.claude /root/.config/opencode /root/.hermes 2>/dev/null
- Installiere roots Skills als du selbst neu, von ihren ursprünglichen Quellen. Wenn du die Dateien einfach kopierst, übernimmst du roots Eigentümerschaft und veraltete Einträge. Eine Neuinstallation schreibt eine saubere Lock-Datei. Liste zuerst die Quellen auf, die root verwendet hat:
bash
sudo grep '"source"' /root/.agents/.skill-lock.json | sort -u
Dann startest du aus einem Projektordner oder /tmp, den Befehl npx skills add <owner/repo> -g -a <your agents> für jedes, das du noch willst.
4. Gib dir deine eigenen Ordner zurück, falls root hineingeschrieben hat:
bash
sudo chown -R "$(id -un)":"$(id -gn)" ~/.agents ~/.claude ~/.hermes ~/.config/opencode 2>/dev/null
- Erst wenn alles unter deinem Benutzer funktioniert, lösche roots Kopie mit
sudo rm -rf /root/.agents.
Wenn du sudo benutzt, weil globale npm-Installationen ohne es fehlschlagen, behebe das stattdessen anders: Richte npm’s prefix auf einen Ordner, der dir gehört (npm config set prefix ~/.npm-global, dann füge ~/.npm-global/bin zu deinem PATHhinzu). Das ist fast sicher das, was die prefix Zeile in meiner eigenen .npmrc gemacht hat.
Problem 3: Im Home-Ordner ausgeführt, wird es ein “Projekt”
Wieder als ich selbst, in meinem Home-Ordner:
graham@pi:~ $ npx skills check
Need to install the following packages:
[email protected]
Ok to proceed? (y) y
…
Global Skills
No global skills tracked in lock file.
Install skills with npx skills add <package> -g
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…
Was passiert ist. Die CLI betrachtet einen Ordner als Projekt, wenn er eine skills-lock.json Datei oder einen .agents/skills Ordner mit einem Skill enthält. Dein Home-Ordner enthält ~/.agents/skills, weil dort die globalen Skills liegen. Ab ~ sieht die CLI also ein Projekt. Und wenn du jemals npx skills add in deinem Home-Ordner ausgeführt hast ohne -g, hast du dort eine echte Projektinstallation angelegt, mit eigener ~/skills-lock.json, deren Skill-Ordner genau derselbe Ordner ist, den die globale Installation nutzt. Genau das war auf meinem Pi passiert: sieben Skills, die als “Projekt” in meinem Home-Ordner geführt wurden, und gar nichts in meiner eigenen globalen Lock-Datei.
“No global skills tracked in lock file” hat drei häufige Ursachen: Du hast nie mit -ginstalliert, du hast mit -g als anderer Benutzer (root, via sudo) installiert, oder die Lock-Datei wurde gelöscht. Wenn du anderswo gelesen hast, dass ein generate-lock Befehl sie neu aufbaut, den gibt es nicht: Weder in Version 1.5 noch in 1.8 gibt es einen solchen Befehl.
Die Lösung.
- Führe die CLI aus einem Projektordner aus oder
/tmp, nie aus~, und übergib-goder-pdamit sie nicht raten muss. - Um ein “Projekt” im Home-Ordner zu entwirren, installiere die Skills, die du willst, mit
-gaus einem anderen Ordner neu (sie landen am selben Ort, jetzt in deiner globalen Lock-Datei erfasst), und lösche dann~/skills-lock.json. Verwendenpx skills removeaus~dafür nicht: In deinem Home-Ordner sind der Projektordner und der globale Ordner derselbe Ordner.
Problem 4: “Keine passenden Skills gefunden” wegen eines Doppelpunkts
graham@pi:~ $ npx skills remove ckm:banner-design ckm:brand ckm:design \
ckm:design-system ckm:slides ckm:ui-styling
◇ 7 eindeutige installierte Skill(s) gefunden
■ Keine passenden Skills gefunden für: ckm:banner-design, ckm:brand, ckm:design, ckm:design-system, ckm:slides, ckm:ui-styling
Was passiert ist. Diese Skills erscheinen als ckm:banner-design, aber ein Doppelpunkt ist ein riskantes Zeichen in einem Ordnernamen, deshalb hat die CLI sie gespeichert als ckm-banner-design: dabei wird der Name kleingeschrieben und alles außer Buchstaben, Ziffern, Punkten und Unterstrichen in einen Bindestrich umgewandelt. Version 1.5.18 hat meine Eingabe exakt mit den Ordnernamen verglichen, deshalb passte nichts.
Ist es behoben? Ja. Aktuelle Versionen wandeln deine Eingabe vor dem Vergleich genauso um, also ckm:brand und ckm-brand funktionieren beide, und wenn nichts passt, gibt 1.8.1 die Namen aus, die sind installiert sind.
Die Lösung. Laufen npx skills ls (oder ls ~/.agents/skills) um die echten Namen zu sehen, oder führe npx skills remove ohne Argumente aus und wähle aus der Liste. Prüfe auch den Geltungsbereich: Wenn du aus einem Projektordner heraus einen Skill entfernst, der in deiner globalen Lock-Datei eingetragen ist, sagt dir der Befehl jetzt, du sollst -g.
Problem 5: sechs Skills scheitern, einer aus demselben Repository funktioniert
Aktualisiere 7 Skill(s)…
✗ Prüfung auf gelöschte Skills aus nextlevelbuilder/ui-ux-pro-max-skill fehlgeschlagen
Aktualisiere ckm:banner-design…
✗ ckm:banner-design konnte nicht aktualisiert werden
… (fünf weitere ✗)
Aktualisiere ui-ux-pro-max…
✓ ui-ux-pro-max aktualisiert
Was passiert ist. Um einen Skill zu aktualisieren, sucht die CLI ihn erneut in seinem Quell-Repository. Sechs meiner sieben Skills aus diesem Repository waren nicht zu finden, während der siebte sich problemlos aktualisieren ließ. Wenn die meisten Skills aus einer Quelle scheitern und einer klappt, wurden die fehlenden in der Regel upstream umbenannt, verschoben oder entfernt. Das README dieses Repositorys beschreibt heute nur noch einen einzigen Skill, ui-ux-pro-max, und erwähnt Banner, Markenidentität und Slides nur noch als Funktionen eines kostenpflichtigen Tarifs, was dazu passt, dass die sechs das kostenlose Repository verlassen haben.
Die Lösung. Schau dir an, was die Quelle heute anbietet, und entferne dann, was verschwunden ist:
npx skills add nextlevelbuilder/ui-ux-pro-max-skill --list
npx skills remove ckm-banner-design ckm-brand ckm-design ckm-design-system ckm-slides ckm-ui-styling
Aktuelle Versionen der CLI bemerken Skills, die upstream gelöscht wurden, bieten beim Aktualisieren an, sie aufzuräumen, und entfernen fehlende Skills beim Deinstallieren aus der Lock-Datei. Sieh dich dort auch nach Duplikaten um: Wenn du zusätzlich einen einfachen brand Skill neben ckm-brand, behalte einen. Zwei Skills mit fast identischen Beschreibungen verwirren die Auswahl des Agenten und verschwenden sein Budget für die Auflistung.
Bonus: Claude Code sieht einen von der CLI installierten Skill nicht
- Prüfe den Link. Claude Code liest nur seine eigenen Ordner, deshalb sollte
ls -la ~/.claude/skills(oder.claude/skillsim Projekt) den Skill anzeigen, üblicherweise als Link nach.agents/skills. Mehrere 1.5-Releases haben Fehler bei den Links von Claude Code behoben (1.5.16 und 1.5.20); wenn er fehlt, installiere ihn neu mitnpx skills@latest add … -a claude-code. - Prüfe, ob die Datei korrekt beginnt. Die öffnende
---des Front Matter muss die allererste Zeile vonSKILL.mdsein, sonst behandelt Claude Code die ganze Datei als reinen Text. - Neu laden. Claude Code übernimmt bearbeitete Skills sofort, aber ein Skills-Ordner, der nach dem Start der Sitzung angelegt wurde, braucht
/reload-skills. Dann/skillslistet auf, was geladen ist.

Teil 7 — MCP-Server ohne Fachchinesisch
Was passiert, wenn du einen Server verbindest
- Du fügst den Server in den Einstellungen deines Agenten hinzu: einen Befehl für einen lokalen Server, eine Webadresse für einen entfernten.
- Wenn eine Sitzung startet, startet der Agent den lokalen Server oder verbindet sich mit dem entfernten und meldet sich an, wenn der Server das verlangt.
- Der Server listet seine Tools auf, und der Agent reicht ihre Beschreibungen an das Modell weiter.
- Wenn eine Aufgabe ein Tool braucht, fragt das Modell danach, dein Agent prüft deine Berechtigungsregeln (und fragt dich vielleicht), der Server erledigt die Arbeit, und das Ergebnis geht zurück in die Unterhaltung.
Lokal oder entfernt?
| Lokaler Server (stdio) | Entfernter Server (Streamable HTTP) | |
|---|---|---|
| Läuft | Auf deinem Rechner, vom Agenten gestartet | Auf den Rechnern des Anbieters |
| Du gibst an | Einen Befehl, wie npx @playwright/mcp@latest |
Eine Adresse, wie https://mcp.context7.com/mcp |
| Anmeldung | Meist ein API-Schlüssel in einer Umgebungsvariable | Meist OAuth im Browser oder ein Schlüssel in einem Header |
| Braucht | Node.js, Python oder Docker, je nach Server | Eine Internetverbindung |
| Am besten für | Dinge auf deinem Rechner: ein Browser, Dateien, eine lokale Datenbank | Cloud-Dienste: GitHub, Sentry, Dokumentation, Projekt-Tools |
| Aufpassen bei | Er läuft mit den vollen Rechten deines Benutzers | Deine Daten gehen an diesen Anbieter |
In älteren Leitfäden siehst du vielleicht noch einen dritten Typ, SSE. Die Dokumentation von Claude Code markiert ihn als veraltet; nutze die HTTP-Adresse, wenn ein Server beides anbietet.
Ein Wort zu Versionen
Die aktuelle MCP-Spezifikation, veröffentlicht am 28. Juli 2026, ist die größte Überarbeitung seit dem Start des Protokolls: Ihr Kern ist jetzt zustandslos, wodurch entfernte Server hinter gewöhnlichen Load Balancern laufen können. Du musst dich selten darum kümmern, denn Clients und Server einigen sich darauf, welche Revision sie sprechen, und ältere Server funktionieren weiter. OpenCode ist die eine Stelle, an der du es sehen könntest: Jeder Server hat eine protocol Einstellung (legacy standardmäßig, ), und Connection-Pooling funktioniert nur mit der neuesten Revision., oder 2026-07-28), und Connection-Pooling funktioniert nur mit der neuesten Revision.
Die Kontextrechnung – und wie du sie klein hältst
Jedes Tool, das ein Server anbietet, kommt mit einer Beschreibung, die für das Modell geschrieben ist. Mit OpenCode’s eigenen Worten: “MCP-Tools verbrauchen Modellkontext, also füge nur die Server hinzu, die du brauchst.” Zwei Agenten mildern die Kosten inzwischen standardmäßig:
- Claude Code nutzt die Tool-Suche. Zu Beginn einer Sitzung lädt es nur die Tool-Namen und die Anweisungen der einzelnen Server und holt die vollständige Definition eines Tools erst, wenn Claude tatsächlich danach sucht.
- OpenCode nutzt Code Mode, das die Tools jedes Servers hinter einem Eintrag bündelt, statt jedes Tool einzeln aufzulisten. Es ist an, außer du setzt
"codemode": falsefür einen Server.
Überall sonst und zusätzlich zu diesen Voreinstellungen sind das deine Steuerungsmöglichkeiten:
| Agent | Einen Server abschalten | Blende Tools aus, die du nicht brauchst |
|---|---|---|
| OpenCode | "disabled": true, oder /mcps für eine Sitzung |
A deny Regel auf <server>_<tool> in den Berechtigungen |
| Claude Code | claude mcp remove <name> (/mcp zeigt Status) |
A deny Berechtigungsregel auf mcp__<server>__<tool>; ENABLE_TOOL_SEARCH entscheidet, wie viel vorab geladen wird |
| Codex | enabled = false |
enabled_tools und disabled_tools |
| Gemini CLI | gemini mcp disable <name> (ergänze --session für eine Sitzung) |
includeTools und excludeTools |
| Cursor | Der Schalter des Servers unter Anpassen | (Admins können Tool-Allowlists festlegen) |
| Hermes Agent | enabled: false |
tools.include und tools.exclude |
Meine Regel: zwei bis fünf Server, die du jede Woche nutzt, schlagen zwanzig, die du vielleicht irgendwann brauchst. Entferne den Rest; du kannst sie in einer Minute wieder hinzufügen.
Vier Server, die du zuerst ausprobieren solltest
| Server | Was es deinem Agenten bringt | Typ | Adresse oder Befehl | Anmeldung |
|---|---|---|---|---|
| Context7 | Aktuelle, versionsspezifische Dokumentation für beliebte Bibliotheken und Frameworks | Remote | https://mcp.context7.com/mcp |
Nicht erforderlich; ein kostenloser API-Schlüssel erhöht die Limits |
| GitHub (offiziell) | Issues, Pull Requests, Codesuche, Actions | Remote | https://api.githubcopilot.com/mcp/ |
OAuth, wo dein Agent es unterstützt, oder ein persönliches Access-Token |
| Playwright | Ein echter Browser, den der Agent öffnen, durchklicken und per Screenshot festhalten kann | Lokal | npx @playwright/mcp@latest |
Keine |
| Sentry | Deine echten Fehler und Abstürze | Remote | https://mcp.sentry.dev/mcp |
OAuth |
Wo du mehr findest:
- Das offizielle MCP Registry, das von den Beitragenden des Protokolls gepflegt wird, listet veröffentlichte Server.
- Die eigene Dokumentation deiner Tools. Die meisten Dienste veröffentlichen inzwischen einen offiziellen Server; suche in ihrer Doku nach “MCP”.
- Der Katalog deines Agenten. Hermes Agent hat
hermes mcp catalog, und viele Claude Code Plugins bringen ihre eigenen Server mit.
Bevorzuge Server, die von dem Unternehmen veröffentlicht werden, das den Dienst betreibt. Ein beliebiger Server namens “github-mcp-pro” verdient dasselbe Misstrauen wie eine beliebige Browser-Erweiterung.
Die leichtere Option: ein Kommandozeilen-Tool plus ein Skill
Bevor du einen Server hinzufügst, prüfe, ob ein Kommandozeilen-Tool die Aufgabe erledigt. Context7 selbst bietet beide Wege: den MCP-Server oben oder ein kleines CLI mit einem Skill (npx ctx7 setup --opencode, das Node.js 22.13 oder neuer benötigt). GitHubs eigenes gh Tool plus ein kurzer Skill deckt das meiste ab, was sein Server tut.
Ein Server ergibt Sinn, wenn dein Agent keine Befehle ausführen kann (etwa eine Desktop-Chat-App), der Dienst kein gutes CLI hat oder die Aufgabe interaktiv ist, wie das Steuern eines Browsers. Ein CLI plus ein Skill ergibt Sinn, wenn das Tool schon existiert: es kostet nichts, bis es benutzt wird, und seine Ausgabe lässt sich kürzen, bevor sie das Modell erreicht. Mein OpenCode-Leitfaden argumentiert genauso für die App-Entwicklung.
Teil 8 — Einen MCP-Server in sechs Agenten hinzufügen: Rezepte zum Kopieren
Jede Anleitung fügt dieselben zwei Server hinzu: Context7 (remote) und Playwright (lokal). Tausche auf dieselbe Weise jeden anderen Server ein. Wenn ein Agent sowohl einen Befehl als auch eine Einstellungsdatei hat, schreibt der Befehl einfach die Datei für dich.
OpenCode
opencode mcp add context7 --url https://mcp.context7.com/mcp
opencode mcp add playwright -- npx @playwright/mcp@latest
opencode mcp list
Hinzufügen --global um einen Server in jedem Projekt verfügbar zu machen. In opencode.jsonc sieht dieselbe Einrichtung so aus:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp",
"oauth": false
// With a free API key, add:
// "headers": { "Authorization": "Bearer {env:CONTEXT7_API_KEY}" }
},
"playwright": {
"type": "local",
"command": ["npx", "@playwright/mcp@latest"]
}
}
}
}
- Secrets kommen rein als
{env:NAME}; OpenCode expandiert kein einfaches$NAME. - Remote-Server versuchen automatisch OAuth;
oauth: falseist für Server, die einen Schlüssel oder gar keinen verwenden. Melde dich an mitopencode mcp auth <name>, und über SSH fügst du die Callback-URL von der fehlgeschlagenen Browserseite in die Eingabeaufforderung ein. - Innerhalb einer Sitzung,
/mcpsverbindet, trennt oder meldet sich bei Servern an. - Jedes Tool wird zu einer Berechtigungsaktion namens
<server>_<tool>, also{ "action": "playwright_*", "resource": "*", "effect": "ask" }lässt jede Browseraktion zuerst nachfragen.
Claude Code
claude mcp add --transport http context7 https://mcp.context7.com/mcp
claude mcp add playwright -- npx @playwright/mcp@latest
claude mcp list
Die -- trennt die Optionen von Claude Code vom eigenen Befehl des Servers. Server verwenden standardmäßig lokalen Geltungsbereich (du, in diesem Projekt). Füge --scope user für alle deine Projekte hinzu, oder --scope project um eine .mcp.json Datei zu schreiben, die du für dein Team committen kannst:
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
.mcp.jsonerweitert${VAR}und${VAR:-default}, damit Schlüssel in deiner Umgebung bleiben und nicht in Git landen./mcpzeigt innerhalb einer Sitzung den Status jedes Servers an und übernimmt die OAuth-Anmeldung.- Claude Code fragt nach, bevor es Server aus der
.mcp.jsoneines Projekts nutzt, sodass ein geklontes Repository nicht heimlich eigene hinzufügen kann.
Codex
Codex speichert Server in ~/.codex/config.toml, oder in .codex/config.toml innerhalb eines Projekts, das du als vertrauenswürdig markiert hast:
[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
- Remote-Server lassen sich auch hinzufügen mit
codex mcp add context7 --url https://mcp.context7.com/mcp, undcodex mcp login <name>startet eine OAuth-Anmeldung. - Für einen Schlüssel
bearer_token_env_var = "CONTEXT7_API_KEY"liest ihn aus deiner Umgebung. - Begrenze einen Server mit
enabled_toolsunddisabled_tools;startup_timeout_sec(standardmäßig 10 Sekunden) hilft langsamen Servern beim Start.
Gemini CLI
gemini mcp add -t http context7 https://mcp.context7.com/mcp
gemini mcp add playwright npx @playwright/mcp@latest
gemini mcp list
gemini mcp add schreibt in die Projekt- Einstellungen standardmäßig; füge -s user für jedes Projekt hinzu. In settings.json:
{
"mcpServers": {
"context7": { "httpUrl": "https://mcp.context7.com/mcp" },
"playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] }
}
}
httpUrlsteht für Streamable HTTP;urlbedeutet den älteren SSE-Typ.- Lass
trustaus. Aufwahrgesetzt, werden alle Bestätigungen für diesen Server übersprungen. - Die Gemini CLI entfernt Variablen, die wie Geheimnisse aussehen (Namen mit TOKEN, SECRET, PASSWORD oder KEY), aus der Umgebung eines Servers, sofern du sie nicht in ihrem
envblock auflistest. - OAuth braucht einen Browser auf derselben Maschine. In einem nicht vertrauenswürdigen Ordner bleiben lokale Server getrennt, bis du
gemini trust.
Cursor
Cursor liest .cursor/mcp.json in einem Projekt und ~/.cursor/mcp.json für alles:
{
"mcpServers": {
"context7": { "url": "https://mcp.context7.com/mcp" },
"playwright": {
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
- Lokale Server brauchen
"type": "stdio". - Secrets kommen rein als
${env:NAME}. - Schalte Server über ihre Schalter unter Anpassen.
Hermes Agent
Hermes liest mcp_servers in ~/.hermes/config.yaml:
mcp_servers:
context7:
url: "https://mcp.context7.com/mcp"
playwright:
command: "npx"
args: ["@playwright/mcp@latest"]
- Laufen
/reload-mcpnach dem Bearbeiten, undhermes mcp test context7um genau zu sehen, was ein Server geantwortet hat. - Für OAuth-Dienste füge
auth: oauthzu einem HTTP-Eintrag hinzu. Auf einer Maschine ohne Bildschirm bietet Hermes Paste-Back, SSH-Portweiterleitung oder einen Geräte-Anmeldeablauf. - Hermes übergibt lokalen Servern nur die Variablen, die du in
envplus einer sicheren Basis, nicht deine gesamte Shell-Umgebung. - Tools erscheinen als
mcp_<server>_<tool>; filtere sie mittools.includeodertools.exclude.
Prüfe, ob es funktioniert, und zwar in jedem Agenten
Stelle eine Frage, die nur der Server beantworten kann: “Nutze Context7, um nachzuschlagen, wie man eine Route in der aktuellen Version von Next.js definiert, und sag mir, welches Tool du aufgerufen hast.” Dann frage nach etwas Sichtbarem: “Öffne example.com mit Playwright und beschreibe die Seite.” Wenn der Agent sagt, er habe keine solchen Tools, liste die Server auf (opencode mcp-Liste, claude mcp list, gemini mcp list, hermes mcp test) und achte auf eine fehlgeschlagene Verbindung oder eine Anmeldung, die nie abgeschlossen wurde.

Teil 9 — Plugins: Skills und MCP-Server in einer Box
Zehn Skills und drei Server einzeln zu installieren, wird irgendwann lästig. Plugins bündeln sie, und die meisten Agenten haben inzwischen irgendein Plugin-System.
Plugins für Claude Code
Ein Plugin für Claude Code kann Skills, Subagenten, Hooks, MCP-Server und Language-Server enthalten. Plugins kommen aus Marktplätzen, also einfach Katalogen, die in einem Git-Repository gehostet werden:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
In einer Sitzung /plugin install öffnet zuerst die Details des Plugins, damit du genau siehst, was es hinzufügt, bevor du einen Geltungsbereich wählst: dich (jedes Projekt), dieses Repository für alle oder dieses Repository nur für dich. Aus deiner Shell claude plugin install <name>@<marketplace> macht dasselbe ohne Sitzung.
Drei Funktionen, die du kennen solltest:
- Die Kontextkosten sind sichtbar. Bei Plugins in Anthropics offiziellem Marktplatz schätzt der Detailbereich, was das Plugin zu jeder Nachricht hinzufügt und was es bei Nutzung hinzufügt.
claude plugin details <name>zeigt die Zahl pro Sitzung für alles Installierte. - Updates. Anthropics offizieller Marktplatz aktualisiert Plugins automatisch; Marktplätze von Drittanbietern tun das nicht, es sei denn, du schaltest es ein.
claude plugin update <name>@<marketplace>aktualisiert ein Plugin von Hand. - Ungenutzte Plugins werden markiert. Der Tab „Installiert“ gruppiert Plugins, die du in letzter Zeit nicht genutzt hast, was den Frühjahrsputz einfach macht.
Plugins anderswo
- Codex verteilt wiederverwendbare Skills über Plugins (
/pluginsin der CLI), und ein Plugin kann auch MCP-Server-Verbindungen mitbringen. - Gemini CLI nennt sie Erweiterungen:
gemini extensions install <git-url>undgemini extensions update <name>. - GitHub Copilot CLI (
copilot plugin install) und Hermes Agent (hermes plugins install) haben Plugin-Befehle, und Cursor hat/add-pluginim Agent-Chat. - OpenCode Plugins sind JavaScript- oder TypeScript-Pakete, die in der
Plugin-Einstellung seiner Konfiguration aufgeführt sind, die Skills und Tools registrieren kann. Superpowers wird auf diese Weise installiert.
Die zwei Regeln, die ein Plugin-Setup vernünftig halten
- Ein Kanal pro Paket. Wenn ein Skill-Paket sowohl als Plugin als auch als einfache Skills existiert, wähle eines. Zwei Kopien bedeuten doppelte Namen und einen Agenten, der das nimmt, was er zuerst sieht.
- Aktualisiere dort, wo du installiert hast. Die skills-CLI weiß nichts von Plugins, und Plugin-Manager wissen nichts von
~/.agents/skills.
Teil 10 — Schreib deinen ersten Skill in zehn Minuten
Der beste erste Skill löst eine Aufgabe, die du immer wieder machst. Hier ist einer aus Teil 6: ein Skill, mit dem jeder Agent deine Skills auf Updates prüfen kann sicher, ohne je sudo zu verwenden oder einem grünen Haken blind zu vertrauen.
Schritt 1 — Den Ordner anlegen
mkdir -p ~/skills-drafts && cd ~/skills-drafts
npx skills init skills-housekeeping
Das legt skills-housekeeping/SKILL.md aus einer Vorlage an. Ersetze den Inhalt durch Folgendes:
---
name: skills-housekeeping
description: Prüft installierte Agenten-Skills mit der npx skills CLI auf Updates und Probleme und erklärt die Ergebnisse in einfachem Englisch. Verwende den Skill, wenn gefragt wird, ob Skills aktuell sind, wenn Skills aktualisiert werden sollen oder wenn ein installierter Skill zu fehlen scheint.
metadata:
author: graham-miranda
version: "1.0"
---
# Skills-Haushalt
## Regeln
- Führe niemals einen Befehl mit sudo aus.
- Führe `npx skills update` oder `npx skills remove` niemals aus, ohne vorher zu fragen.
- Führe Befehle aus /tmp oder einem Projektordner aus, niemals aus dem Home-Ordner.
## Prüfen
1. Führe `cd /tmp && npx skills@latest check -g` für globale Skills aus.
2. Wenn das aktuelle Projekt eine Datei skills-lock.json hat, führe zusätzlich `npx skills@latest check -p` im Projektordner aus.
3. Behandle jede Zeile, die mit ✗ beginnt, als "nicht geprüft", auch wenn eine spätere Zeile sagt, alles sei aktuell.
## Bericht
- Liste Skills mit Updates, Skills mit lokalen Änderungen und alles, was nicht geprüft werden konnte.
- Wenn eine Prüfung fehlgeschlagen ist, schlage `gh auth login` vor oder einen GITHUB_TOKEN mit Lesezugriff auf öffentliche Repositories.
- Frage vor dem Aktualisieren. Führe dann `npx skills update -g` (oder `-p`) aus und berichte, was sich geändert hat.
Schritt 2 — Gegen den Standard prüfen
- Name:
skills-housekeepingverwendet nur Kleinbuchstaben und Bindestriche, ist kürzer als 64 Zeichen und stimmt mit dem Namen des Ordners überein. Alle drei Bedingungen sind Pflicht. - Beschreibung: sie sagt was was der Skill tut und wenn wann du ihn verwendest, und sie enthält die Wörter, die Leute tatsächlich eintippen (“up to date”, “update skills”, “missing”). Die Beschreibung ist der einzige Teil, den der Agent vor seiner Entscheidung sieht, also leistet sie den Großteil der Arbeit. Der Standard erlaubt bis zu 1.024 Zeichen; ziele auf ein oder zwei Sätze.
- Länge: deutlich unter den empfohlenen 500 Zeilen. Wenn ein Skill wächst, verschiebe Details in
references/und verweise aus den Anweisungen darauf.
Das Agent-Skills-Projekt veröffentlicht einen Referenz-Validator, skills-ref, der das Front Matter und die Namensregeln prüft: skills-ref validate ./skills-housekeeping.
Schritt 3 — Für alle Agenten auf einmal installieren
Die skills-CLI installiert auch aus einem lokalen Ordner:
npx skills add ./skills-housekeeping -g -a opencode -a claude-code -a codex
Das legt die echte Kopie in ~/.agents/skills/skills-housekeeping (wird direkt von OpenCode und Codex gelesen) und setzt einen Link in ~/.claude/skills für Claude Code.
Schritt 4 — Testen
Frag einfach in normalen Worten: “Sind meine Skills aktuell?” Ein gut beschriebener Skill wird automatisch erkannt. Wenn nicht, ruf ihn beim Namen auf, um ein Ladeproblem auszuschließen: @skills-housekeeping in OpenCode, /skills-housekeeping in Claude Code, $skills-housekeeping in Codex. Wenn er sich per Name laden lässt, aber nie von selbst, liegt das Problem an der Beschreibung: Ergänze die Formulierungen, die du tatsächlich verwendest.
Schritt 5 — Teilen
Schieb den Ordner in ein GitHub-Repository, am besten in einen skills/ Ordner (skills/skills-housekeeping/SKILL.md). Dann kann ihn jeder installieren mit npx skills add your-name/your-repo. Die CLI findet Skills in skills/ und in gängigen Agenten-Ordnern, bis zu drei Ebenen tief.
Agentenspezifische Extras und wann du sie vermeidest
Mehrere Agenten verstehen zusätzliche Front-Matter-Felder. Claude Code hat disable-model-invocation (nur du kannst den Skill auslösen) und context: fork (führ ihn in einem Subagenten aus); Cursor hat Pfade (nur für passende Dateien); OpenCode kann einen Skill vor dem Modell verbergen mit metadata eingestellt auf opencode/autoinvoke: false. Sie sind nützlich, aber nur die Standardfelder reisen mit. Die eigene Dokumentation von Claude Code merkt an, dass außerhalb von Claude Code, bei Uploads in claude.ai oder über die Skills API, nur die Standardfelder akzeptiert werden und alles andere ein Fehler ist. Bei Skills, die du teilst, bleib bei Name, Beschreibung, license, compatibility, metadata und den experimentellen allowed-tools.

Teil 11 — Sicher bleiben: Skills und Server sind Software
Man denkt leicht, ein Skill sei “nur eine Markdown-Datei”. Ist er aber nicht. Es sind Anweisungen, denen dein Agent folgt mit deinen Berechtigungen, oft mit Skripten, die er auf deinem Rechner ausführt. Und ein lokaler MCP-Server ist ein Programm, das als du läuft.
Die Zahlen aus diesem Jahr sind ernüchternd. Snyks ToxicSkills-Studie, veröffentlicht im Februar 2026, hat 3.984 öffentliche Agenten-Skills untersucht: 36,82 % hatten mindestens eine Sicherheitslücke, 13,4 % eine kritische, und 76 enthielten bestätigte schädliche Payloads. Der Ärger konzentrierte sich auf ClawHub, den Community-Marktplatz für OpenClaw, wo ein früheres Audit von 2.857 Skills, ebenfalls von Snyk gemeldet, 341 bösartige gefunden hatte, etwa 12 % des damaligen Registers. Die 100 beliebtesten Skills auf skills.sh lösten dagegen keinen von Snyks Prompt-Injection- oder Malware-Prüfungen aus. Beliebtheit ist kein Beweis, aber sie hilft.
MCP hat seine eigene Variante des Risikos. In der Dokumentation von Claude Code wird gewarnt, dass Server, die externe Inhalte abrufen, dich Folgendem aussetzen können Prompt-Injection: einer Webseite, einem Issue-Kommentar oder einem Crash-Bericht, der Text enthält, der sich an deinen Agenten richtet statt an dich.
Zehn Gewohnheiten, die dich sicher halten
- Lies, bevor du installierst. Verwende
npx skills add owner/repo --list,gh skill preview, oder öffne einfach dieSKILL.mdund ihre Skripte auf GitHub. - Bevorzuge Hersteller und bekannte Autoren. Expo’s Skills für Expo, die von Vercel für Next.js, der offizielle MCP-Server eines Anbieters für seinen eigenen Dienst.
- Prüfe die Audits. Jeder Skill auf skills.sh zeigt die Ergebnisse von drei Scannern: Gen Agent Trust Hub, Socket und Snyk. “Pending” bedeutet, dass noch niemand hingeschaut hat.
- Pinne alles, was wichtig ist.
npx skills add owner/[email protected], odergh skill install … --pin v1.2.3, damit Updates nur dann passieren, wenn du es willst. - Prüfe Updates wie Code.
npx skills check, lies dann die Änderungen auf GitHub, dannnpx skills update. - Skills von Drittanbietern hinter eine Freigabe legen. In OpenCode nutzen Regeln die
skillAktion, und der letzte Treffer gewinnt:
jsonc
"permissions": [
{ "action": "skill", "resource": "*", "effect": "ask" },
{ "action": "skill", "resource": "skills-housekeeping", "effect": "allow" },
{ "action": "playwright_*", "resource": "*", "effect": "ask" }
]
Hermes Agent scannt jede Installation aus dem Hub, und --force kann ein “dangerous”-Urteil nicht überschreiben. Gemini CLI holt deine Zustimmung ein, bevor ein Skill aktiviert wird.
7. Gib Servern den geringsten Zugriff, der funktioniert. Nur-Lese-Tokens mit feiner Granularität; separate Tokens pro Server; Tools zum Schreiben und Löschen auf “ask” oder herausgefiltert.
8. Halte Geheimnisse aus Skills und aus committeter Konfiguration heraus. Nutze Umgebungsvariablen ({env:NAME} in OpenCode, ${VAR} in der Konfiguration von Claude Code .mcp.json, ${env:NAME} in Cursor), niemals eingefügte Schlüssel.
9. Sei vorsichtig mit den Projekteinstellungen anderer Leute. Ein geklontes Repository kann seine eigenen .mcp.json oder Skills mitbringen. Claude Code fragt nach, bevor es Projektserver verwendet, Gemini CLI hält lokale Server in nicht vertrauenswürdigen Ordnern getrennt, und Hermes Agent lädt Projektskills erst nach hermes skills trust. Klicke dich nicht im Autopilot durch diese Abfragen.
10. Deinstalliere, was du nicht verwendest. Jeder ungenutzte Skill und jeder ungenutzte Server ist Angriffsfläche, die du mit Kontext bezahlst.

Teil 12 — Eine Zwei-Minuten-Routine pro Woche
Skills und Server driften. Eine kleine Routine hält sie ehrlich:
# Globale Skills, aus einem neutralen Ordner
cd /tmp && npx skills@latest check -g
# Jedes Projekt, an dem du gerade arbeitest
cd ~/code/my-app && npx skills@latest check -p
# Nachdem du gelesen hast, was sich upstream geändert hat:
npx skills update -g
Einmal im Monat nimmst du dir fünf Minuten mehr:
- Ausdünnen.
npx skills ls -gund entferne, was du nicht benutzt hast. In Claude Code listet das Plugin-Panel die Plugins auf, die du in letzter Zeit nicht benutzt hast. - Liste deine Server auf.
opencode mcp-Liste,claude mcp list,gemini mcp listoderhermes mcp testfür jedes. Entferne alles, was du vergessen hast hinzuzufügen. - Tokens rotieren die du Servern gegeben hast, besonders solchen mit Schreibrechten.
Zwei Rechner, ein Setup
Ich betreibe Agenten auf einem Mac und einem Raspberry Pi, und drei Gewohnheiten halten sie im Gleichschritt:
- Auf beiden derselbe Ansatz: deinen normalen Benutzer, niemals
sudo, und die CLI aus einem Projektordner oder/tmp. - Projekt-Skills reisen mit Git. Commit
.agents/skillsundskills-lock.json; auf dem anderen Rechner,npx skills installstellt exakt dieselben Versionen wieder her. - Globale Skills kommen aus einem Skript. Halte dein
npx skills add … -gBefehle in eine kleine Shell-Datei und führe sie auf jedem Rechner aus. Sie dient zugleich als Dokumentation dessen, worauf du dich verlässt.
Auf einem Headless-Rechner wie einem Pi, setze GITHUB_TOKEN in ~/.bashrc damit Update-Prüfungen nicht ans anonyme Limit stoßen. Browser-Anmeldungen brauchen Sorgfalt: OpenCode lässt dich die Callback-URL in den Prompt einfügen, Hermes Agent bietet Paste-Back, SSH-Portweiterleitung oder einen Device Flow, während der OAuth-Flow von Gemini CLI einen Browser auf demselben Rechner benötigt.
Teil 13 — Welches Setup solltest du wählen? Fünf Szenarien
1. “Ich habe gerade erst mit OpenCode angefangen.”
Installieren höchstens drei Skills und einen MCP-Server. Context7 ist ein guter erster Server, und ein Release- oder Review-Skill, das zu deiner Arbeitsweise passt, ist ein gutes erstes Skill. Halte Third-Party-Skills auf fragen in OpenCodes Berechtigungen, bis du ihnen vertraust. Mein OpenCode-Leitfaden deckt den Rest der Einrichtung ab.
2. “Ich nutze OpenCode und Claude Code nebeneinander, vielleicht auch Hermes Agent.”
Installiere Skills global mit der CLI und nenne jeden Agenten: npx skills add owner/repo -g -a opencode -a claude-code -a hermes-agent. Eine Kopie, drei Agenten. MCP-Server teilen sich keine gemeinsame Konfigurationsdatei, also füge jeden bei jedem Agenten hinzu und bewahre die Liste an einem Ort auf, den du wiederfindest. Mein Vergleich von OpenCode, Hermes Agent und OpenClaw erklärt, wo jeder Agent glänzt, und mein KI-Coding-Harness-Vergleich deckt 28 davon im Vergleich ab.
3. “Mein Team teilt sich ein Repository.”
Verwende Projektumfang: committe .agents/skills, skills-lock.json, und die MCP-Einstellungen (opencode.jsonc, .mcp.json oder .cursor/mcp.json) ohne Geheimnisse darin. Jede Person bewahrt ihre Schlüssel in ihrer eigenen Umgebung auf. In CI, npx skills install --frozen-lockfile schlägt fehl, wenn die Skills von jemandem abweichen, und npx skills check -p schlägt fehl, wenn Updates anstehen.
4. “Meine Agenten laufen auf einem Raspberry Pi oder einem Server.”
Ein normaler Benutzer, kein sudo, niemals. Set GITHUB_TOKEN, bevorzuge Remote-Server, die ein Token in einem Header akzeptieren (oder eine Geräte-Anmeldung anbieten), und starte den wöchentlichen Check in /tmp. Teil 6 ist deine Checkliste.
5. “Mein Code darf meine Maschine nicht verlassen.”
Verwende nur lokale MCP-Server, und überspringe Remote-Server für Dokumentation und Codesuche. Schalte die Telemetrie der CLI aus (DISABLE_TELEMETRY=1), lies jeden Skill, den du installierst, und denk daran, dass das Modell selbst weiterhin ein Cloud-Modell sein kann: Der Datenschutz hängt auch davon ab, wo das Modell läuft. Mein Leitfaden zum Ausführen von LLMs auf einem MacBook zeigt, was der vollständig lokale Weg wirklich kostet.
Häufig gestellte Fragen
Agent Skills sind Ordner, die einem KI-Agenten beibringen, wie er eine bestimmte Aufgabe erledigt. Jeder enthält eine SKILL.md Datei mit einem Namen, einer Beschreibung und Schritt-für-Schritt-Anweisungen sowie optionalen Skripten und Referenzdateien. Der Agent liest zu Beginn einer Sitzung nur die Beschreibungen und lädt die vollständigen Anweisungen eines Skills, wenn eine Aufgabe dazu passt. Skills folgen einem offenen Standard, deshalb funktionieren die meisten in OpenCode, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot und Hermes Agent gleichermaßen.
Ein MCP-Server ist ein kleines Programm, das einem KI-Agenten über das Model Context Protocol neue Werkzeuge gibt – einen offenen Standard, der heute von der Agentic AI Foundation der Linux Foundation betreut wird. Lokale Server laufen auf deinem Computer und werden vom Agenten gestartet; Remote-Server laufen auf den Computern eines Anbieters und sind über eine Webadresse erreichbar, in der Regel mit einer Anmeldung im Browser. Beispiele sind der offizielle Server von GitHub, Context7 für aktuelle Dokumentation und Playwright zum Steuern eines Browsers.
Ein Skill gibt dem Agenten Know-how: schriftliche Anweisungen, wie eine Aufgabe zu erledigen ist, die nur bei Bedarf geladen werden. Ein MCP-Server gibt dem Agenten Fähigkeiten: Werkzeuge, die Systeme außerhalb des Terminals erreichen, etwa GitHub, einen Browser oder einen Crash-Tracker. Nutze einen Skill für Abläufe und Konventionen, einen MCP-Server für den Live-Zugriff auf ein System, und AGENTS.md für Regeln, die für jede Aufgabe gelten. Wenn es ein gutes Kommandozeilen-Tool gibt, ist ein Skill, der es dem Agenten beibringt, oft günstiger als ein Server.
Zum größten Teil, weil alle drei dem Agent-Skills-Standard folgen. Der Unterschied liegt darin, wo sie nachsehen. Codex und OpenCode lesen die gemeinsamen .agents/skills und ~/.agents/skills Ordner; OpenCode liest auch .opencode/skills und die Ordner von Claude Code. Claude Code liest nur .claude/skills und ~/.claude/skills. Einige zusätzliche Front-Matter-Felder wie das von Claude Code context: fork, funktionieren nur in einem Agenten, deshalb sollten sich gemeinsame Skills auf die Standardfelder beschränken.
Laufen npx skills add owner/repo --list um zu sehen, welche Skills ein Repository anbietet, dann npx skills add owner/repo --skill skill-name -a opencode -a claude-code um einen für die Agenten zu installieren, die du nutzt. Füge -g hinzu, damit er in jedem Projekt verfügbar ist. Du brauchst Node.js 22.20 oder neuer. Ohne Flags fragt die CLI, welche Skills und Agenten du möchtest und ob die Dateien verlinkt oder kopiert werden sollen.
Projekt-Installationen legen die echte Kopie in .agents/skills/<name> in deinem Projekt ab und vermerken sie in skills-lock.json. Globale Installationen (-g) legen sie in ~/.agents/skills/<name> und vermerken sie in ~/.agents/.skill-lock.json. Agenten, die .agents/skills lesen, nutzen diese Kopie direkt; für Agenten mit eigenem Ordner, etwa Claude Code (.claude/skills) oder Hermes Agent (~/.hermes/skills), legt die CLI einen Link darauf an.
Laufen npx skills@latest check -g für globale Skills oder npx skills@latest check -p innerhalb eines Projekts. Die CLI vergleicht den Fingerabdruck jedes Skill-Ordners in deiner Lock-Datei mit demselben Ordner im Upstream und listet jeden Skill auf, für den ein Update vorliegt, ohne etwas zu installieren. Seit Version 1.7.5 (2. November 2026) check meldet nur; npx skills update installiert. Starte es aus einem Projektordner oder /tmp, nicht aus deinem Home-Verzeichnis.
Weil die Zusammenfassung nur die Updates zählt, die sie gefunden hat. Wenn GitHubs Grenze von 60 anonymen API-Anfragen pro Stunde jede Abfrage blockiert, gibt die CLI für jede Quelle eine ✗-Zeile aus und kann trotzdem mit “Alle globalen Skills sind aktuell” enden. Melde dich an mit gh auth login oder setze ein schreibgeschütztes GITHUB_TOKEN um das Limit auf 5.000 Anfragen pro Stunde anzuheben, führe ein Upgrade durch mit npx skills@latest, und lies immer die ✗-Zeilen.
Nein. Skills werden pro Benutzer gespeichert, und root hat sein eigenes Home-Verzeichnis, also sudo installiert Skills in /root/.agents/skills, wo Agenten, die als dein normaler Benutzer laufen, sie nie sehen. Es kann außerdem Dateien im Besitz von root in deinen eigenen Ordnern hinterlassen und npm-Fehler auslösen wie “prefix cannot be changed from project config”. Führe die CLI und deine Agenten als dein normaler Benutzer aus.
Laufen opencode mcp add <name> --url <address> für einen entfernten Server, oder opencode mcp add <name> -- <command> für einen lokalen, und prüfe ihn dann mit opencode mcp-Liste. Füge --global hinzu, um es in jedem Projekt zu verwenden. Dieselben Einstellungen können auch unter mcp.servers in opencode.jsoncliegen, wobei Secrets in der Form {env:NAME}geschrieben werden. Verwende opencode mcp auth <name> zur Anmeldung, und /mcps innerhalb einer Sitzung, um Server zu verbinden oder zu trennen.
So wenige, wie du tatsächlich nutzt, meist zwei bis fünf. Die Tools jedes Servers kommen mit Beschreibungen, die das Modell lesen muss, was Kontext kostet und Antworten langsamer und weniger fokussiert machen kann. Claude Code schiebt Tool-Definitionen auf, bis sie gebraucht werden, und OpenCode gruppiert sie nach Server, was hilft, aber ungenutzte Server erhöhen trotzdem Risiko und Ballast. Entferne alles, was du einen Monat lang nicht benutzt hast.
Nur so sicher wie ihre Quelle. Ein Skill sind Anweisungen, die dein Agent mit deinen Berechtigungen befolgt, oft mit Skripten, die er ausführt. Snyks Studie vom Februar 2026 über 3.984 öffentliche Skills fand Sicherheitslücken in 36,82 % und bestätigte schadhafte Payloads in 76. Lies einen Skill und seine Skripte vor der Installation, bevorzuge Skills von den Herstellern des Tools, prüfe die Prüfergebnisse auf skills.sh, pinne Versionen und halte Drittanbieter-Skills in den Berechtigungen deines Agenten auf “ask”.
Es ist die Projekt-Lock-Datei, die die skills-CLI schreibt, wenn du Skills in ein Projekt installierst. Sie hält fest, woher jeder Skill stammt, und einen Fingerabdruck seiner Dateien. Committe sie in Git: auf einem anderen Computer npx skills install stellt genau dieselben Skills wieder her, und --frozen-lockfile schlägt der Vorgang fehl, wenn etwas abweicht. Globale Skills haben eine eigene Lock-Datei unter ~/.agents/.skill-lock.json, eine pro Benutzerkonto.
skills.sh ist Vercels öffentliches Verzeichnis für Agenten-Skills. Es sortiert Skills nach Installationen, gruppiert sie nach Thema und zeigt für jeden die Ergebnisse der Sicherheitsprüfung von Gen Agent Trust Hub, Socket und Snyk. Du installierst Skills daraus mit dem npx skills add owner/repo Befehl, den es anzeigt. Der gleiche CLI-Befehl npx skills find durchsucht das Verzeichnis von deinem Terminal aus.
Das Fazit
Agent Skills und MCP-Server beantworten zwei verschiedene Fragen. Skills beantworten “Wie machen wir das hier?”: Skills sind günstige, portable Rezeptkarten, die nur bei Bedarf geladen werden. MCP-Server beantworten “Kommst du an dieses System heran?”: Sie sind mächtige Schlüssel, die Kontext kosten und dieselbe Sorgfalt verdienen wie jede Software, die du installierst. AGENTS.md enthält die wenigen Regeln, die für alles gelten, und Berechtigungen erzwingen, was niemals passieren darf.
Wenn du fünf Dinge aus diesem Leitfaden mitnimmst, dann diese:
- Lege gemeinsame Skills in
.agents/skillsund lassnpx skillssie in die Agenten verlinken, die woanders nachsehen. - Laufen
npx skills@latest checkaus einem Projektordner oder/tmp, lies die ✗-Zeilen, und aktualisiere bewusst. - Melde dich bei GitHub an (
gh auth login) auf jedem Rechner, der nach Updates sucht. - Verwende niemals
sudomit Skills oder Agenten. - Fange mit drei Skills und einem Server an, und füge weitere nur hinzu, wenn eine echte Aufgabe sie verlangt.
Skills und Server machen aus einem cleveren Generalisten einen Kollegen, der deine Arbeitsweise kennt und an deine Werkzeuge herankommt. Der Trick ist, ihm genau das zu geben, was es braucht, und nichts, was es nicht braucht.
Du nutzt Skills oder MCP-Server, die ich nicht erwähnt habe? Ich würde gern hören, welche sich einen festen Platz in deinem Setup erobert haben und welche Fehlermeldungen dich auf die Suche geschickt haben. Korrekturen sind willkommen: Dieser Artikel wird aktualisiert, wenn sich die Tools ändern, und nach diesem Jahr zu urteilen, wird das oft passieren.
Offenlegung: Kein im Beitrag genanntes Unternehmen hat ihn gesponsert, geprüft oder genehmigt, und er enthält keine Affiliate-Links. Produkte werden nur im Text genannt; die Bilder verwenden meine eigenen Logos.
Zuletzt aktualisiert: 15. November 2026.



