# AI-Agent-Skills: Was sie sind und wie Sie einen funktionierenden Skill schreiben

> AI-Agent-Skills machen aus Anweisungen, die Sie ständig wiederholen, Dateien, die Ihr Agent bei Bedarf lädt. Erfahren Sie, wie SKILL.md funktioniert und wie Sie einen Skill erstellen.

Last updated: 2026-09-28T10:00:00

Canonical URL: https://crevio.co/de/blog/ai-agent-skills

*Zuletzt aktualisiert: September 2026*

**Wenn Sie einem AI-Agenten Ihre Rückerstattungsrichtlinien mehr als zweimal erklärt haben, haben Sie bereits einen Agent-Skill geschrieben. Sie löschen ihn nur jedes Mal wieder.** AI-Agent-Skills schaffen Abhilfe: eine kurze Datei mit einem Ablauf, die der Agent nur liest, wenn eine Aufgabe dies erfordert. Schreiben Sie die Regeln einmal auf – und jedes künftige Gespräch startet damit.

Dieser Leitfaden richtet sich an Geschäftsinhaber und Verantwortliche, die einen AI-Agenten für echte Arbeit einsetzen und es leid sind, ihm alles immer wieder zu erklären. Sie erfahren, was ein Skill tatsächlich ist, wie Agents entscheiden, wann sie ihn laden, welche Aufgaben einen Skill verdienen – und erhalten ein vollständiges Beispiel zum Kopieren.

- **Ein Skill ist ein Ordner mit einer SKILL.md-Datei**: einem Namen, einer kurzen Beschreibung und den Anweisungen. Skripte und Referenzdateien sind optional
- **Agents lesen zunächst nur die Beschreibung** (etwa 100 Tokens pro Skill). Der Rest wird geladen, wenn eine Aufgabe passt – so bleibt auch eine große Bibliothek günstig
- **Es handelt sich um einen offenen Standard.** Derselbe Skill funktioniert in Claude, ChatGPT und Codex, Gemini CLI, Cursor, GitHub Copilot und Dutzenden weiteren Agents
- **Die Beschreibung ist der wichtigste Teil.** Eine vage Beschreibung sorgt dafür, dass der Skill nie oder bei der falschen Aufgabe ausgelöst wird
- **Skills von Drittanbietern sind Code, den Sie installieren.** Eine Prüfung im Februar 2026 fand bei 13,4 % der öffentlichen Skills kritische Sicherheitsprobleme

## Was sind AI-Agent-Skills?

**AI-Agent-Skills sind wiederverwendbare Anweisungspakete, die einem Agenten beibringen, eine bestimmte Aufgabe auf Ihre Art zu erledigen.** Jeder Skill ist ein Ordner mit einer `SKILL.md`-Datei. Diese Datei beginnt mit einem kurzen Header (einem `name` und einem `description`), gefolgt von verständlichen Anweisungen: den Schritten, Regeln, dem Ausgabeformat und Sonderfällen.

