--- title: "Einen eigenen Skill schreiben" url: "https://docs.noreja.com/de/article/einen-eigenen-skill-schreiben" language: "de" last_updated: "2026-10-23T08:25:51.326Z" --- # Einen eigenen Skill schreiben Wie du Minerva mit einem Skill beibringst, wie dein Unternehmen eine Aufgabe erledigt: wann ein Skill besser ist als ein Prompt, wie du ihn erstellst, zuweist und testest und was einen guten Skill ausmacht, mit einem vollständigen Beispiel. Ein Skill bringt Minerva bei, wie dein Unternehmen eine bestimmte Art von Aufgabe erledigt haben möchte: was ein Management-Briefing enthalten muss, wie dein Einkaufsteam eine verspätete Lieferung definiert oder welche Zahlen in einen Monatsbericht gehören. Diese Anleitung erklärt, wann ein Skill das richtige Werkzeug ist, wie du einen erstellst und testest und was einen guten Skill ausmacht. > **Berechtigungen:** Feature **Prompt**: **Erstellen**, um Skills zu erstellen, **Teilen**, um sie zu teilen. Um einen Skill zu deinen eigenen Agenten hinzuzufügen, zusätzlich **Agent**: **Bearbeiten**. Siehe [Rollen erstellen und bearbeiten](https://docs.noreja.com/de/article/rollen-erstellen-und-bearbeiten). ### Skill, System-Prompt oder User-Prompt? Im AI-Hub findest du unter **Skills & Prompts** drei Typen (siehe [AI-Hub: Agenten, Skills, Prompts und Arbeitsbereiche](https://docs.noreja.com/de/article/ai-hub-agenten-skills-prompts-und-arbeitsbereiche)). Nur zwei davon lohnt es sich, selbst zu erstellen: | Typ | Was es ist | Wann du es nutzt | | --- | --- | --- | | **Skill** | Fachwissen für eine Art von Aufgabe. Ein Agent lädt es nur, wenn eine Frage es braucht. | In den meisten Fällen: ein Berichtsformat, die Definitionen deines Unternehmens, eine bestimmte Art, etwas zu analysieren. | | **System** | Die grundlegenden Anweisungen eines Agenten: wofür er da ist und wie er sich verhält. Sie gelten für jede Frage, die dieser Agent beantwortet. | Nur, wenn du einen eigenen Agenten mit klar begrenztem Zweck baust. Minervas eigener System-Prompt lässt sich nicht ändern. | | **User** | Vorlagen, die Noreja intern verwendet, zum Beispiel um Chats einen Titel zu geben. | Erstelle keine: Ein User-Prompt, den du selbst erstellst, wird nie verwendet. | Wenn du unsicher bist, schreib einen Skill. Er macht Minervas andere Antworten weder länger noch langsamer, denn bis eine Frage ihn braucht, werden nur sein Name und seine Kurzbeschreibung gelesen. ### Wie Minerva einen Skill nutzt ![Diagramm: Zu Beginn jeder Antwort kennt der Agent seinen System-Prompt und eine Liste mit Name und Kurzbeschreibung jedes erlaubten Skills. Passt eine Kurzbeschreibung zur Frage, lädt er die vollständigen Anweisungen, angezeigt als Skill geladen; sonst antwortet er ohne. Ein /skill-key am Anfang einer Nachricht lädt den Skill direkt.](https://cdn-assets.productfruits.com/433fbc9e-4917-4127-9f78-8354666b975a) - Zu Beginn jeder Antwort sieht der Agent eine Liste der Skills, die er nutzen darf, jeweils mit Name und **Kurzbeschreibung für das Modell**. - Passt eine Kurzbeschreibung zur Frage, lädt der Agent die vollständigen **Skill-Anweisungen** und folgt ihnen. Im Chat siehst du eine Zeile **Skill geladen** mit dem Namen des Skills. - Benutzer können einen Skill auch selbst starten: Wer im Chat **/** eingibt, sieht die Skills, und eine Nachricht, die mit */compliance-briefing* beginnt, lädt diesen Skill sofort. Die Kurzbeschreibung entscheidet also, *ob* ein Skill genutzt wird, und die Anweisungen entscheiden, *wie* die Aufgabe erledigt wird. ### 1\. Den Skill erstellen - Öffne den **AI-Hub** und den Tab **Skills & Prompts**. - Klicke auf **Neuer Skill/Prompt**. - Wähle unter **Prompt-Typ** den Typ **SKILL**. Tu das zuerst: Die Felder hängen vom Typ ab. - Gib den **Skill-Name** ein, zum Beispiel *Compliance briefing*. Daraus wird der **Prompt-Schlüssel** erzeugt (*compliance-briefing*); Benutzer geben ihn im Chat nach **/** ein. - Schreib die **Kurzbeschreibung für das Modell**: wann der Skill genutzt werden soll, in den Worten, die deine Benutzer eintippen (bis zu 500 Zeichen). - Schreib die **Skill-Anweisungen**. Siehe die Tipps und das vollständige Beispiel unten. - Lege unter **Freigabe** fest, wer den Skill sehen und bearbeiten darf (siehe „Private und geteilte Skills“ unten). - Klicke auf **Speichern**. ![Der Bereich Neuer Skill/Prompt, ausgefüllt für den Skill Compliance briefing: Skill-Name, Prompt-Typ SKILL, der erzeugte Schlüssel compliance-briefing, die Kurzbeschreibung, die Anweisungen und der Freigabeschalter auf Privat](https://cdn-assets.productfruits.com/54488fcf-660b-404c-8a90-73fa83493f63) > **Wichtig:** Name und Schlüssel lassen sich nach dem Speichern nicht mehr ändern. Vermeide Umlaute und Sonderzeichen im Namen: Sie werden im Schlüssel zu Bindestrichen (*Verzögerung* wird zu *verz-gerung*). ### 2\. Den Skill einem Agenten zur Verfügung stellen - **Minerva**: darf alle Skills nutzen, auch neue. Dein Skill steht Minerva zur Verfügung, sobald du ihn speicherst; du musst nichts weiter tun. - **Deine eigenen Agenten**: Öffne den Agenten im AI-Hub unter **Agenten** und hake unter **Erlaubte Skills** deinen Skill an. Zeigt die Liste **Alle – auch künftige**, übernimmt der Agent neue Skills bereits automatisch. Auch ein Agent mit wenigen ausgewählten Skills braucht die Skills von Noreja für die Grundlagen (siehe [Agenten und Skills von Noreja](https://docs.noreja.com/de/article/agenten-und-skills-von-noreja)). Im Beispiel unten darf der Agent das Compliance-Briefing laden, dazu die Skills von Noreja, um die Perspektive zu finden, Geschäftsfälle zu zählen und Verstöße zu lesen: ![Die Liste Erlaubte Skills eines Agenten mit angehaktem Compliance briefing und weiteren Skills von Noreja darunter](https://cdn-assets.productfruits.com/4788a824-fc95-46ee-b4bc-d7839e05a535) Agenten von Noreja lassen sich nicht ändern. Um einen eigenen zu bauen, dupliziere einen in der Agentenliste und passe die Kopie an; gib ihr einen neuen Namen, denn die Kopie behält den Namen des Originals. ### 3\. Den Skill testen Teste jeden neuen oder geänderten Skill in einem neuen Chat (**Neuer Chat**), mit dem Agenten, für den er gedacht ist: - **Eine Frage, die den Skill nutzen sollte**, so formuliert, wie deine Benutzer fragen würden. Prüfe, ob die Zeile **Skill geladen** mit dem Namen deines Skills erscheint und ob die Antwort deinen Anweisungen folgt. - **Eine Frage, die ihn nicht nutzen sollte.** Dein Skill sollte nicht unter **Skill geladen** erscheinen. Tut er es doch, formuliere die Kurzbeschreibung genauer. - **Den Skill über seinen Schlüssel**: Gib **/** ein, wähle deinen Skill und ergänze den Rest der Frage, zum Beispiel */compliance-briefing Purchase-to-Pay*. ![Die Schritte von Minervas Antwort mit den Zeilen Skill geladen für Compliance briefing und für die Skills von Noreja, die sie zusätzlich genutzt hat](https://cdn-assets.productfruits.com/83546fb4-bf91-4e80-babb-6caf0268fbb4) ![Das Compliance-Briefing für Purchase-to-Pay im Format, das der Skill vorgibt: Anzahl der Geschäftsfälle, Geschäftsfälle mit Verstößen, eine Tabelle mit Verstoßart, Übergang, Fällen und Bedeutung sowie drei Punkte, die zuerst anzusehen sind](https://cdn-assets.productfruits.com/d5c1a07f-904c-4d9f-aced-2d7b3616b42e) ![Die Skill-Liste nach Eingabe von /compl im Chat mit /compliance-briefing und seiner Kurzbeschreibung](https://cdn-assets.productfruits.com/828d3b47-de42-4b43-9998-cc2afcf539b0) Warum ein neuer Chat: Ein Skill, den Minerva in einem Chat schon geladen hat, bleibt in diesem Chat so, wie er war. Änderungen an einem Skill erreichen neue Fragen sofort, aber nur in einem neuen Chat kannst du sicher sein, dass Minerva mit dem aktuellen Text arbeitet. ### Einen Skill schreiben, der funktioniert Diese Regeln stammen aus den Skills, die Noreja für Minerva geschrieben hat: - **Die Kurzbeschreibung ist der Auslöser.** Sag, wann der Skill genutzt werden soll, mit den Worten, die deine Benutzer eintippen: *„Nutzen, wenn jemand nach einem Compliance-Briefing, einer Übersicht der Verstöße oder einer einseitigen Zusammenfassung fragt …“*. Eine Beschreibung, die nur sagt, was der Skill enthält, wird oft übersehen. - **Eine Aufgabe pro Skill.** Etwa 300 bis 700 Wörter sind eine gute Größe. Zwei Aufgaben ergeben zwei Skills. - **Zweck und wichtigste Regel zuerst.** Die ersten beiden Sätze sagen, wofür das Ergebnis gedacht ist, und nennen die eine Regel, die nie gebrochen werden darf. - **Nummerierte Schritte, wo die Reihenfolge zählt**, zum Beispiel „erst die Perspektive finden, dann zählen, dann erklären“. - **Ein festes Ausgabeformat**, so ausgeschrieben, wie es aussehen soll. Dadurch werden Antworten von Woche zu Woche vergleichbar. - **Gründe für die Regeln.** „Unter 250 Wörtern bleiben: Prozessverantwortliche lesen es auf dem Smartphone“ wird zuverlässiger befolgt als „max. 250 Wörter“. - **Ein durchgerechnetes Beispiel**, etwa eine vollständige Tabellenzeile. - **Verbote mit Alternative**: nicht nur „nicht schätzen“, sondern „schreib *nicht verfügbar* statt einer Zahl“. - **Was zu antworten ist, wenn nichts gefunden wird**, damit Minerva die Lücke nicht mit Vermutungen füllt. - **Nur echte Zahlen.** Weise Minerva an, nur Zahlen zu verwenden, die sie aus Noreja gelesen hat. Lass weg, was Minerva schon gut kann, etwa eine Perspektive finden oder den Prozessgraphen lesen: Das decken die Skills von Noreja ab, und Minerva kombiniert sie mit deinen. ### Das Beispiel: Compliance-Briefing Der Beispiel-Skill auf dieser Seite erstellt ein einseitiges Briefing zu den Verstößen in einer Perspektive. Kopiere ihn als Ausgangspunkt und passe ihn an dein Unternehmen an. | Feld | Wert | | --- | --- | | **Skill-Name** | Compliance briefing | | **Kurzbeschreibung für das Modell** | Nutzen, wenn jemand nach einem Compliance-Briefing, einer Übersicht der Verstöße oder einer einseitigen Zusammenfassung fragt, wo ein Prozess von seiner erwarteten Reihenfolge abweicht, zum Beispiel für Prozessverantwortliche oder ein Management-Meeting. | **Skill-Anweisungen**: > Schreib ein einseitiges Compliance-Briefing zu einer Perspektive für Prozessverantwortliche, die zwei Minuten Zeit zum Lesen haben. Verwende nur Zahlen, die du in dieser Unterhaltung aus Noreja gelesen hast; schätze oder runde sie nie. > \> > \## Bevor du anfängst > Hat der Benutzer keine Perspektive genannt, frag, welche gemeint ist. Wähle nicht selbst eine aus: Ein Briefing über den falschen Prozess ist schlechter als keines. > \> > \## Schritte > 1\. Lies die Anzahl der Geschäftsfälle in der Perspektive und wie viele davon mindestens einen Verstoß haben. > 2\. Finde für jede Verstoßart (Reihenfolgefehler, Ignorieren, Nachbearbeitung) die drei Beziehungen mit den meisten Geschäftsfällen, anhand der Anzahl der Fälle, die Noreja für jede Beziehung angibt. Lass Abweichungen weg, die in der Perspektive erlaubt sind (reorder und simplification): Sie gehören zum erwarteten Prozess. > 3\. Durchsuche das Unternehmenswissen nach bekannten Gründen für die wichtigsten Befunde. Verwende einen Grund nur, wenn ein Dokument ihn nennt, und nenne das Dokument. > 4\. Schreib das Briefing im folgenden Format. > \> > \## Format > Verwende genau diese Struktur, in der Sprache der Frage: > \\*\\*Compliance-Briefing: \\*\\* > \- Geschäftsfälle: > \- Geschäftsfälle mit mindestens einem Verstoß: () > | Verstoßart | Wo | Fälle | Warum es wichtig ist | > |---|---|---|---| > | … | → | … | ein kurzer Satz | > \\*\\*Was zuerst anzusehen ist\\*\\* > 1\. > 2\. > 3\. > \\*Grundlage: , alle Geschäftsfälle, sofern der Benutzer keinen Filter genannt hat.\\* > \> > \## Regeln > \- Halte das gesamte Briefing unter 250 Wörtern. Prozessverantwortliche lesen es oft auf dem Smartphone. > \- Schreib Aktivitätsnamen so, wie sie in der Perspektive stehen; übersetze oder formuliere sie nicht um, damit sie im Analyzer auffindbar sind. > \- Übersprungene Schritte (Ignorieren) machen Geschäftsfälle schneller und günstiger und können deshalb wie eine Verbesserung aussehen. Sag immer, dass sie die Qualität gefährden. > \- Beschreibe Prozesse, nicht Personen. Nenne keine Benutzer, Teams oder Abteilungen als Ursache eines Verstoßes. > \- Empfiehl keine Tools, Projekte oder organisatorischen Änderungen; über Maßnahmen entscheiden die Prozessverantwortlichen. > \> > \## Beispielzeile > | Ignorieren | Order created → Goods received | 412 | Die Freigabe wird übersprungen, sodass Bestellungen ohne zweite Prüfung bei Lieferanten ankommen. | > \> > \## Wenn nichts gefunden wird > Hat die Perspektive keine Verstöße, schreib nur: „Keine Verstöße in gefunden.“ und die Zeile mit der Anzahl der Geschäftsfälle. Lässt sich eine Zahl nicht lesen, schreib „nicht verfügbar“ statt einer Zahl und sag, warum. Die Zeilen, die mit *##*, *\-*, *|* und *\\*\\\*\* beginnen, sind Markdown. Minerva liest sie als Überschriften, Listen, eine Tabelle und Fettdruck; du kannst Anweisungen mit oder ohne sie schreiben. ### Private und geteilte Skills - **Privat**: Nur du siehst den Skill in der Liste und in der **/**\-Liste des Chats, und nur du kannst ihn bearbeiten. - **Teilen**: Die Personen, mit denen du ihn teilst, sehen ihn ebenfalls und können ihn je nach Stufe bearbeiten oder weiter teilen. > **Wichtig:** Die Freigabe regelt, wer einen Skill sieht und bearbeitet, nicht, wem er nützt. Jeder Agent, der den Skill nutzen darf, auch Minerva, verwendet ihn für die Fragen aller, auch wenn der Skill privat ist. Schreib keine vertraulichen Informationen in einen Skill; lege sie stattdessen mit dem passenden Zugriff im Kontext Hub ab; siehe [Kontext Hub: Wissen für Minerva](https://docs.noreja.com/de/article/kontextualisierung-von-wissen-fur-minerva-ai). ### Gut zu wissen - Die Skills von Noreja lassen sich nicht ändern. Um einen anzupassen, nutze **Duplizieren** in der Liste und bearbeite die Kopie; sie erhält einen neuen Schlüssel, und der Skill von Noreja bleibt verfügbar. - Die Liste eines Agenten zeigt bis zu 15 Skills deines Unternehmens mit Namen. Hast du mehr, findet Minerva die übrigen über die Wörter in ihren Kurzbeschreibungen; genaue Beschreibungen sind dann noch wichtiger. - */key* funktioniert nur ganz am Anfang einer Nachricht. An anderer Stelle im Text wird es als normaler Text gesendet. ### Verwandte Artikel - [Was Minerva kann](https://docs.noreja.com/de/article/was-minerva-kann) - [AI-Hub: Agenten, Skills, Prompts und Arbeitsbereiche](https://docs.noreja.com/de/article/ai-hub-agenten-skills-prompts-und-arbeitsbereiche) - [Bessere Antworten von Minerva bekommen](https://docs.noreja.com/de/article/bessere-antworten-von-minerva-bekommen) - [Kontext Hub: Wissen für Minerva](https://docs.noreja.com/de/article/kontextualisierung-von-wissen-fur-minerva-ai)