Zum Inhalt springen
MONTAG, NOVEMBER 16, 2026UNABHÄNGIGE TECH-NACHRICHTEN, TESTBERICHTE UND PRAKTISCHE ANLEITUNGEN
ÜBER
AKTUELLES /

Agent Skills und MCP-Server erklärt: Installieren, aktualisieren und reparieren in OpenCode, Claude Code, Codex und anderen KI-Agenten

LESEN SIE DEN LEITFADEN
KI-AgentenGM / 997

Agent Skills und MCP-Server erklärt: Installieren, aktualisieren und reparieren in OpenCode, Claude Code, Codex und anderen KI-Agenten

Agent Skills und MCP-Server: installieren, aktualisieren und reparieren in OpenCode, Claude Code, Codex und mehr – mit der npx skills CLI, Schritt für Schritt.

Agent skills and MCP servers explained: a tech.grahammiranda.com title card with SKILL.md, npx skills, MCP servers and .agents/skills, and a terminal running npx skills check and opencode mcp add

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.md Datei: 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/skills ist der gemeinsame Ordner. Codex, OpenCode, Cursor, Gemini CLI und GitHub Copilot lesen alle .agents/skills in einem Projekt und ~/.agents/skills in deinem Home-Verzeichnis. Claude Code liest nur .claude/skills, und Hermes Agent liest ~/.hermes/skills plus alle Ordner, die du hinzufügst.
  • npx skills ist npm für Skills. Vercels Open-Source-CLI (Version 1.8.1) installiert Skills in 79 Agenten: npx skills add owner/repo, -g für jedes Projekt, -a opencode -a claude-code um Agenten auszuwählen, npx skills ls zum Auflisten und npx skills remove zum 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 update installiert. In früheren Versionen hat check still 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 login aus oder setze GITHUB_TOKEN, und lies die ✗-Zeilen.
  • Verwende niemals sudo mit Skills oder Agenten, und führe die CLI nicht aus deinem Home-Ordner aus. Root hat ein eigenes Home, also sudo legt 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
Agenten-Skills und MCP-Server erklärt: AGENTS.md als immer geladenes Handbuch, Skills als Rezeptkarten, die bei Bedarf geladen werden, MCP-Server als Werkzeuge für GitHub, einen Browser und Live-Doku, und Plugins als Bündel
Vier Bausteine, ein Agent. Das Handbuch liegt immer offen, Rezeptkarten kommen bei Bedarf aus dem Regal, und MCP-Server sind die Schlüssel zu allem außerhalb des Terminals.

Inhaltsverzeichnis


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 Version CLAUDE.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:

  1. 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.)
  2. 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.
  3. 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@latest und 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:

  1. 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.
  2. Muss es erzwungen werden, nicht nur vorgeschlagen? Nutze eine Berechtigungsregel oder einen Hook. Skills und AGENTS.md sind Anweisungen, und ein Modell kann Anweisungen ignorieren. “Niemals nach main pushen” braucht eine deny Regel.
  3. 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.
  4. 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.
  5. 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.

Skill, MCP-Server oder AGENTS.md: ein Ablauf mit fünf Fragen, der Regeln für jede Aufgabe an AGENTS.md schickt, erzwungene Regeln an Berechtigungen, Know-how an Skills und Live-Systemzugriff an einen CLI-Skill oder einen MCP-Server
Fünf Fragen, in Reihenfolge gestellt. Die meisten Wünsche entpuppen sich als Skills; ein Server verdient seinen Platz, wenn der Agent Live-Zugriff braucht und kein gutes Kommandozeilen-Tool existiert.

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/skills und ~/.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.

Wo KI-Agenten nach Skills suchen: der gemeinsame Ordner .agents/skills, den Codex, OpenCode, Cursor, Gemini CLI und GitHub Copilot lesen, mit Links für Claude Codes .claude/skills und Hermes Agents ~/.hermes/skills
Ein gemeinsamer Ordner deckt die meisten Agenten ab. Claude Code braucht immer einen Link, und Hermes Agent braucht einen für globale Skills; die skills-CLI erstellt beide.

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 einer SKILL.md oder 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.