Die Idee stammt von Anthropic. Das Unternehmen [führte Agent Skills im Oktober 2025 ein](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills) und beschrieb sie als „organisierte Ordner mit Anweisungen, Skripten und Ressourcen, die Agents entdecken und dynamisch laden können“. Im Dezember 2025 veröffentlichte Anthropic das Format als offenen Standard auf [agentskills.io](https://agentskills.io/home). Seitdem haben die meisten großen Agents den Standard übernommen.

![Anthropics Engineering-Beitrag zur Einführung von Agent Skills, veröffentlicht am 16. Oktober 2025](https://crevio.co/vite/assets/anthropic-agent-skills-announcement-fr3rjecj.png)

Der Begriff wird auch allgemeiner für „Dinge, die AI-Agents erledigen können“ oder für die menschlichen Fähigkeiten verwendet, die Sie zum Verwalten von Agents benötigen. Das sind durchaus relevante Themen. Wenn Menschen, die Agents entwickeln oder kaufen, 2026 jedoch von „Skills“ sprechen, meinen sie fast immer dies: einen gebündelten Ablauf, den der Agent je nach Bedarf verwenden und wieder beiseitelegen kann.

### Was steckt in einem Skill-Ordner?

Die [Agent-Skills-Spezifikation](https://agentskills.io/specification) hält die Struktur bewusst klein:

| Bestandteil | Erforderlich? | Inhalt |
|---|---|---|
| `SKILL.md` | Ja | Header mit `name` und `description`, gefolgt von den Anweisungen |
| `scripts/` | Nein | Code, den der Agent ausführen kann, etwa einen Report-Generator oder einen Validator |
| `references/` | Nein | Längere Dokumente: Ihre vollständige Richtlinie, eine Preisliste oder ein Styleguide |
| `assets/` | Nein | Vorlagen, Beispieldateien und Nachschlagetabellen |

Für den Header gelten feste Grenzen. Der `name` darf bis zu 64 Zeichen lang sein und nur Kleinbuchstaben, Zahlen und Bindestriche enthalten. Der `description` darf bis zu 1.024 Zeichen umfassen und sollte laut Spezifikation „beschreiben, was der Skill tut und wann er verwendet werden soll“.

![Die Agent-Skills-Spezifikationsseite mit der erforderlichen SKILL.md-Datei sowie den optionalen Ordnern für Skripte, Referenzen und Assets](https://crevio.co/vite/assets/agentskills-specification-idwfflfk.png)

## Wie Agents Skills laden

Das clevere Element des Formats: Ein Agent liest nicht alle Skills gleichzeitig. Er lädt sie in drei Stufen, die in der Spezifikation **progressive disclosure** genannt werden.

![Diagramm der drei Ladestufen eines Agents: Name und Beschreibung immer, SKILL.md-Anweisungen bei passender Aufgabe und Referenzen oder Skripte nur, wenn ein Schritt sie benötigt](https://crevio.co/vite/assets/how-agents-load-skills-g1wbt1jh.svg)

1. **Erkennung.** Zu Beginn jeder Sitzung liest der Agent nur den Namen und die Beschreibung jedes installierten Skills – ungefähr 100 Tokens pro Skill
2. **Aktivierung.** Passt Ihre Anfrage zu einer Beschreibung, liest der Agent die vollständige `SKILL.md` dieses Skills. Die Spezifikation empfiehlt, sie auf weniger als 5.000 Tokens und 500 Zeilen zu begrenzen
3. **Ausführung.** Der Agent folgt den Anweisungen und öffnet eine Referenzdatei oder führt ein Skript nur aus, wenn ein Schritt darauf verweist

Deshalb kann ein Unternehmen Dutzende Skills installiert haben, ohne den Agenten zu verlangsamen oder für ungenutzten Kontext zu bezahlen. Darum ist die Beschreibung so wichtig: Bevor der Agent eine Entscheidung trifft, sieht er nur sie. Anthropics [Leitfaden zum Erstellen von Skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) sagt, dass der Agent anhand dieses einen Feldes aus „100+ verfügbaren Skills“ auswählen kann.

## Skills im Vergleich zu Prompts, Tools und Memory

Skills überschneiden sich mit mehreren Dingen, die Sie vielleicht bereits verwenden. Der Unterschied liegt darin, was jeweils enthalten ist und wann es angezeigt wird.

| | Enthält | Wann der Agent es sieht | Geeignet für |
|---|---|---|---|
| **Prompt** | Eine einzelne Anfrage | Nur in diesem Gespräch | Einmalige Aufgaben |
| **Benutzerdefinierte Anweisungen** | Dauerhafte Präferenzen | In jedem Gespräch, immer | Tonalität, Name, Zeitzone |
| **Memory** | Vom Agenten erfasste Fakten | Wenn er sich daran erinnert | „Unser umsatzstärkster Monat ist November“ |
| **Tool oder Integration** | Zugriff auf ein System | Wenn der Agent handeln muss | Bestellungen lesen, E-Mails senden |
| **Skill** | Einen Ablauf | Nur wenn die Aufgabe passt | „So bearbeiten wir Rückerstattungen“ |

Am häufigsten werden Skills und Tools verwechselt. **Ein Tool gibt dem Agenten einen Schlüssel; ein Skill sagt ihm, was er damit tun soll, sobald er im System ist.** Ein Skill mit der Anweisung „Prüfe die Bestellung in unserem Shop“ ist nutzlos, wenn der Agent keinen Zugriff auf Ihren Shop hat. Umgekehrt ist der Zugriff riskant, wenn ein Skill nicht festlegt, was der Agent dort darf und was nicht. In der Regel brauchen Sie beides.

Skills und Memory unterscheiden außerdem einen Agenten, der jedes Mal bei null anfängt, von einem, der sich durch die Nutzung verbessert. Genau diese Grenze haben wir in [AI Employee vs. AI Agent](/de/blog/ai-employee-vs-ai-agent) gezogen.

## Wo AI-Agent-Skills heute funktionieren

Da es sich um einen offenen Standard handelt, ist ein von Ihnen erstellter Skill nicht an ein einziges Produkt gebunden. Die [Client-Liste von agentskills.io](https://agentskills.io/home) umfasst Claude und [Claude Code](/de/blog/claude-code), ChatGPT und Codex, Gemini CLI, Cursor, GitHub Copilot, VS Code, OpenCode, Goose, Databricks, Snowflake und mehr als 30 weitere.

Auch öffentliche Verzeichnisse folgten. [skills.sh](https://skills.sh/) listet Community-Skills, die Sie mit einem einzigen Befehl installieren können – von Skills für Schreiben und Recherche bis hin zu Skills für bestimmte Tools.

![skills.sh, ein öffentliches Verzeichnis für Community-Agent-Skills mit Installations-Rangliste](https://crevio.co/vite/assets/skills-sh-directory-f00n0in6.png)

Ein großer Teil dieser Bibliothek wurde von Entwicklern für Coding-Agents erstellt. Die Skills, die für den Betrieb eines Unternehmens entscheidend sind, landen nur selten in einer Rangliste, weil sie Dinge enthalten, die nur Sie wissen: Ihre Richtlinien, Ihre Sprache und Ihre Zahlen.

## Beispiele für AI-Agent-Skills in kleinen Unternehmen

So kann eine grundlegende Skill-Bibliothek für ein Unternehmen aussehen, das digitale Produkte oder Dienstleistungen verkauft:

| Skill | Enthält | Wird ausgelöst, wenn |
|---|---|---|
| `handling-refund-requests` | Rückerstattungsrichtlinie, Genehmigungsregeln, Antwortton | ein Kunde sein Geld zurückverlangt |
| `writing-weekly-report` | Welche Zahlen relevant sind, welcher Zeitraum zählt, was als „bemerkenswert“ gilt | Sie fragen, wie die Woche gelaufen ist |
| `writing-in-brand-voice` | Ihre bevorzugten und unerwünschten Formulierungen, Beispiel-E-Mails | ein Text für Kunden erstellt werden soll |
| `launching-a-product` | Ihre Launch-Checkliste, E-Mail-Sequenz und Preisregeln | Sie sagen: „Lassen Sie uns X launchen“ |
| `qualifying-leads` | Für wen Ihr Angebot geeignet ist, was zu fragen ist und wann ein Gespräch gebucht wird | ein neuer Lead eingeht |
| `pricing-a-custom-quote` | Preisliste, Mindestpreise und zulässige Rabatte | ein Interessent fragt: „Was kostet das?“ |

Beachten Sie, was fehlt: „Schreibe einen Blogbeitrag“ oder „Fasse dieses PDF zusammen“. Das beherrscht das Modell bereits gut. Ein Skill verdient seinen Platz, wenn er Kontext enthält, den der Agent nicht erraten kann.

## Welche Aufgaben einen Skill verdienen – und welche nicht

Bevor Sie etwas schreiben, prüfen Sie die Aufgabe anhand von zwei Fragen: Wie oft wiederholt sie sich, und macht der Agent ohne Ihren Kontext Fehler?

![Zwei-mal-zwei-Matrix: Schreiben Sie nur für Aufgaben einen Skill, die sich häufig wiederholen und bei denen der Agent ohne Ihren Kontext Fehler macht](https://crevio.co/vite/assets/what-deserves-a-skill-bje0433g.svg)

PostHog, dessen Teams 226 Skills in einem internen Skill-Store veröffentlicht haben, kommt in [seinem Beitrag zum Erstellen von Skills](https://posthog.com/newsletter/writing-agent-skills) zum gleichen Schluss: Erstellen Sie Skills für wiederkehrende Aufgaben, mit denen Agents standardmäßig Schwierigkeiten haben oder die nicht offensichtlichen Kontext erfordern. Alles andere ist zusätzlicher Ballast und erschwert dem Agenten die Auswahl.

## So schreiben Sie einen AI-Agent-Skill

Sie müssen nicht programmieren können. Ein nützlicher Skill ist ein gut geschriebenes Ablaufdokument mit einem präzisen Header.

### Schritt 1: Erledigen Sie die Aufgabe zuerst gemeinsam mit dem Agenten

Anthropics eigener Rat: Beginnen Sie mit einem echten Gespräch, nicht mit einer leeren Datei. Gehen Sie die Aufgabe einmal durch, korrigieren Sie den Agenten dabei und achten Sie darauf, was Sie ihm erklären mussten. Aus diesen Korrekturen entsteht der Skill.

### Schritt 2: Schreiben Sie zuerst die Beschreibung

Die Beschreibung entscheidet, ob der Skill jemals geladen wird. Schreiben Sie in der dritten Person, erklären Sie, was der Skill tut, und nennen Sie Formulierungen, die eine Anfrage tatsächlich enthalten könnte:

- **Schwach:** „Hilft bei Kunden.“
- **Stark:** „Bearbeitet Rückerstattungsanfragen für digitale Produkte. Verwenden, wenn ein Kunde eine Rückerstattung verlangt, sagt, dass ein Kauf nicht funktioniert hat, oder eine Rückbuchung erwähnt.“

### Schritt 3: Schreiben Sie den Inhalt als Ziele und Regeln, nicht als Skript

Formulieren Sie das Ziel, verbindliche Regeln, die Schritte, das Ausgabeformat und Sonderfälle. Beschreiben Sie Einschränkungen präzise, lassen Sie bei der Wortwahl aber Spielraum. Die Warnung von PostHog ist ein Zitat wert: „Überpräzise Vorgaben machen aus einem Skill einen Workflow und nehmen ihm die Intelligenz, für die Sie bezahlen.“

### Schritt 4: Verschieben Sie umfangreiches Material in Referenzen

Wenn Ihre vollständige Richtlinie drei Seiten umfasst, legen Sie sie in `references/refund-policy.md` ab und erklären Sie dem Agenten genau, wann er sie öffnen soll. Halten Sie Referenzen einstufig: Dateien, die auf weitere Dateien verweisen, werden häufig nur zur Hälfte gelesen.

### Schritt 5: Testen Sie den Skill mit drei echten Anfragen

Führen Sie drei realistische Anfragen aus – darunter eine, die den Skill *nicht* auslösen sollte. Wird er bei der falschen Aufgabe aktiviert oder eine offensichtliche Anfrage übersehen, liegt das Problem fast immer an der Beschreibung.

### Ein vollständiges Beispiel zum Kopieren

```
---
name: handling-refund-requests
description: Handles refund requests for digital products (courses, templates, downloads). Use when a customer asks for a refund, says a purchase did not work, disputes a charge, or mentions a chargeback.
---

# Handling refund requests

## Goal
Resolve the request in one reply and keep the customer where possible.
Never refund outside policy without the owner's approval.

## Policy
- Courses: full refund within 14 days if under 30% of lessons completed
- Templates and downloads: no refund after download; offer a fix or an exchange
- Duplicate purchases: always refund the duplicate

## Steps
1. Look up the order: product type, purchase date, usage
2. Compare against the policy above
3. Within policy: draft the refund and the reply, then ask for approval
4. Outside policy: draft a reply offering the fix or exchange. Do not promise a refund
5. Chargeback, lawyer, or angry repeat contact: stop and hand it to the owner

## Reply style
Short and warm. Use their first name. Apologize once, not three times.
Sign off as "The Studio Team".

## Edge cases
- Bought the wrong course: offer a free swap before a refund
- Payment failed but they were charged: treat as a duplicate
```

Das sind weniger als 250 Wörter – und es ersetzt ein Gespräch, das Sie sonst jede Woche führen müssten.

## Was Ihnen niemand über Agent-Skills sagt

Das Format ist einfach. Die Überraschungen kommen, wenn Sie einige Monate mit einer Skill-Bibliothek arbeiten.

**Mit wachsender Bibliothek geraten Skills aneinander.** Der Beitrag von PostHog verweist auf eine Erkenntnis von Databricks: „Je mehr Skills hinzukommen, desto häufiger wählen Agents den falschen Skill.“ Zwei Skills mit ähnlichen Beschreibungen („Kunden-E-Mails“ und „Support-Antworten“) wechseln dann unvorhersehbar. Fassen Sie sie zusammen oder formulieren Sie in jeder Beschreibung ausdrücklich, für welche Situationen der jeweils andere Skill nicht zuständig ist.

**Skills veralten unbemerkt.** Ihr Rückerstattungszeitraum ändert sich, Ihre Preise ändern sich, ein Tool wird umbenannt – und der Skill wendet weiterhin selbstbewusst die alten Regeln an. Legen Sie alles, was sich ändern kann, in einer Referenzdatei ab, die Sie tatsächlich pflegen – so wie in einer [Knowledge Base für AI-Agents](/de/blog/ai-agent-knowledge-base) – und prüfen Sie Ihre Skills immer dann, wenn sich die zugrunde liegende Richtlinie ändert.

**Skills von Drittanbietern sind Software, kein Text.** Snyk untersuchte im Februar 2026 3.984 öffentliche Skills und [fand Sicherheitslücken in 36,82 % sowie kritische Probleme in 13,4 %](https://snyk.io/blog/toxicskills-malicious-ai-agent-skills-clawhub/), darunter 76 bestätigte Schadcode-Payloads zum Diebstahl von Zugangsdaten, zur Installation von Backdoors oder zum Abfluss von Daten. Anthropics Empfehlung ist eindeutig: Installieren Sie Skills nur aus Quellen, denen Sie vertrauen, und lesen Sie alle anderen zunächst durch. Wir haben dasselbe Risiko in unserem Beitrag zu [OpenClaw-Alternativen](/de/blog/openclaw-alternatives) behandelt – Community-Skills waren dort eine der größten Sorgen.

**Ein Skill verleiht keine Berechtigungen.** Anweisungen wie „Führe die Rückerstattung aus“ bewirken nichts ohne Zugriff auf Ihr Zahlungssystem. Noch gefährlicher ist jedoch Zugriff ohne Einschränkungen. Halten Sie Geldbewegungen, den Versand von Nachrichten und Löschvorgänge unabhängig von den Skill-Anweisungen hinter einem Genehmigungsschritt. Das ist dieselbe Regel, die wir für das [Übertragen von Aufgaben an AI-Agents in kleinen Unternehmen](/de/blog/ai-agents-for-small-business) empfehlen: Alles, was das Unternehmen verlässt, sollte als Entwurf erstellt, nicht gesendet werden.

## So verwendet Crevio Skills

[Crevio](https://crevio.co/) ist ein AI-Business-Builder: Sie beschreiben, was Sie verkaufen möchten, und sein Agent erstellt den Shop, wickelt Zahlungen ab, schreibt Marketingtexte und arbeitet gemeinsam mit Ihnen weiter am Unternehmen. Skills sorgen dafür, dass dieser Agent sein Wissen über mehrere Gespräche hinweg behält.

![Crevio-Startseite: AI, die Ihren Shop erstellt, Zahlungen verarbeitet, Ihr Marketing schreibt und Ihren Umsatz steigert](https://crevio.co/vite/assets/crevio-homepage-nvib9pqi.png)

In der Praxis sieht das so aus:

- **Skills sind bereits integriert.** Der Agent wird mit Skills für Kaltakquise per E-Mail, Lead-Magneten, Pricing, [SEO-Audits](/de/blog/ai-agents-for-seo), Anzeigenkreation, Social Posts sowie die Arbeit mit PDFs, Tabellen, Dokumenten und Präsentationen ausgeliefert
- **Sie können eigene Skills installieren und hochladen.** Die Skills-Seite in den Einstellungen enthält einen Marktplatz für Community-Skills. Außerdem können Sie eigene Skills als `.zip`, Ordner oder einzelne `SKILL.md`-Datei hochladen. Hochgeladene Skills bleiben auf Ihr Konto beschränkt
- **Der Agent erstellt Skills aus Erfahrungen.** Nach einer langen, komplexen Aufgabe wertet Crevio den Ablauf aus und speichert den dauerhaften Teil als Skill. Diese Skills erscheinen unter „Von Ihrer AI gelernt“ und können dort gelesen oder entfernt werden
- **Sie können durch Vormachen lehren.** Mit „Eine Aufgabe beibringen“ zeichnen Sie auf, wie Sie etwas auf dem Computer des Agenten erledigen. Crevio verwandelt die Aufzeichnung anschließend in einen wiederverwendbaren Skill

Der ehrliche Vorbehalt: Ein Skill, den der Agent selbst erstellt hat, ist nur so gut wie das Gespräch, aus dem er gelernt hat. Lesen Sie durch, was gespeichert wurde – insbesondere bei allem, was Geld oder Kunden betrifft. Crevio bietet einen kostenlosen Tarif, sodass Sie die Skill-Bibliothek ohne Zahlungskarte ausprobieren können.

## Häufig gestellte Fragen

### Sind Agent-Skills dasselbe wie MCP?

Nein. MCP (Model Context Protocol) ist eine von mehreren Möglichkeiten, [einen Agenten mit Ihren Business-Apps zu verbinden](/de/blog/connect-ai-agents-to-business-apps), etwa mit Ihrem CRM oder Posteingang. Ein Skill ist ein schriftlicher Ablauf, der dem Agenten erklärt, wie er vorhandene Möglichkeiten nutzt. Beides ergänzt sich: MCP stellt den Zugriff bereit, der Skill liefert die Einschätzung, wann und wie dieser Zugriff verwendet wird.

### Muss ich programmieren können, um einen AI-Agent-Skill zu schreiben?

Nein. Die meisten nützlichen Business-Skills bestehen aus einfachem Markdown: einem Header, einem Ziel, Regeln und Schritten. Skripte sind optional und lohnen sich nur für Abläufe, die jedes Mal exakt gleich ausgeführt werden müssen – etwa das Erstellen eines formatierten Reports oder das Prüfen einer Berechnung.

### Sind Claude-Skills dasselbe wie Agent-Skills?

In der Praxis: ja. Anthropic hat das Format für Claude entwickelt und anschließend als offenen Agent-Skills-Standard veröffentlicht. Ein für Claude geschriebener Skill funktioniert in der Regel mit jedem Agenten, der den Standard unterstützt – sofern er nicht von einem Tool abhängt, das nur in einem einzigen Produkt verfügbar ist.

### Wie viele Skills sollte ein Agent haben?

So viele, wie Sie unterschiedliche, wiederkehrende Abläufe haben – und nicht mehr. Das Laden kostet wenig, aber überschneidende Beschreibungen führen dazu, dass der Agent den falschen Skill auswählt. Wenn zwei Skills plausiblerweise dieselbe Anfrage beantworten könnten, fassen Sie sie zusammen.

## Kurz zusammengefasst

AI-Agent-Skills machen den Unterschied zwischen einem Agenten aus, den Sie verwalten, und einem Agenten, den Sie trainiert haben. Beginnen Sie mit dem einen Ablauf, den Sie ständig neu erklären müssen, schreiben Sie die Beschreibung so, als hinge alles davon ab, und halten Sie den Rest kurz. Die beste Skill-Bibliothek ist nicht die größte, sondern die, in der jede Datei etwas enthält, dessen Erklärung Sie leid waren.

## Verwandte Blogbeiträge

- [AI Employee vs. AI Agent: Der Unterschied, auf den es wirklich ankommt](/de/blog/ai-employee-vs-ai-agent)
- [AI-Agents für kleine Unternehmen: Welche Aufgaben Sie zuerst abgeben sollten](/de/blog/ai-agents-for-small-business)
- [Die besten AI-Agents für Slack im Jahr 2026 (11 Tools im Vergleich)](/de/blog/best-ai-agents-for-slack)