Anleitung

skills.sh: Skills für mehrere KI-Coding-Agenten installieren

Mit der skills.sh-CLI Agent-Skills für Codex, Claude Code und andere Coding-Agenten installieren und pflegen, ohne Anweisungen zu duplizieren.

Wenn du mehr als einen Coding-Agenten nutzt, wird es schnell unübersichtlich, dieselben Anweisungen in getrennte Verzeichnisse für Claude Code, Codex, Cursor und OpenCode zu kopieren. Jede Kopie kann auseinanderlaufen, und bald ist schwer zu sagen, welcher Version ein Agent gerade folgt.

skills.sh bietet ein Verzeichnis, in dem du Agent-Skills entdecken kannst. Die quelloffene skills-CLI übernimmt den praktischen Teil: Skills aus einem Repository auswählen, sie für einen oder mehrere Agenten installieren und sie später aktualisieren oder entfernen.

Kurze Antwort

Lass dir zuerst die Skills in einem Repository auflisten, ohne etwas zu installieren:

npx skills add vercel-labs/agent-skills --list

Installiere dann einen Skill für die Agenten, die ihn nutzen sollen:

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent claude-code \
  --agent codex

Um genau diesen Skill für jedes Agent-Ziel verfügbar zu machen, das die CLI unterstützt, verwende einen Platzhalter in Anführungszeichen, damit die Shell ihn nicht expandiert:

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent '*'

Es gibt auch einen deutlich weiter gefassten Befehl:

npx skills add vercel-labs/agent-skills --all

--all bedeutet: alle gefundenen Skills und alle Agenten, ohne Bestätigungsabfragen. Das ist bequem für ein Repository, das dir gehört und das du geprüft hast. Um eine unbekannte öffentliche Sammlung auszuprobieren, ist es meist zu weit gefasst.

Was installiert wird

Ein Agent-Skill ist ein Verzeichnis, das mindestens eine Datei SKILL.md enthält. Diese Datei hat einen Namen, eine Beschreibung, anhand derer ein Agent entscheidet, wann er den Skill aktiviert, und die Anweisungen, denen er folgen soll. Ein Skill kann außerdem ausführbare Skripte, Referenzmaterial und Assets enthalten. Die vollständige Struktur ist in der Agent-Skills-Spezifikation dokumentiert.

Die skills-CLI kennt die Projekt- und globalen Verzeichnisse von Dutzenden Coding-Agenten. Für eine Codex-Installation auf Projektebene zielt sie beispielsweise auf .agents/skills/, für Claude Code auf .claude/skills/. Sie kann aus diesen Agent-Verzeichnissen Symlinks auf eine einzige kanonische Kopie des Skills anlegen. So bleiben die Anweisungen einheitlich, und ein einziges Update gilt für mehrere Agenten.

Verwende --copy, wenn Symlinks für das Dateisystem oder die Deployment-Umgebung ungeeignet sind. Kopien sind voneinander unabhängig, du bist dann also selbst dafür verantwortlich, alle Agenten auf derselben Version zu halten.

Projekt- oder globalen Geltungsbereich bewusst wählen

Standardmäßig wird lokal im Projekt installiert. Führe den Befehl im Stammverzeichnis des Projekts aus, wenn ein Skill Repository-Konventionen, Framework-Versionen oder einen Workflow festhält, den das Team einsehen können soll.

Füge --global (oder -g) nur für einen persönlichen Workflow hinzu, der projektübergreifend gelten soll:

npx skills add vercel-labs/agent-skills \
  --skill web-design-guidelines \
  --agent codex \
  --global

Projektlokale Skills lassen sich leichter zusammen mit dem Code prüfen, den sie betreffen. Globale Skills vermeiden Wiederholung, können aber auch dazu führen, dass zwei Entwickler im selben Repository unterschiedliches Agentenverhalten erleben. Dokumentiere jeden globalen Skill, von dem ein gemeinsamer Workflow abhängt.

Das Verzeichnis zum Entdecken nutzen, nicht als Qualitätsnachweis

Die Rangliste von skills.sh basiert auf anonymer Installationstelemetrie aus der CLI. Eine Installationszahl kann Interesse zeigen, belegt aber nicht, dass ein Skill die Ergebnisse einer Aufgabe verbessert, aktuell ist oder zu deinem Projekt passt.

Bevor du einen öffentlichen Skill installierst:

  1. Öffne sein Quell-Repository und lies SKILL.md vollständig.
  2. Sieh dir die referenzierten Dateien und jedes Skript an, das der Skill ausführen könnte.
  3. Prüfe Lizenz, aktuelle Pflege, Abhängigkeiten, Netzwerkzugriffe und Kompatibilitätshinweise.
  4. Achte auf Anweisungen, die deinen Projektversionen oder bestehenden AGENTS.md-Regeln widersprechen.
  5. Probiere ihn in einem Projekt an einer wiederholbaren Aufgabe aus, bevor du ihn global machst oder für jeden Agenten installierst.