Der Spickzettel für die npx skills CLI: die Befehle add, list, find, use, check, update, remove und init mit ihren nützlichsten Flags, die Installationsorte für Projekt und global sowie die zwei Lock-Dateien
Die skills-CLI auf einer Karte. Zwei Gewohnheiten erledigen den größten Teil der Arbeit: --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.json in einem Projekt. Committe sie in Git. Auf einem anderen Rechner oder für ein Teammitglied npx skills install stellt 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 wie package-lock.json es für Code tut.
  • ~/.agents/.skill-lock.json für deine globalen Skills. Sie gehört zu deinem Benutzerkonto (oder liegt unter $XDG_STATE_HOME/skills/.skill-lock.json wenn 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:

  • check wählt von selbst einen Bereich. Wenn der Ordner, in dem du dich befindest, eine skills-lock.json Datei oder einen .agents/skills Ordner mit einem Skill darin enthält, prüft es die Projekt Skills; andernfalls prüft es die globalen global Skills. Füge -g oder -p hinzu, 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.

Wie npx skills check funktioniert: Die Lock-Datei speichert einen Fingerabdruck jedes Skill-Ordners, check vergleicht ihn mit demselben Ordner Upstream und meldet Updates, und update installiert sie
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:

  1. Am einfachsten: installiere die GitHub CLI und führe gh auth loginaus. Aktuelle Versionen der skills CLI bitten gh darum, den API-Aufruf zu machen, und sehen deine Zugangsdaten nie.
  2. 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 (~/.zshrc auf einem Mac, ~/.bashrc auf 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.

  1. Verlasse root: Typ exit. Führe die CLI und deine Agenten ab jetzt als du selbst aus.
  2. 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

  1. 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

  1. 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 -g oder -p damit sie nicht raten muss.
  • Um ein “Projekt” im Home-Ordner zu entwirren, installiere die Skills, die du willst, mit -g aus einem anderen Ordner neu (sie landen am selben Ort, jetzt in deiner globalen Lock-Datei erfasst), und lösche dann ~/skills-lock.json. Verwende npx skills remove aus ~ 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/skills im 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 mit npx skills@latest add … -a claude-code.
  • Prüfe, ob die Datei korrekt beginnt. Die öffnende --- des Front Matter muss die allererste Zeile von SKILL.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 /skills listet auf, was geladen ist.
Fehlerbehebung bei npx skills: fünf echte Fehler und Lösungen, von einem falschen „alles aktuell" nach einem GitHub-Rate-Limit bis hin zu sudo, das einen zweiten Skill-Store anlegt, einem Home-Ordner, der als Projekt behandelt wird, und Skills, die Upstream gelöscht wurden
Fünf Fehler, fünf Lösungen. Die meisten davon laufen auf dieselben zwei Regeln hinaus: lies die ✗-Zeilen, und führe die CLI niemals als root oder aus deinem Home-Verzeichnis aus.

Teil 7 — MCP-Server ohne Fachchinesisch

Was passiert, wenn du einen Server verbindest

  1. Du fügst den Server in den Einstellungen deines Agenten hinzu: einen Befehl für einen lokalen Server, eine Webadresse für einen entfernten.
  2. 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.
  3. Der Server listet seine Tools auf, und der Agent reicht ihre Beschreibungen an das Modell weiter.
  4. 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": false fü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: false ist für Server, die einen Schlüssel oder gar keinen verwenden. Melde dich an mit opencode mcp auth <name>, und über SSH fügst du die Callback-URL von der fehlgeschlagenen Browserseite in die Eingabeaufforderung ein.
  • Innerhalb einer Sitzung, /mcps verbindet, 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.json erweitert ${VAR} und ${VAR:-default}, damit Schlüssel in deiner Umgebung bleiben und nicht in Git landen.
  • /mcp zeigt 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, und codex 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_tools und disabled_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"] }
  }
}
  • httpUrl steht für Streamable HTTP; url bedeutet den älteren SSE-Typ.
  • Lass trust aus. Auf wahrgesetzt, 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 env block 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-mcp nach dem Bearbeiten, und hermes mcp test context7 um genau zu sehen, was ein Server geantwortet hat.
  • Für OAuth-Dienste füge auth: oauth zu 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 env plus einer sicheren Basis, nicht deine gesamte Shell-Umgebung.
  • Tools erscheinen als mcp_<server>_<tool>; filtere sie mit tools.include oder tools.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.

