Agent Skills – Das herstellerübergreifende Format für LLM-Agent-Task-Anweisungen
Stand 20.10.2026: Agent Skills ist der offene Standard, den Anthropic im Dezember 2025 veröffentlicht hat; SKILL.md verlangt nur name und description, der Inhalt lädt sich in drei Stufen, und Claude Code, claude.ai, die Claude API sowie OpenAI Codex / ChatGPT lesen dieselbe Datei.
Was Skills sind: wie sie sich von Plugins und MCP unterscheiden
Ein Skill ist ein Verzeichnis mit SKILL.md (name und description im YAML-Frontmatter, Anweisungen in Markdown) sowie optionalen Verzeichnissen scripts/, references/ und assets/. Anthropic bezeichnet Skills als wiederverwendbare, dateisystembasierte Ressourcen: Das Modell gleicht die Anfrage mit der description ab, liest danach nur den benötigten Text und die Skripte, und nur deren Ausgabe landet im Kontext. Anders als Plugins (Client-Funktionspakete) und MCP (externes Tool-Protokoll) sind Skills keine Tools oder Client-Funktionen; sie sind Anweisungspakete für „Wie geht man vor“. Ein Plugin kann mehrere Skills enthalten, und ein Skill kann MCP-Tools referenzieren.
SKILL.md-Spezifikation: Pflichtfelder und Minimalbeispiel
SKILL.md nutzt YAML-Frontmatter für name und description, der Body enthält Anweisungen in Markdown. Beispiel: In der Spezifikation sind nur name und description Pflicht; license, compatibility, metadata und allowed-tools sind optional, allowed-tools ist zudem als experimentell gekennzeichnet. Das offizielle Minimalbeispiel setzt name auf pdf-processing und beschreibt das Extrahieren von Text und Tabellen aus PDF-Dateien, das Ausfüllen von Formularen und das Zusammenführen von Dokumenten, verwendet bei PDF-, Formular- und Extraktionsanfragen. name darf höchstens 64 Zeichen lang sein, nur Kleinbuchstaben, Ziffern und Bindestriche, ohne führenden oder abschließenden Bindestrich; description darf nicht leer sein und höchstens 1024 Zeichen umfassen. Das Verzeichnis lautet skill-name/SKILL.md plus optionale scripts/, references/ und assets/. Im Text stehen die Schritte für das Modell, zum Beispiel: 1. Aus der Nutzernachricht die zu verarbeitenden Dateien ermitteln; 2. ./scripts/extract.py aufrufen und das Ergebnis ausgeben. Das Modell lädt diesen Skill automatisch, wenn es eine PDF-Anfrage sieht.
Offizielles Skills-Repository und Partner-Beispiele
Das offizielle Repository anthropics/skills stellt eine Reihe von Referenzimplementierungen bereit, und die README sortiert sie in kreatives Design, technische Entwicklung, Unternehmenskommunikation und Dokument-Skills; docx, pdf, pptx und xlsx sind die quelloffenen Fassungen hinter Claudes Dokumentfunktionen, der Rest ist meist unter Apache 2.0 quelloffen. Plattformseitig gibt es fertige Dokument-Skills: PowerPoint (pptx), Excel (xlsx), Word (docx) und PDF (pdf), sofort nutzbar in claude.ai und über die API. Das Repository enthält außerdem eine Skill-Vorlage und eine Kopie der Spezifikation, und in Claude Code lässt sich das Repository als Plugin-Marktplatz registrieren und daraus installieren; im Abschnitt Partner Skills der README ist derzeit der Claude-Skill von Notion hervorgehoben. Der Community-Aggregator SkillsMP (skillsmp.com) bezeichnet sich selbst als unabhängiges Community-Projekt, das öffentliche GitHub-Quellen sammelt, um die Suche nach Skills zu erleichtern.
Herstellerübergreifende Kompatibilität und Enterprise-Verteilung
Nachdem Anthropic Skills im Dezember 2025 als offenen Standard veröffentlicht hat, schreiben die offiziellen OpenAI-Dokumente, dass Codex und ChatGPT dieselbe SKILL.md lesen: Codex lädt lokale Skills aus $CWD/.agents/skills, $HOME/.agents/skills und /etc/codex/skills, sie lassen sich explizit mit /skills oder $ aufrufen und greifen auch automatisch, wenn die description passt. Dieselbe SKILL.md läuft in Claude Code, Codex CLI und ChatGPT – einmal schreiben, herstellerübergreifend einsetzen, allerdings wird zwischen den Produkten nichts automatisch synchronisiert: Skills, die in claude.ai hochgeladen wurden, müssen separat in die API hochgeladen werden, Skills aus der API sind in claude.ai nicht verfügbar, und Claude-Code-Skills liegen als lokale Dateien vor. Für Organisationen gilt: Benutzerdefinierte Skills in claude.ai gehören einzelnen Personen, und Anthropic schreibt ausdrücklich, dass claude.ai keine zentrale Administration und keine Verteilung an die ganze Organisation unterstützt; Claude Enterprise kann die Skill-Inhaltsprüfung einschalten für Skills, die in claude.ai und Claude Cowork hochgeladen werden, während über die Skills API hochgeladene Skills nicht geprüft werden, und eine API-Anfrage unterstützt höchstens 20 Skills.
FAQ
Sind Skills dasselbe wie Custom Subagents?
Nein. Ein Custom Subagent ist eine Claude-Code-Dispatch-Einheit mit eigenem Prompt, eigenen Tools und Dispatch-Regeln. Ein Skill ist ein höherstufiges Anweisungspaket, das vom Haupt-Agent oder einem beliebigen Subagent geladen werden kann. Ein Subagent kann mehrere Skills referenzieren: der offizielle Weg ist das skills-Feld, das den vollständigen Skill-Inhalt beim Start in den Kontext des Subagenten lädt, und umgekehrt funktioniert es – ein Skill mit context: fork läuft in einem geforkten Subagenten.
Kann ich einen Skill nutzen, um durchzusetzen, dass das Modell ein bestimmtes Verhalten vermeidet?
Nicht als harte Einschränkung – Skills sind „Empfehlungen und Anweisungen“, von denen das Modell unter Druck dennoch abweichen kann. Anthropic definiert einen Skill als Anweisungen und Skripte, ob das Modell ihnen folgt, ist damit eine Bewertungsfrage (die offizielle Checkliste deckt Befolgung der Anweisungen und Genauigkeit der Auslösung ab). Für echte Einschränkungen nutzen Sie die Mechanismen von Claude Code: disallowed-tools entfernt Tools aus dem verfügbaren Pool, solange der Skill aktiv ist, allowed-tools genehmigt Tools vorab, und disable-model-invocation: true verhindert, dass Claude den Skill selbst aufruft. Nutzen Sie Skills für „Wie es richtig geht“; setzen Sie harte Regeln woanders durch.
Können Codex und ChatGPT dieselbe SKILL.md nutzen?
Ja. Skills sind Markdown-Text-Repositories – per git clone lokal nutzbar: Claude Code liest sie aus ~/.claude/skills/ oder .claude/skills/, Codex aus .agents/skills-Verzeichnissen. In Kombination mit dem Gateway von QCode zu Claude/Codex/GPT funktioniert dieselbe SKILL.md bei verschiedenen Herstellern. In den offiziellen OpenAI-Dokumenten steht, dass Skills auf dem offenen Agent-Skills-Standard aufbauen, die Datei SKILL.md name und description enthalten muss und Codex wie ChatGPT zuerst name und description laden und die vollständige SKILL.md erst lesen, wenn sie den Skill tatsächlich verwenden.
Weiterführende Anleitungen
Agent Skills anbieterübergreifend mit QCode nutzen
QCode bündelt den Zugriff auf Claude / GPT / chinesische Modelle – alle kompatibel mit dem Agent-Skills-Standard. Einmal schreiben, überall ausführen.
Starten Sie Ihren QCode-TarifQCode-Konto erstellen
Ein API-Key für Claude, GPT und chinesische Modelle, Bezahlung pro Token — aktuelle Preise unter /models.