Claude Skills: Was sie sind und wie man sie in großem Maßstab verwaltet

Was sind Claude Skills?

Claude Skills, manchmal auch Agent-Skills genannt, sind wiederverwendbare Funktionspakete, die einem Agenten beibringen, wie er eine spezialisierte Aufgabe ausführt – etwa das Abfragen einer Datenbank, das Priorisieren von Warnmeldungen, das Befolgen eines Eskalations-Playbooks oder das Entwerfen von Release-Notes. Ein Skill wird einmal erstellt und überall wiederverwendet, sodass dieselbe Prozedur einen Produktions-Agenten, eine lokale Claude Code-Sitzung oder Cursor antreibt, ohne für jeden einzelnen Fall neu geschrieben werden zu müssen.

Der Grundgedanke ist, dass ein Skill kein Prompt ist, den man einfach hineinkopiert. Es ist ein kleines, in sich geschlossenes Paket, das der Agent bei Bedarf liest, wenn die Aufgabe es erfordert.

Wie ein Skill strukturiert ist

Jeder Skill ist ein Verzeichnis, das auf einer SKILL.md-Datei basiert. Diese Datei besteht aus zwei Teilen:

• YAML-Frontmatter mit einem Namen und einer Beschreibung. Dies ist der einzige Text, den der Agent vorab über den Skill sieht. Daher sollte die Beschreibung handlungsorientiert sein („Verwenden, wenn der Benutzer nach Verkaufs-, Nutzungs- oder Kostenzahlen fragt“), damit das Modell den richtigen Skill im richtigen Moment auswählt.
• Ein Markdown-Hauptteil mit der eigentlichen Prozedur, der der Agent folgt, sobald er den Skill ausgewählt hat.

Ein Skill kann neben der SKILL.md-Datei auch unterstützende Dateien bündeln, wie etwa Referenzdokumente und Skripte, die das Modell bei Bedarf liest, sobald der Skill im Kontext aktiv ist. Ein typischer Skill mit mehreren Assets sieht so aus:

---

name: analytics-helper

description: Anleitung zum Abfragen des Analytics-Data-Warehouse. Verwenden, wenn der Benutzer nach Verkaufs-, Nutzungs- oder Kostenzahlen fragt.

---

‍

# Analytics Helper Skill

‍

## Tabellen abfragen

1. Verwenden Sie das Skript `query.py` im Verzeichnis `scripts/` dieser Skill.

2. Schlagen Sie Schemata in `references/sales-tables.md` nach.

3. Begrenzen Sie die Ergebnisse auf 1000 Zeilen, es sei denn, der Benutzer fragt nach einem vollständigen Export.

‍

## Häufige Aggregationen

Gruppieren Sie für den Umsatz nach `month_start` und summieren Sie `gross_revenue`.

‍

Wenn ein Benutzer fragt: „Wie hoch war unser Umsatz im Oktober?“, liest der Agent die Skill, befolgt die Schritte und verwendet die gebündelten Skripte und Referenzen, um die Antwort zu geben, anstatt das Schema zu erraten.

Claude Skills funktionieren am besten, wenn

• Eine Aufgabe repetitiv ist und ein bekanntes, korrektes Verfahren existiert.
• Die Schritte zu lang oder zu spezifisch sind, um in einem System-Prompt zu stehen.
• Derselbe Workflow über mehrere Agenten oder Tools hinweg ausgeführt werden muss.
• Sie möchten, dass das Verfahren an einer Stelle verbessert wird und sich überall verbreitet.

Warum die Verwaltung von Claude Skills schwierig wird

Das Schreiben Ihrer ersten Skill dauert nur wenige Minuten. Die unternehmensweite Verwaltung einer ganzen Bibliothek führt jedoch oft zu Reibungsverlusten, die sich meist in denselben Problemen äußern.

‍

Skill-Dateien sind über verschiedene Repositories verstreut, sodass niemand weiß, welche Skills existieren oder welche die kanonische Version ist. Es gibt keine von der Codebasis unabhängige Versionsfixierung, sodass eine Änderung an einer Skill das Verhalten eines Agenten in der Produktion unbemerkt verändern kann. Es gibt keine Zugriffskontrolle pro Skill, sodass jedes Team jedes Verfahren lesen oder ändern kann. Zudem wird dieselbe Skill in drei Repos kopiert und driftet mit der Zeit auseinander.

‍

Dies sind Governance-Probleme, keine Probleme bei der Erstellung, und genau dafür ist eine zentrale Registrierung gedacht.

Wie die Skills-Registrierung von TrueFoundry Claude Skills steuert

In TrueFoundrywerden Skills in der Skills Registry verwaltet – einem zentralen, versionierten und RBAC-gesteuerten Katalog. Dies steht im bewussten Gegensatz zum Standardvorgehen, bei dem Skill-Dateien in Agenten-Repositories abgelegt oder ad hoc hochgeladen werden, ohne gemeinsames Verzeichnis, ohne Versionsfixierung und ohne zugriffsbeschränkte Steuerung pro Skill.

‍

Produktscreenshot, TrueFoundry-Dokumentation: die Skills Registry.

‍

Die Registry bietet die Kontrollmechanismen, die eine wachsende Skill-Bibliothek benötigt:

‍

• Auffindbarkeit. Ein Katalog für alle Teams, damit bestehende Skills gesucht, durchstöbert und wiederverwendet werden können, anstatt sie neu zu schreiben.
• Versionierung. Jeder Skill ist versioniert, und Sie können für die Produktionsstabilität eine spezifische Version pro Agent festlegen.
• Zugriffskontrolle. Skills übernehmen die RBAC-Einstellungen ihres übergeordneten Repositorys, sodass Sie steuern können, wer die einzelnen Skills lesen, verwenden oder veröffentlichen darf.
• Rollback. Kehren Sie bei Problemen mit einer neuen Version sofort zu einer bewährten Version zurück.
• Audit-Protokoll. Jede Versionsänderung und Nutzung wird protokolliert.
• Agentenübergreifende Wiederverwendung. Dieselbe Fähigkeit wird für mehrere Agenten genutzt, ohne Duplikate oder Abweichungen.

‍

Produktscreenshot, TrueFoundry-Dokumentation: Veröffentlichung einer Skill-Version.

‍

Da sich die Registry direkt neben dem AI Gateway und dem MCP Gateway befindet, ist ein Skill keine isolierte Datei. Plattform-Teams steuern, welche Skills für welche Agenten und Teams verfügbar sind, und Agenten-Entwickler wählen aus einem genehmigten Katalog aus, anstatt Dateien manuell zu verwalten. Der Skill, den ein Entwickler in Claude Code verwendet, ist dasselbe kontrollierte Artefakt, das auch ein Produktions-Agent nutzt – so bleibt das Verhalten bei der Skalierung konsistent.

‍