Wie du einen MCP-Server in OpenCode, Claude Code, Codex, Gemini CLI, Cursor und Hermes Agent hinzufügst: derselbe Context7-Server im Befehls- oder Konfigurationsformat jedes Agenten, plus einen Befehl für einen lokalen Server
Ein Server, sechs Dialekte. Die Ideen sind identisch; nur die Dateinamen und die Klammern ändern sich.

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 (/plugins in der CLI), und ein Plugin kann auch MCP-Server-Verbindungen mitbringen.
  • Gemini CLI nennt sie Erweiterungen: gemini extensions install <git-url> und gemini extensions update <name>.
  • GitHub Copilot CLI (copilot plugin install) und Hermes Agent (hermes plugins install) haben Plugin-Befehle, und Cursor hat /add-plugin im 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

  1. 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.
  2. 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-housekeeping verwendet 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.

Anatomie eines Agenten-Skills: Front Matter von SKILL.md, das beim Start für etwa 100 Tokens gelesen wird, Anweisungen, die gelesen werden, wenn eine Aufgabe passt, und Referenzen, Skripte und Assets, die nur bei Bedarf gelesen werden
Drei Schichten: das Etikett, das Rezept und der Anhang. Nur die erste wird immer geladen, deshalb zählen gute Beschreibungen mehr als lange Anweisungen.

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

  1. Lies, bevor du installierst. Verwende npx skills add owner/repo --list, gh skill preview, oder öffne einfach die SKILL.md und ihre Skripte auf GitHub.
  2. 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.
  3. 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.
  4. Pinne alles, was wichtig ist. npx skills add owner/[email protected], oder gh skill install … --pin v1.2.3, damit Updates nur dann passieren, wenn du es willst.
  5. Prüfe Updates wie Code. npx skills check, lies dann die Änderungen auf GitHub, dann npx skills update.
  6. Skills von Drittanbietern hinter eine Freigabe legen. In OpenCode nutzen Regeln die skill Aktion, 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.

Checkliste für Sicherheit bei Agenten-Skills und MCP: Snyks ToxicSkills-Zahlen zu 3.984 öffentlichen Skills und zehn sichere Gewohnheiten, vom Lesen vor der Installation und dem Fixieren von Versionen bis zu Tokens mit minimalen Rechten
Ein Skill sind Anweisungen, die dein Agent mit deinen Berechtigungen ausführt. Installiere ihn mit der Sorgfalt, die du jeder anderen Software entgegenbringen würdest.

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 -g und 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 list oder hermes mcp test fü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:

  1. Auf beiden derselbe Ansatz: deinen normalen Benutzer, niemals sudo, und die CLI aus einem Projektordner oder /tmp.
  2. Projekt-Skills reisen mit Git. Commit .agents/skills und skills-lock.json; auf dem anderen Rechner, npx skills install stellt exakt dieselben Versionen wieder her.
  3. Globale Skills kommen aus einem Skript. Halte dein npx skills add … -g Befehle 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

Was sind Agent Skills?

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.

Was ist ein MCP-Server?

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.

Worin liegt der Unterschied zwischen Agent Skills und MCP-Servern?

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.

Funktionieren Skills in OpenCode, Claude Code und Codex gleich?

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.

Wie installiere ich einen Skill mit npx skills?

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.

Wohin installiert npx skills die Skills?

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.

Wie erkenne ich, ob meine Skills aktuell sind?

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.

Warum meldet npx skills, alle Skills seien aktuell, wenn die Prüfung fehlgeschlagen ist?

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.

Sollte ich sudo mit npx skills verwenden?

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.

Wie füge ich OpenCode einen MCP-Server hinzu?

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.

Wie viele MCP-Server sollte ich installieren?

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.

Sind Agent Skills sicher zu installieren?

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”.

Was ist skills-lock.json?

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.

Was ist skills.sh?

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:

  1. Lege gemeinsame Skills in .agents/skills und lass npx skills sie in die Agenten verlinken, die woanders nachsehen.
  2. Laufen npx skills@latest check aus einem Projektordner oder /tmp, lies die ✗-Zeilen, und aktualisiere bewusst.
  3. Melde dich bei GitHub an (gh auth login) auf jedem Rechner, der nach Updates sucht.
  4. Verwende niemals sudo mit Skills oder Agenten.
  5. 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.

Füge dein Signal hinzu.

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert

de_DEDeutsch