skills.sh gibt an, routinemäßig Sicherheitsprüfungen durchzuführen, räumt aber auch ein, nicht jeden gelisteten Skill garantieren zu können. Genau von dieser Grenze solltest du ausgehen. Ein Skill besteht aus Anweisungen und manchmal Code aus einem fremden Repository – er ist weder eine Sandbox noch eine Vertrauensentscheidung.

Die anonyme Telemetrie der CLI lässt sich für einen Befehl mit der dokumentierten Umgebungsvariable abschalten:

DISABLE_TELEMETRY=1 npx skills add vercel-labs/agent-skills --list

Mehr Skills machen einen Agenten nicht unbedingt besser

Ein installierter Skill erhöht nicht die grundlegende Leistungsfähigkeit des Basismodells. Er gibt dem Modell zusätzliche Anweisungen und Ressourcen. Nützliche Anweisungen können einen spezialisierten Workflow zuverlässiger machen; irrelevante oder veraltete können Kontext verbrauchen, einen guten Ansatz einengen oder dem Repository widersprechen.

Die ersten Belege sind gemischt. Ein aktueller Benchmark für Software-Engineering-Skills ergab über 49 öffentliche Skills hinweg nur eine durchschnittliche Verbesserung von 1,2 %. Neununddreißig zeigten keine Verbesserung der Erfolgsquote, drei verschlechterten sie. Eine breiter angelegte SkillsBench-Studie fand über mehrere Domänen hinweg einen deutlichen durchschnittlichen Zugewinn, aber auch negative Ergebnisse bei einigen Aufgaben und eine bessere Leistung fokussierter Skills im Vergleich zu umfassender Dokumentation.

Beides sind aktuelle Preprints und kein abschließendes Urteil. Die praktische Lehre ist trotzdem nützlich: Vergleiche einen Skill mit derselben Aufgabe ohne ihn. Behalte ihn, wenn das Ergebnis korrekter, wiederholbarer oder besser wartbar ist – nicht bloß, weil der Agent eine längere Antwort geliefert hat.

Den kleinsten Mechanismus wählen, der das Problem löst

Bedarf Besserer Ausgangspunkt
Wiederholbarer, toolspezifischer Ablauf mit Begleitdateien Ein fokussierter Projekt-Skill
Persönlicher Workflow, der in vielen Repositorys genutzt wird Ein geprüfter globaler Skill
Regeln, die jede Person und jeder Agent im Projekt immer befolgen muss Versionierte Projektanweisungen wie AGENTS.md
Eine einzelne ungewöhnliche Aufgabe Ein direkter Prompt mit dem nötigen Kontext
Eine deterministische Richtlinie oder Prüfung Ein Skript, Test, Formatter oder eine CI-Regel
Alte, generische oder widersprüchliche Vorgaben Kein Skill, bis die Vorgaben korrigiert sind

Diese Unterscheidung verhindert, dass eine Skill-Bibliothek zu einem zweiten, weniger sichtbaren Konfigurationssystem wird. Am nützlichsten sind Skills für prozedurales Wissen, das ein Agent nur laden soll, wenn eine passende Aufgabe auftaucht. Dauerhafte, repositoryweite Befehle und Grenzen gehören in eine fokussierte Anweisungsdatei; Belege und eine kompakte Vorlage findest du unter was in AGENTS.md und CLAUDE.md gehört.

Installierte Skills wartbar halten

Die CLI bietet die üblichen Befehle für den Lebenszyklus:

# Show project and global skills
npx skills list

# Update one installed skill
npx skills update web-design-guidelines

# Remove it
npx skills remove web-design-guidelines

Prüfe Änderungen im Upstream, bevor du einen Skill aktualisierst, der in Produktion oder teamweit genutzt wird. Wenn Reproduzierbarkeit wichtig ist, halte Quelle und geprüfte Revision in der Projektdokumentation fest, so wie du es auch bei anderen Entwicklungswerkzeugen tun würdest.

Die vernünftige Voreinstellung ist eng gefasst: Installiere einen geprüften Skill in einem Projekt für die Agenten, die ihn brauchen. Erweitere erst auf --agent '*', den globalen Geltungsbereich oder --all, wenn sich der Workflow diese Reichweite verdient hat.

Häufige Fragen

Kann skills.sh einen Skill gleichzeitig für Codex und Claude Code installieren?

Ja. Übergib der skills-CLI beide Agent-Namen, zum Beispiel --agent codex --agent claude-code. Die CLI installiert eine kanonische Kopie und kann sie in das Skills-Verzeichnis verlinken, das der jeweilige Agent erwartet.

Wie installiere ich einen Skill für alle unterstützten Agenten?

Verwende --agent '*' zusammen mit einem bestimmten --skill. Die weiter gefasste Option --all installiert ohne Rückfragen jeden gefundenen Skill für jeden Agenten, also prüfe die Quelle, bevor du sie nutzt.

Ist es sicher, Skills von skills.sh zu installieren?

Nicht automatisch. skills.sh führt Sicherheitsprüfungen durch, garantiert aber ausdrücklich nicht die Qualität oder Sicherheit jedes Skills. Lies vor der Installation SKILL.md, Skripte, Referenzen, Abhängigkeiten und die angeforderten Zugriffe.

Diese Anleitung teilen