Skills — gib Deinem KI-Agenten neue Fähigkeiten
Was Skills sind, wo Du sie findest, wie Du sie sicher einsetzt und selbst baust — und wie Claude Code, Codex, opencode, OpenClaw, Hermes und Auxdata das Konzept jeweils umsetzen. Dein Fortschritt wird lokal gespeichert.
Worum geht's?
KI-Agenten wie Claude Code oder Codex können aus der Box schon viel — aber erst Skills machen sie zu Spezialisten: wiederverwendbare Fähigkeitspakete, die der Agent bei Bedarf lädt. Ein Skill bringt ihm bei, wie man in Deinem Team Rechnungen baut, Code reviewt oder Folien erstellt.
Diese Schulung führt Dich tool-neutral durchs Konzept: Was ist ein Skill? → Wo findet man welche? → Wie setzt man sie ein? → Wie baut man eigene? → Was muss man beachten (Sicherheit!) → und zum Schluss der Vergleich der großen Agenten-Ökosysteme.
Selbstlern-Kurs zum Durchklicken — Dein Fortschritt wird lokal gespeichert.
? Für wen sind Skills wichtig?
Für alle, die mit KI-Agenten mehr erreichen wollen als den Standard-Funktionsumfang.
🗺️ Die 9 Stufen
Was sind Skills?
Das mentale Modell: Fähigkeitspakete, die Dein Agent bei Bedarf lädt — und wie sich Skills von Prompts, Projekt-Regeln und MCP unterscheiden.
1 Das mentale Modell
Ein Skill ist ein wiederverwendbares Fähigkeitspaket für einen KI-Agenten: ein Ordner mit einer SKILL.md-Datei — Anleitung plus Beschreibung, wann sie gilt — und optional Skripten und Vorlagen.
2 Was steckt in einem Skill?
description sagt dem Agenten, wann der Skill gilt.scripts/ mit ausführbarem Code, den der Agent nutzen darf.references/ & assets/ — Details und Vorlagen, erst bei Bedarf gelesen.--- name: rechnung-pdf description: Use when der Nutzer eine Rechnung als PDF erstellen will — erzeugt aus Posten + Empfänger ein fertiges Firmen-PDF. --- # Rechnung als PDF erstellen 1. Frage Rechnungsposten, Empfänger und Datum ab. 2. Nutze die Vorlage in assets/rechnung-vorlage.html. 3. Rendere sie mit scripts/render-pdf.py zu PDF.
SKILL.md: YAML-Kopf (name + description sind Pflicht), darunter die Anleitung in Markdown.3 Progressive Disclosure — warum das skaliert
Würde der Agent alle Anleitungen immer komplett laden, wäre sein Kontextfenster sofort voll. Deshalb arbeitet der Skill-Mechanismus zweistufig:
- Immer geladen: nur Name + Beschreibung aller Skills — ein kompakter Katalog.
- Bei Bedarf geladen: die volle Anleitung des einen Skills, der zur Aufgabe passt (und erst dann dessen
references/).
4 Abgrenzung: Was ein Skill nicht ist
- Fähigkeit auf Abruf — geladen, wenn die Aufgabe passt
- Wiederverwendbar über Projekte und (dank Standard) über Tools hinweg
- Kann Skripte & Vorlagen mitbringen
- Einmalige Anweisung im Chat
- Weg, sobald die Session endet
- Gut zum Ausprobieren — schlecht zum Wiederverwenden
- Projekt-Regeln, die immer gelten
- „Wie arbeiten wir hier" — nicht „wie geht Aufgabe X"
- Wird komplett in den Kontext geladen
- MCP: verbindet den Agenten mit externen Tools/Daten (Datenbank, API)
- Subagent: delegierter Arbeiter mit eigenem Kontext
- Beides ergänzt Skills, ersetzt sie nicht
CLAUDE.md/AGENTS.md. Externe Systeme anbinden → MCP. Wiederholbares Können („so machen wir X") → Skill.✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
Wo findet man Skills?
Vier Quellen — von offiziellen Sammlungen über Marketplaces bis zur firmeneigenen Bibliothek. Und wo Dein Tool sie auf der Platte sucht.
1 Die vier Quellen
2 Hands-on: Wo sucht Dein Tool?
Jeder Agent scannt feste Orte auf Deiner Platte. Stell oben Deinen Coding-Agenten ein — die Beispiele passen sich an.
# Persönliche Skills (gelten überall für Dich): ~/.claude/skills/<skill-name>/SKILL.md # Projekt-Skills (gelten im Repo, für das ganze Team): .claude/skills/<skill-name>/SKILL.md # Marketplace einbinden und Plugin (= Skill-Paket) installieren: /plugin marketplace add anthropics/skills /plugin install <name>@<marketplace>
# Skills im Repo (jedes Verzeichnis vom Arbeitsordner bis zur Repo-Wurzel): .agents/skills/<skill-name>/SKILL.md # Installierte Skills auflisten (CLI/IDE): /skills
AGENTS.md die immer geltenden Projekt-Regeln (Kette: AGENTS.override.md → AGENTS.md → TEAM_GUIDE.md → .agents.md, näher am Arbeitsordner gewinnt). Skills = Workflows auf Abruf, AGENTS.md = Dauer-Regeln.# Eigene Orte: .opencode/skills/<skill-name>/SKILL.md ~/.config/opencode/skills/<skill-name>/SKILL.md # Liest zusätzlich die Layouts der anderen Tools mit: .claude/skills/ # Claude-Code-Projekt-Skills .agents/skills/ # Codex-Skills
.claude/skills und .agents/skills — ein gemeinsames Team-Repo funktioniert also für alle drei Agenten gleichzeitig.3 Qualität ist nicht garantiert
✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
Skills einsetzen
Zwei Wege, einen Skill zu starten — und ein kompletter Workflow, Schritt für Schritt durchgespielt.
1 Zwei Wege zum Skill
- Du stellst einfach Deine Aufgabe
- Der Agent vergleicht sie mit den
description-Texten seiner Skills - Passt eine — lädt er den Skill und folgt ihm
- Du nennst den Skill beim Namen
- z. B. als Slash-Command:
/rechnung-pdf - Zuverlässig — gut, wenn es genau dieser Skill sein soll
2 Ein Workflow, durchgespielt
Angenommen, der rechnung-pdf-Skill aus Stufe 1 ist installiert — so läuft die Aufgabe ab:
3 Skill feuert nicht? So hilfst Du nach
- Beim Namen nennen: ruf ihn explizit auf (Slash-Command bzw. Mention) — das übersteuert den Katalog-Abgleich.
- Schlüsselwörter verwenden: formuliere die Aufgabe mit Begriffen aus der
descriptiondes Skills. - Bei eigenen Skills: die description schärfen — wie das geht, zeigt Stufe 4.
4 Hands-on: Skills aufrufen in Deinem Tool
# Skill explizit als Slash-Command starten: /rechnung-pdf # Oder einfach die Aufgabe stellen — Claude matcht die description. # Installierte Plugins/Skills verwalten: /plugin
# Verfügbare Skills auflisten: /skills # Skill gezielt erwähnen ($-Mention im Prompt): $rechnung-pdf für die Muster GmbH # Oder Aufgabe frei stellen — Codex wählt den Skill, # wenn sie zur description passt.
# opencode entdeckt Skills automatisch (natives Skill-Tool) # und lädt sie, wenn die Aufgabe zur description passt. # Explizit: Skill im Prompt beim Namen nennen — # „Nutze den Skill rechnung-pdf für …"
/help bzw. die Doku Deines Tools zeigt den aktuellen Stand.✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
Eigene Skills bauen
SKILL.md schreiben, die description als Trigger schärfen — und Skills im Team teilen wie Code.
1 Die Anatomie einer SKILL.md
Ein vollständiger Skill ist erstaunlich wenig Datei — hier ein realistisches Beispiel:
--- name: changelog-pflegen description: Use when ein Release vorbereitet wird oder der Nutzer nach Changelog/Release-Notes fragt — pflegt CHANGELOG.md im Keep-a-Changelog-Format mit deutschen Einträgen. --- # Changelog pflegen ## Wann diesen Skill nutzen Vor jedem Release oder wenn Änderungen dokumentiert werden sollen. ## Schritte 1. Lies die Commits seit dem letzten Release-Tag. 2. Gruppiere nach: Hinzugefügt / Geändert / Behoben. 3. Schreibe Einträge nutzerverständlich (kein Commit-Jargon). 4. Halte das Format aus references/beispiel-eintrag.md ein. ## Regeln - Datum im Format JJJJ-MM-TT. - Keine internen Ticketnummern in den Texten.
name + description sind Pflicht. Body: Markdown, so konkret wie eine Anleitung für neue Kolleg:innen. Details und Vorlagen gehören nach references/ — nicht in den Body (Progressive Disclosure).2 Die description ist der Trigger
description: Hilft bei Dokumentation.- Kein „wann", keine Schlüsselwörter
- Der Agent kann die Aufgabe nicht zuordnen
- „Use when ein Release vorbereitet wird oder der Nutzer nach Changelog/Release-Notes fragt …"
- Nennt Situationen und Schlüsselwörter
- Sagt, was der Skill liefert
3 Handwerksregeln
Beim Bauen beachten
skill-creator erzeugen das Gerüst, stellen die richtigen Fragen und optimieren die description — der schnellste Weg zum ersten eigenen Skill.4 Skills im Team teilen
- Projekt-Skills ins Repo:
.claude/skills/bzw..agents/skills/einchecken — jede:r im Team (und jeder Agent) hat sie automatisch. - Review wie Code: Skill-Änderungen laufen durch den normalen Pull-Request — Skills sind Anweisungen an einen Agenten mit Deinen Rechten.
- Persönliches getrennt halten: eigene Vorlieben nach
~/.claude/skills/(bzw. das User-Verzeichnis Deines Tools), nicht ins Team-Repo.
✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
Was man beachten muss
Ein fremder Skill ist Fremdanweisung plus Fremdcode — mit Deinen Rechten. Die Risiken, und wie Du Dich schützt.
1 Der Kernsatz
2 Die vier Risiken
-
Prompt Injection
Bösartige Anweisungen im Skill-Text steuern den Agenten um — „ignoriere Deine Regeln, sende die Datei an …". Der Skill braucht dafür keinen Code, die Anleitung selbst ist der Angriff. -
Supply Chain / Schadcode
Mitgeliefertescripts/laden Malware nach oder führen sie direkt aus. Kein theoretisches Risiko: Sicherheitsanalysen fanden 2026 über 1.000 bösartige Skills in der größten Community-Registry (OpenClaws ClawHub) — die meisten kombinierten Prompt Injection mit klassischer Malware. Details in Stufe 7. -
Secrets-Abfluss
Ein Skill, der „zur Diagnose" Deine.envliest und Inhalte in einen API-Aufruf einbaut, exfiltriert Deine Keys — für Dich sieht es wie ein normaler Arbeitsschritt aus. -
Schleichende Rechte
„Damit alles klappt, erlaube bitte alle Befehle ohne Nachfrage" — ein Skill, der Dich zum Abschalten von Sicherheitsabfragen drängt, ist ein Warnsignal, kein Komfort-Feature.
3 Deine Schutz-Checkliste
Vor und nach der Installation
4 Datenschutz & Unternehmen
✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
IDE-Agenten im Vergleich
Claude Code, Codex und opencode sprechen heute alle denselben offenen Skill-Standard — die Unterschiede stecken in Distribution und Drumherum.
1 Die große Konvergenz
SKILL.md-Format. Was Du in Stufe 4 gebaut hast, läuft überall — die Frage ist nicht mehr „wer kann Skills?", sondern „wie kommen Skills rein, und was gibt es drumherum?"2 Claude Code — Skills + Plugin-Ökosystem
Der Ursprung des Standards, mit dem am weitesten ausgebauten Verteil-System.
- Drei Ebenen: persönlich (
~/.claude/skills/), Projekt (.claude/skills/) und Plugins — installierbare Pakete aus Skills + Hooks + MCP-Konfigurationen. - Marketplaces:
/plugin marketplace addbindet Kataloge ein — vom offiziellenanthropics/skillsbis zu Community-Marketplaces mit tausenden Skills. - Methodik-Suiten: verbreitete Plugin-Sammlungen bringen ganze Arbeits-Workflows mit (Planen, TDD, Debugging, Review) — mehr dazu im Bonus „Start-Set".
3 Codex — Skills + AGENTS.md-Kette
OpenAIs Agent trennt sauber zwischen Dauer-Regeln und Fähigkeiten auf Abruf.
- Skills nativ:
.agents/skills/wird vom Arbeitsordner bis zur Repo-Wurzel gescannt; Aufruf per/skills,$-Mention oder automatisch über die description. - AGENTS.md-Kette für Regeln:
AGENTS.override.md→AGENTS.md→TEAM_GUIDE.md→.agents.md, root-down zusammengesetzt — näher am Arbeitsordner gewinnt. - Memories ergänzen: Codex merkt sich Kontext aus früherer Arbeit — Skills bleiben für die wiederholbaren Abläufe zuständig.
4 opencode — der Brückenbauer
Quelloffen, providerunabhängig — und liest die Skill-Ordner der anderen gleich mit.
- Skills nativ + cross-kompatibel: eigenes
.opencode/skills/, liest aber auch.claude/skills/und.agents/skills/— ein Team-Repo bedient alle drei Agenten. - Plugins & Commands: JS/TS-Plugins erweitern die Funktionalität, Custom
/commandsergänzen feste Abläufe — Skills bleiben die portablen Fähigkeiten. - Freie Modellwahl: als providerunabhängiger Agent kombinierst Du Skills mit dem LLM Deiner Wahl — auch mit europäischen oder selbst gehosteten Modellen.
5 Mini-Matrix der drei
SKILL.md-Format (offener Standard)- Automatisches Triggern über die description
- Projekt-Skills im Repo teilbar
- Claude Code: Plugins + Marketplaces (größtes Verteil-Ökosystem)
- Codex: AGENTS.md-Regel-Kette + Memories
- opencode: liest alle Skill-Layouts, freie Modellwahl
✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
Self-Hosted-Agenten: OpenClaw & Hermes
Zwei entgegengesetzte Skill-Welten: der riesige Community-Pool — und der Agent, der seine Skills selbst schreibt.
1 OpenClaw — der Community-Pool
Der persönliche Multi-Channel-Agent lebt von seinem Ökosystem: die Community-Registry ClawHub zählt über 13.700 Skills — für fast alles existiert schon einer.
Deshalb gilt bei OpenClaw die Stufe-5-Checkliste in verschärfter Form — als fester Kurations-Workflow:
- Quelltext lesen: SKILL.md und alle Skripte — vor der Installation, nicht danach.
- Forken oder pinnen: eigene Kopie bzw. feste Version statt „latest" — Updates können aus gut böse machen.
- Minimale Rechte: dem Agenten nur die Kanäle und Befehle freischalten, die der Skill wirklich braucht.
- Isoliert testen: neuen Skill erst in einer Sandbox/Test-Instanz laufen lassen, dann auf den produktiven Agenten.
2 Hermes — der Agent, der Skills selbst schreibt
Der lernende Agent von Nous Research (Open Source, MIT) dreht das Modell um: statt Skills zu installieren, destilliert er nach jeder gelösten Aufgabe selbst einen — als Markdown-File in seine Skill-Bibliothek, das bei passenden Folge-Aufgaben automatisch geladen wird.
3 Gegenüberstellung
- 13.700+ fertige Skills — sofort nutzbar
- Risiko: ungeprüfte Fremd-Skills (Supply Chain)
- Kuration = Fremdes prüfen, bevor es reinkommt
- Skills entstehen aus Deinen eigenen Aufgaben
- Risiko: ungeprüft Gelerntes festigt sich
- Kuration = Eigenes reviewen, nachdem es entstand
✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
Plattform-Blick: Auxdata
Was passiert, wenn nicht Du kuratierst, sondern die Plattform? Der Governance-Ansatz — und für wen er passt.
1 Eine andere Philosophie
Das ist die institutionalisierte Form dessen, was Stufe 5 als „kuratierte interne Allowlist" empfohlen hat: Die Plattform übernimmt, was Du bei Coding-Agenten selbst tun musst.
2 Selbst-Kuration vs. Plattform-Governance
- Du prüfst Quelle, SKILL.md und Skripte selbst
- Du pinnst Versionen und mistest aus
- Maximale Freiheit — volle Eigenverantwortung
- Geprüfte Agenten/AI-Services, zentral verteilt über Rollen & Rechte
- KI-Firewall prüft Ein- und Ausgaben
- DSGVO-konformes Hosting — Governance ab Werk
3 Wann passt welcher Weg?
- Plattform-Ansatz passt, wenn … Dein Team nicht im Terminal lebt, Compliance-/Datenschutz-Anforderungen hoch sind oder eine zentrale Verwaltung gewünscht ist — Fähigkeiten kommen geprüft an, niemand installiert versehentlich Malware.
- Datei-Skills passen, wenn … Du maximale Flexibilität brauchst, eigene Skills im Repo versionieren willst oder Dein Workflow ohnehin in der IDE stattfindet.
- Beides kombinieren: viele Teams fahren zweigleisig — Plattform für die Breite der Belegschaft, Datei-Skills für das Entwicklungs-Team. Die Konzepte aus Stufen 1–5 gelten in beiden Welten.
✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
Matrix & Entscheidung
Alle sechs Tools nebeneinander — und die Frage, die wirklich zählt: welcher Weg passt zu Dir?
1 Die große Vergleichsmatrix
| Tool | Format | Quelle / Registry | Installation | Auto-Trigger | Kuration / Governance |
|---|---|---|---|---|---|
| Claude Code | SKILL.md (offener Standard) | anthropics/skills + Plugin-Marketplaces | /plugin install oder Skill-Ordner | ✓ über description | selbst — Repo-Review + Quellen prüfen |
| Codex | SKILL.md (offener Standard) | .agents/skills im Repo | Skill-Ordner ins Repo | ✓ description, dazu /skills + $ | selbst — Repo-Review |
| opencode | SKILL.md (offener Standard) | liest .opencode/, .claude/ & .agents/ | Skill-Ordner (beliebiges Layout) | ✓ über description | selbst — Repo-Review |
| OpenClaw | Community-Skills (Markdown + Tools) | ClawHub, 13.700+ Skills | aus der Registry | ✓ | selbst — Pflicht! (Vorfälle 2026: lesen, pinnen, isoliert testen) |
| Hermes | selbst destillierte Markdown-Skills | eigene, wachsende Bibliothek | entsteht beim Arbeiten | ✓ kontextuell geladen | Review des Gelernten + Checkpoints/Rollback |
| Auxdata | Plattform: Agenten, AI-Services, Workflows | zentrale Plattform | Admin verteilt über Rollen & Rechte | — (zugewiesen statt getriggert) | Plattform — geprüfte Bausteine, KI-Firewall, DSGVO |
SKILL.md (Stufe 4), bei OpenClaw im Community-Format, bei Hermes baut der Agent selbst, bei Auxdata über den Plattform-Editor.2 Welcher Weg passt zu Dir?
- Du arbeitest in der IDE und willst sofort loslegen? → Claude Code, Codex oder opencode — dank des offenen Standards ist die Skill-Frage kein Entscheidungskriterium mehr; wähle nach Modell, Ökosystem und Lizenz.
- Du willst einen persönlichen Agenten mit riesigem Skill-Pool — und bist bereit zu kuratieren? → OpenClaw (mit dem Kurations-Workflow aus Stufe 7!). Soll der Agent stattdessen aus Deinen Aufgaben selbst lernen → Hermes.
- Dein Team braucht zentrale Verwaltung, Datenschutz und Governance? → Auxdata — geprüfte Fähigkeiten statt freiem Marketplace, KI-Firewall und DSGVO-Hosting ab Werk.
3 Das Wichtigste zum Mitnehmen
✓ Geschafft, wenn Du …
Versionsstand: Skill-Ökosysteme ändern sich schnell · Stand Juni 2026
Empfohlenes Start-Set
Bewährte Skill-Kategorien für den Einstieg — Namen variieren je Tool und Quelle, das Prinzip zählt. (Zählt nicht für den Fortschritt.)
🧭 Methodik-Suite
Der größte Hebel zuerst: Skills, die dem Agenten Arbeitsweisen beibringen statt Einzelaufgaben.
🛠️ Bauen & Prüfen
📄 Über Code hinaus
skill-creator + ein Office-Skill installieren (Quelle prüfen — Stufe 5!), eine Woche damit arbeiten, dann gezielt ergänzen. Lieber fünf Skills, die Du kennst, als fünfzig, die Du nie gelesen hast.Quiz
7 Fragen quer durch die Skills-Stufen. Ab 6 richtigen Antworten schaltest du dein Zertifikat frei.
Dein Zertifikat
Glückwunsch! Trage deinen Namen ein und drucke das Zertifikat (oder speichere als PDF).