Kurz zusammengefasst
- Ein Skill ergänzt einen Agenten um wiederverwendbares Vorgehen und Fachkontext, ohne das zugrunde liegende Modell neu zu trainieren.
- Der Agent sieht zuerst nur Name und Beschreibung, lädt bei passender Aufgabe die SKILL.md und greift erst bei Bedarf auf weitere Dateien zu.
- Ein Skill ist weder ein Tool noch eine Berechtigung: Zugriffe und Aktionen müssen weiterhin technisch kontrolliert werden.
- Versionierung, Herkunft, Tests und die Prüfung enthaltener Skripte gehören zu einem sicheren betrieblichen Lebenszyklus.
Was gehört zu einem Agent Skill?
Das offene Agent-Skills-Format definiert einen Ordner als kleinste Einheit. Darin ist SKILL.md verpflichtend. Die Datei beginnt mit Metadaten wie Name und Beschreibung und enthält danach die Arbeitsanweisungen in Markdown. Die Beschreibung ist besonders wichtig, weil ein kompatibler Agent anhand dieser Information beurteilt, für welche Aufgaben der Skill relevant sein könnte.
Ein kleiner Skill kann vollständig in SKILL.md bestehen. Umfangreichere Skills lagern Details aus, damit nicht bei jeder Nutzung sämtliche Informationen im Modellkontext landen.
- SKILL.md: Metadaten, Einsatzbereich, Ablauf, Regeln und Beispiele
- scripts/: optionale, wiederverwendbare Programme für Berechnung, Prüfung oder Dateiverarbeitung
- references/: optionale Fachregeln, Schemata oder ausführliche Dokumentation
- assets/: optionale Vorlagen, Bilder, Beispieldateien oder andere statische Ressourcen
- Lizenz, Kompatibilitätsangaben und weitere Metadaten können die Nutzung zusätzlich einordnen
Wie werden Skills entdeckt, aktiviert und ausgeführt?
Skills nutzen progressive Offenlegung. Dadurch kann ein Agent viele Fähigkeiten kennen, ohne alle Anleitungen gleichzeitig in sein begrenztes Kontextfenster zu laden. Welche Aktivierung tatsächlich unterstützt wird, hängt vom jeweiligen Agent-Client ab.
- Schritt 1
Entdecken
Der Client stellt dem Agenten zunächst nur Name und Beschreibung der verfügbaren Skills bereit. Diese Metadaten sollten Aufgabe und Auslöser präzise benennen.
- Schritt 2
Aktivieren
Passt die aktuelle Aufgabe zur Beschreibung, lädt der Agent die vollständigen Anweisungen aus SKILL.md in den Kontext.
- Schritt 3
Ausführen
Der Agent folgt dem beschriebenen Ablauf und liest Referenzen, verwendet Assets oder startet Skripte nur dort, wo die Anleitung dies für den konkreten Fall verlangt.
- Schritt 4
Ergebnis prüfen
Anwendung und verantwortliche Personen prüfen Resultat, Tool-Aufrufe und erlaubte Wirkungen nach denselben Qualitäts- und Freigaberegeln wie bei anderen Agentenfunktionen.
Wie unterscheiden sich Skills von anderen KI-Bausteinen?
Die Begriffe beschreiben unterschiedliche Ebenen. Ein Skill kann Prompts, Tools oder Wissensquellen verwenden, ersetzt diese Bausteine aber nicht. Für eine belastbare Architektur muss sichtbar bleiben, wo Anleitung, Wissen, Schnittstelle, Prozesslogik und Berechtigung liegen.
| Baustein | Aufgabe | Abgrenzung zum Agent Skill |
|---|---|---|
| Prompt oder Systemanweisung | Gibt dem Modell im aktuellen Kontext Verhalten oder eine einzelne Aufgabe vor. | Ein Skill verpackt ein wiederverwendbares Vorgehen mit Metadaten und optionalen Ressourcen; seine SKILL.md enthält selbst Anweisungen. |
| Tool oder Function Calling | Stellt eine aufrufbare Funktion oder einen kontrollierten Zugang zu einem System bereit. | Ein Skill kann erklären, wann und wie ein Tool eingesetzt wird, stellt aber weder die Schnittstelle noch die Berechtigung bereit. |
| MCP | Standardisiert, wie ein Client Tools, Ressourcen und Vorlagen eines Servers entdeckt und nutzt. | Ein Skill verpackt prozedurales Wissen und lokale Ressourcen. Er kann MCP-Tools verwenden, ist aber kein Verbindungsprotokoll. |
| Workflow | Legt Schritte, Übergänge und Kontrollen überwiegend in Software fest. | Ein Skill wird vom Agenten situationsabhängig interpretiert. Für deterministische oder kritische Abläufe bleibt feste Prozesslogik oft geeigneter. |
| RAG oder ein Wissensformat wie OKF | Stellt aktuelles Wissen bereit oder strukturiert Wissensinhalte für Austausch und Nutzung. | Ein Skill beschreibt, wie eine Aufgabe ausgeführt wird. Fachwissen kann in Referenzen liegen, verbindliche und aktuelle Daten sollten jedoch aus verantworteten Quellen kommen. |
| Fine-Tuning | Verändert das Verhalten eines Modells durch zusätzliches Training. | Ein Skill bleibt ausserhalb des Modells, ist lesbar, austauschbar und unabhängig versionierbar. |
Wann ist ein Skill sinnvoll – und wann genügt eine Anleitung?
Ein Skill lohnt sich, wenn ein klar begrenzter Ablauf wiederholt von einem kompatiblen Agenten ausgeführt werden soll und dafür mehr als ein kurzer Hinweis nötig ist. Besonders nützlich sind Skills, wenn Fachregeln, Vorlagen oder geprüfte Skripte gemeinsam gepflegt und über mehrere Projekte oder Clients hinweg wiederverwendet werden sollen.
Für eine seltene, einfache Aufgabe ohne zusätzliche Ressourcen genügt häufig eine normale Anleitung oder Vorlage. Ein vollständig vorhersehbarer und folgenreicher Ablauf gehört eher in geprüfte Software beziehungsweise einen festen Workflow als in frei interpretierbare Anweisungen.
- Sinnvoll: wiederkehrende mehrstufige Fachaufgabe mit klarer Definition eines guten Ergebnisses
- Sinnvoll: gemeinsame Prüfregeln, Vorlagen oder robuste Hilfsskripte sollen wiederverwendbar sein
- Sinnvoll: das Vorgehen soll unabhängig vom einzelnen Chat dokumentiert und versioniert werden
- Anleitung genügt: kurze, seltene Aufgabe ohne Dateien, Ausführung oder besondere Randfälle
- Workflow ist besser: Reihenfolge und Ergebnis müssen deterministisch erzwungen werden oder Fehler hätten schwerwiegende Folgen
Wie werden Skills im Unternehmen gepflegt und geprüft?
Ein Skill ist ein wartbares Software- und Wissensartefakt. Er braucht einen fachlichen Eigentümer, eine nachvollziehbare Quelle und einen definierten Freigabeweg. Änderungen an Modellen, Tools, Richtlinien oder Dateiformaten können seine Wirkung verändern, auch wenn SKILL.md selbst unverändert bleibt.
- Schritt 1
Zweck und Eigentümer festlegen
Aufgabe, Zielgruppe, erlaubte Daten, erwartete Ergebnisse und verantwortliche Fachstelle dokumentieren.
- Schritt 2
Herkunft und Abhängigkeiten erfassen
Autor, Lizenz, Quellen, benötigte Tools, Laufzeitumgebung und externe Pakete nachvollziehbar halten.
- Schritt 3
Mit realen Fällen evaluieren
Aktivierung, Nicht-Aktivierung, Ergebnisqualität, Grenzfälle, Tool-Nutzung und sichere Abbrüche separat testen.
- Schritt 4
Versionieren und freigeben
Skill, Referenzen, Assets und Skripte gemeinsam versionieren; Änderungen prüfen und bei Bedarf an eine freigegebene Version binden.
- Schritt 5
Überwachen und ausmustern
Fehler, veraltete Regeln und Abhängigkeiten beobachten und nicht mehr unterstützte Versionen kontrolliert entfernen.
Welche Rechte und Sicherheitskontrollen braucht ein Skill?
Eine Anweisung in SKILL.md ist keine technische Sicherheitsgrenze. Wenn ein Skill ein Skript startet oder ein Tool verwendet, gelten dessen echte Dateisystem-, Netzwerk- und Systemrechte. Ungeprüfte Skills können deshalb ähnlich wie fremder Code, Makros oder Pakete ein Supply-Chain-Risiko darstellen.
Der Skill sollte nur die für seine Aufgabe benötigten Fähigkeiten nutzen. Kritische Aktionen bleiben in der ausführenden Anwendung begrenzt, validiert und gegebenenfalls menschlich freigegeben. Geheimnisse gehören weder in SKILL.md noch in mitgelieferte Referenzen, Assets oder Skripte.
- Skills und Aktualisierungen nur aus nachvollziehbarer Herkunft übernehmen
- Skripte, Abhängigkeiten und Installationsschritte vor Freigabe prüfen
- Datei-, Netzwerk- und Tool-Rechte nach dem Prinzip der geringsten Rechte begrenzen
- Eingaben, Ausgaben und heruntergeladene Inhalte als potenziell nicht vertrauenswürdig behandeln
- Tool-Aufrufe, Version, Resultat und Freigaben für relevante Prozesse protokollieren
- Negative Tests für falsche Aktivierung, manipulierte Referenzen und unerlaubte Aktionen durchführen
Beispiel: Skill für die Vorbereitung einer Ausschreibungsantwort
Ein Unternehmen erstellt einen Skill für wiederkehrende Ausschreibungen. SKILL.md beschreibt Eingangskriterien, Prüfschritte und das erwartete Dossier. references/ enthält die freigegebenen Fachregeln, assets/ eine Antwortvorlage und scripts/validate-response.py prüft Pflichtfelder sowie Querverweise. Bei einer passenden Anfrage aktiviert der Agent den Skill, liest nur die benötigten Referenzen und ruft freigegebene Produktdaten über ein kontrolliertes Tool oder einen MCP-Server ab. Er erstellt eine Lückenliste und einen Entwurf, versendet jedoch nichts und erfindet keine Zusagen. Fachverantwortliche prüfen Quellen, Ausnahmen und die finale Freigabe.
Was Sie mitnehmen sollten
Verwenden Sie Agent Skills für klar begrenztes, wiederkehrendes Vorgehen mit nachvollziehbaren Ressourcen. Behandeln Sie jeden Skill als versioniertes und prüfbares Artefakt – nicht als Abkürzung für Berechtigungen, aktuelle Wissensquellen oder feste Prozesskontrollen.
Quellen und Vertiefung
Diese Primärquellen vertiefen Definitionen, technische Grundlagen oder verantwortlichen Einsatz.
Inhaltlich geprüft