> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genow.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Skills
> Führe deinen Agent mit wiederverwendbaren, aufgabenspezifischen Skills durch wiederkehrende Expertenaufgaben.
> [!WARNING]
>
> **Skills befinden sich derzeit in der Closed Beta.** Das Feature wird noch ausgerollt und kann sich ändern. Wenn du Skills für deine Agents ausprobieren möchtest, wende dich bitte an deinen Genow-Kontakt.
Mit Skills kannst du festhalten, wie eine bestimmte, wiederkehrende Aufgabe gelöst werden soll, und dieses „Rezept" an deinen Agent übergeben. Statt sich bei jeder Frage auf eine generische Suche-und-Antwort zu verlassen, kann der Agent eine bekannte Aufgabe erkennen, den passenden Skill laden und seinem definierten Plan folgen - unter Nutzung der Dateien, die der Skill bereitstellt.
***
## Was ist ein Skill?
Ein Skill ist ein wiederverwendbares, aufgabenspezifisches Instruktionsset, das ein Agent Admin in der Administration erstellt und einem oder mehreren Agents zuweist. Jeder Skill bündelt:
* **Einen Namen** - eine klare Bezeichnung für die Aufgabe.
* **Eine Beschreibung** - erklärt, *wann* der Skill genutzt werden soll. Der Agent stützt sich darauf, um zu entscheiden, ob eine Anfrage zum Skill passt.
* **Einen Body** - den Plan bzw. die Schritt-für-Schritt-Anweisungen, wie die Aufgabe gelöst wird (das Feld **Instructions** im Formular).
* **References und Assets** (optional) - Dateien, die der Skill liest oder mit denen er arbeitet, zum Beispiel eine Preisliste oder eine E-Mail-Vorlage.
Skills folgen der offenen [Agent Skills-Spezifikation](https://agentskills.io/specification) (dem `skill.md`-Format). Du kannst die Felder direkt in der Administration ausfüllen oder eine bestehende `skill.md`-Datei hochladen, um sie vorauszufüllen.
> [!NOTE]
>
> Stell dir einen Skill als „Experten" für eine Aufgabe vor: Ein Skill könnte Lieferzeiten nachschlagen, ein anderer einen Wettbewerbsvergleich durchführen und ein dritter einer Postleitzahl die richtige Vertriebsregion zuordnen.
***
## Wie Agents Skills nutzen
Einfach gesagt: Jeder Skill hat einen kurzen **Namen** und eine **Beschreibung**, die angeben, für welche Aufgabe er gedacht ist. Wenn du den Agent etwas fragst, liest er diese Beschreibungen und prüft, ob deine Anfrage zu einem seiner Skills passt.
* Passt ein Skill, „öffnet" der Agent ihn, liest seine Schritt-für-Schritt-Anweisungen und angehängten Dateien und befolgt sie, um die Aufgabe zu erledigen.
* Passt nichts, antwortet der Agent einfach auf die normale Weise.
Du musst nie selbst einen Skill auswählen - der Agent entscheidet automatisch, welcher (falls überhaupt) zu deiner Anfrage passt. Das funktioniert wie eine Orchestrierungsebene: Zuerst wird identifiziert, welcher „Experte" (Skill) die Anfrage bearbeiten soll, dann wird dem Plan dieses Skills gefolgt, statt eine generische Antwort zu geben.
***
## Wie Skills in die Pipeline passen
Normalerweise antwortet Genow in zwei Schritten: Es durchsucht dein verbundenes Knowledge (semantische Suche) und generiert dann eine fundierte Antwort. Skills fügen darüber eine aufgabenspezifische Ebene hinzu:
1. Wenn deine Anfrage zu einem Skill passt, lädt der Agent den Plan des Skills und alle angehängten Dateien.
2. Anschließend folgt er diesem Plan - zum Beispiel, indem er einen Wert in der Excel-Datei des Skills nachschlägt und ihn in einem definierten Format zurückgibt - statt eine freie Antwort zu erzeugen.
Das macht wiederkehrende Expertenaufgaben deutlich **zuverlässiger und wiederholbarer**, weil der Agent einem festen Ablauf folgt und nur mit den Daten arbeitet, die der Skill bereitstellt.
> [!NOTE]
>
> In der aktuellen Beta folgen Skills ihrem geschriebenen Plan und arbeiten mit ihren angehängten Dateien. Das Ausführen eigener Skripte oder Code wird noch nicht unterstützt.
***
## Skills vs. Agent Instructions
Skills ergänzen [Agent Context und Instructions](https://docs.genow.ai/use-case-management/settings/add-context.md):
| | Gilt für | Zweck |
| :- | :- | :- |
| **Instructions und Kontextfelder** | *Jede* Frage auf dem Agent | Dauerhaft aktive, allgemeine Steuerung und Kontext |
| **Skills** | Nur wenn eine Anfrage passt | On-Demand-Rezepte für spezifische, wiederkehrende Aufgaben |
Nutze **Instructions** für Regeln, die immer gelten sollen; nutze **Skills** für in sich geschlossene Abläufe, die nur bei einer bestimmten Art von Aufgabe greifen sollen.
> [!NOTE]
>
> Hier meint „Instructions" das Agent-weite Feld **Instructions** in [Agent Context](https://docs.genow.ai/use-case-management/settings/add-context.md) - nicht das Feld **Instructions** innerhalb eines einzelnen Skills, das den Plan dieses einen Skills enthält.
***
## Einen Skill erstellen
Du erstellst und verwaltest Skills unter Administration → Skills → Erstellen.
Der einfachste Weg ist, **zuerst eine `SKILL.md`-Datei zu schreiben und sie hochzuladen** - Genow füllt dann alle folgenden Felder automatisch aus. Du prüfst nur das Ergebnis und weist den Skill vor allem einem Agent zu.
**1. Lade deine SKILL.md-Datei hoch (empfohlen)**
Im Bereich **Upload SKILL.md** wählst du deine Datei aus, ziehst sie hinein oder fügst sie ein (Dateityp: MD, max. 5 MB). Genow liest sie und füllt jedes folgende Feld vor. Du kannst den Upload auch überspringen und die Felder von Hand ausfüllen.
**2. Prüfe die Felder**
Überprüfe die vorausgefüllten Felder und passe sie bei Bedarf an (siehe Tabelle unten).
**3. Weise den Skill einem Agent zu**
Das ist der entscheidende Schritt. Wähle unter **Agents** den Agent (oder die Agents) aus, der den Skill nutzen soll - einen Agent, dessen User diese Aufgabe tatsächlich benötigen. Ein Skill wird nur auf den Agents wirksam, denen er zugewiesen ist; jeder mit Zugriff auf diesen Agent kann ihn dann nutzen.
### Die Felder
| Feld | Erforderlich | Wofür es dient |
| :- | :- | :- |
| **Name** | Ja | Eine klare Bezeichnung für die Aufgabe. |
| **Description** | Ja | Erklärt, *wann* der Skill genutzt werden soll. Der Agent liest dies, um zu entscheiden, ob eine Anfrage passt - beschreibe also die Aufgabe und die Situationen, die sie abdeckt. |
| **Agents** | Empfohlen | Der oder die Agents, denen der Skill zugewiesen ist. Ohne Zuweisung kann niemand den Skill nutzen. |
| **License** | Nein | Optionale Lizenzinformationen für den Skill. |
| **Compatibility** | Nein | Optionaler Hinweis, womit der Skill kompatibel ist. |
| **Metadata** | Nein | Optionale Zusatzeinträge (eine Zeile nach der anderen hinzufügen). |
| **Instructions** | Kern | Das Herzstück des Skills: der Schritt-für-Schritt-Plan, der dem Agent sagt, wie die Aufgabe auszuführen ist. |
| **References** | Nein | Dateien, die der Agent lesen kann, sobald er den Skill geladen hat. |
| **Assets** | Nein | Vorlagen und andere Dateien, mit denen der Skill arbeitet. |
> [!NOTE]
>
> **References vs. Assets.** References sind Dokumente, die der Agent zur Information *liest* - zum Beispiel ein Produktkatalog, eine Preisliste oder eine Richtlinie. Assets sind Dateien, mit denen der Skill *arbeitet* oder die er ausfüllt - zum Beispiel eine E-Mail-Vorlage, eine Angebots- oder Proposalvorlage oder ein Excel-Berechnungsblatt. Beide akzeptieren Datei-Uploads von jeweils bis zu 5 MB.
> [!NOTE]
>
> Agent Admins können die Skills verwalten, die sie erstellt haben oder die mit ihnen geteilt wurden; Global Admins können alle Skills verwalten. Genow stellt außerdem eine Reihe voreingestellter Skills bereit.
***
## Beispiel-Skills (Sales-Kontext)
Skills sind besonders im Sales nützlich, wo dieselben Expertenaufgaben immer wieder auftauchen:
* **Das richtige Produkt finden:** Der Kunde beschreibt seine Anforderungen, und der Skill ordnet ihnen das am besten passende Produkt aus deinem Katalog zu.
* **Nach Anforderung konfigurieren:** Der Skill stellt die richtige Konfiguration oder Optionen für die Bedürfnisse des Kunden zusammen, basierend auf deinen Produktregeln.
* **Eine Kunden-E-Mail entwerfen:** Der Skill verwandelt eine Antwort in eine versandfertige E-Mail in der Formulierung und dem Format deines Unternehmens.
* **Eine Lieferzeit nachschlagen:** Der Skill gibt die Lieferzeit für ein Produkt aus einer Lieferzeittabelle zurück.
* **Wettbewerbsvergleich:** Der Skill vergleicht dein Produkt mit dem eines Wettbewerbers anhand der relevanten Parameter.
### Ein durchgespieltes Beispiel: „Product Finder"
| Element | Beispiel |
| :- | :- |
| **Name** | Product Finder |
| **Description** | Nutzen, wenn ein Kunde seine Anforderungen beschreibt und eine Produktempfehlung aus unserem Katalog benötigt. |
| **Instructions** | 1. Identifiziere die wichtigsten Anforderungen; stelle eine Rückfrage, wenn etwas Wesentliches fehlt. 2. Gleiche die Anforderungen mit dem Katalog ab. 3. Gib die besten ein bis drei Optionen zurück, jeweils mit einer kurzen Begründung. 4. Folge der Struktur der Empfehlungsvorlage. |
| **References** | Der Produktkatalog und die aktuelle Preisliste - damit der Agent korrekte Produktdaten liest. |
| **Assets** | Eine Empfehlungsvorlage - damit jede Antwort derselben Struktur folgt. |
Das zeigt ein Muster, das du für andere Aufgaben wiederverwenden kannst: Die **Instructions** definieren das *Wie*, die **References** liefern die *Fakten* und die **Assets** definieren die *Form* der Ausgabe.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.