SovrGPT Dokumentation

Skills

Skills in SovrGPT: wiederverwendbare Arbeitsanleitungen für Agenten. Mitgelieferte, Firmen- und eigene Skills, Freigabe mit Fassungen, Skill-Pakete mit Dateien als ZIP, Import und Export als SKILL.md.

Ein Skill ist eine Arbeitsanleitung für eine wiederkehrende Aufgabe, etwa „Angebot prüfen“ oder „Protokoll schreiben“. Sie hängen Skills an einen Agenten. Passt eine Anfrage zur Beschreibung eines Skills, holt der Agent die Anleitung selbst und arbeitet danach.

Sie verwalten Skills unter Agenten → Skills (/agents/skills).

Drei Arten

ArtWer legt anWer sieht und nutzt
MitgeliefertSovrGPTjede Organisation
FirmaInhaber und Admins einer Team-Organisationalle Mitglieder, immer die freigegebene Fassung
Eigenejedes Mitgliednur Sie, nur in Ihren eigenen Agenten, nur in dieser Organisation

Mitgeliefert sind derzeit Besprechungsprotokoll, Geschäftliche Antwort und Vertragsklauseln prüfen.

Skills an einen Agenten hängen

Im Agenten unter Skills die Häkchen setzen und speichern.

  • Höchstens 20 Skills je Agent. Der Zähler zeigt „N von 20“; gespeichert werden die ersten 20.
  • Tragen zwei gewählte Skills denselben Namen, nutzt der Agent nur den ersten. Das Speichern weist darauf hin.
  • Nur Modelle, die Werkzeuge nutzen können, laden Skills. Bei anderen Modellen zeigt das Formular „Dieses Modell lädt keine Skills“.
  • Geplante Aufgaben mit Agent nutzen dessen Skills ebenfalls.
  • Bei Modellen mit kleinem Kontextfenster kürzt SovrGPT die Beschreibungen in der Skill-Liste des Agenten und lässt notfalls die hinteren Skills weg.

Einen Skill gezielt wählen: /skill

Normalerweise entscheidet der Agent selbst, ob ein Skill zur Aufgabe passt. Im Chat mit einem Agenten können Sie ihn auch vorgeben:

  1. Tippen Sie / oder /skill in das leere Eingabefeld. Es öffnet sich die Liste der Skills dieses Agenten, mit Beschreibung und Herkunft. Weitertippen filtert sie.
  2. Mit den Pfeiltasten wählen und mit Enter übernehmen (oder anklicken). Der Skill steht als Hinweis über dem Feld; mit ✕ nehmen Sie die Wahl zurück.
  3. Schreiben Sie Ihre Nachricht und senden Sie sie. Der Skill gilt für diese eine Nachricht.
  • Der Agent hat den Skill dann schon geladen, wenn er zu antworten beginnt. Der Skill wird dabei genauso geprüft, als hätte der Agent ihn selbst geladen: Freigabe, Fassung und bei eigenen Skills das Eigentum.
  • Die Liste ist leer, wenn der Chat ohne Agent läuft, der Agent keine Skills hat oder das Modell keine Werkzeuge nutzen kann.
  • Bei Modellen mit kleinem Kontextfenster zeigt die Liste nur die Skills, die in die Skill-Liste des Agenten passen. Die weggelassenen hinteren Skills lassen sich dort auch nicht vorgeben.
  • Auch ein gewählter Skill bleibt eine Anleitung: Er vergibt keine Rechte und hebt keine Regel auf.

Eigene Skills

  • Privat: Nur Sie sehen, ändern, exportieren und löschen sie, auch Inhaber und Admins nicht. Es gibt keinen Eintrag im Audit-Protokoll.
  • Je Organisation, höchstens 50 je Person und Organisation.
  • Ohne Freigabe: Was Sie speichern, gilt ab der nächsten Anfrage.
  • Nur in Ihren eigenen Agenten und nur in Ihren Chats. Chattet jemand anders mit Ihrem Agenten, bekommt er die mitgelieferten und die Firmen-Skills, Ihre eigenen nicht. Andere sehen höchstens, dass ein privater Skill am Agenten hängt, nie welcher.
  • Eine Firmenvorlage aus Ihrem Agenten übernimmt keine eigenen Skills.
  • Verlassen Sie die Organisation, werden Ihre eigenen Skills dort gelöscht.

Firmen-Skills

Firmen-Skills gibt es nur in Team-Organisationen, nicht im persönlichen Bereich. Anlegen und verwalten dürfen Inhaber und Admins. Mitglieder sehen und nutzen die freigegebene Fassung.

  1. Entwurf anlegen: ein neuer Skill oder eine neue Fassung eines bestehenden. Je Skill gibt es höchstens einen offenen Entwurf. Bis zur Freigabe arbeiten die Agenten mit der bisherigen Fassung.
  2. Hinweise ansehen: SovrGPT prüft den Entwurf und zeigt Stellen, die ein Skill selten braucht, etwa Webadressen, Werkzeugnamen, Schlüssel oder Formulierungen, die Regeln aushebeln wollen. Hinweise sperren nicht, vor der Freigabe bestätigen Sie aber mit einem Häkchen, dass Sie sie gesehen haben.
  3. Freigeben oder ablehnen. Nach der Freigabe arbeiten alle Agenten ab der nächsten Anfrage mit dieser Fassung, auch in laufenden Chats.

Vier-Augen-Prinzip: Hat die Organisation mindestens zwei Inhaber oder Admins, gibt eine andere Person frei als die, die den Entwurf geschrieben hat. Gibt es nur eine solche Person, darf sie selbst freigeben. Sie bestätigt das mit einem Häkchen, und die Fassung wird als Selbstfreigabe vermerkt.

Später stehen auf der Seite des Skills diese Schritte zur Wahl:

SchrittWirkung
Diese Fassung verwendenDie Agenten nutzen eine andere freigegebene Fassung, eine ältere (Zurückrollen) oder danach wieder eine neuere.
ZurückziehenDie Fassung gilt nicht mehr. War sie im Einsatz, greift die nächstältere freigegebene Fassung, sonst lädt kein Agent den Skill.
ArchivierenKein Agent lädt den Skill mehr, der Name wird wieder frei. Das lässt sich nicht rückgängig machen.
  • Jede Fassung bleibt unverändert. Eine Änderung ergibt eine neue Fassung, der Name bleibt fest.
  • Jeder Schritt steht im Audit-Protokoll der Organisation, mit der Kennung des Skills und, wo es um eine Fassung geht, mit der Fassungsnummer, nie mit Inhalt.
  • Höchstens 200 Firmen-Skills je Organisation (archivierte zählen mit) und 100 Fassungen je Skill.

Inhalt und Grenzen

FeldRegel
Namea–z, 0–9 und einzelne Bindestriche, höchstens 64 Zeichen. Nach dem ersten Speichern fest. Nicht der Name eines mitgelieferten Skills.
Wann soll der Agent ihn nutzen?Pflicht, höchstens 1 024 Zeichen, keine spitzen Klammern. Der Agent liest diesen Satz bei jeder Anfrage.
AnleitungPflicht, Markdown, höchstens 20 000 Zeichen.
Lizenzoptional, höchstens 200 Zeichen. Die Namen docx, pdf, pptx und xlsx mit der Lizenz „proprietary“ oder „source-available“ werden abgelehnt, beim Anlegen von Hand wie beim Import.

Abgelehnte Zeichen. In allen Feldern: Unicode-Tag-Zeichen, Zeichen, die die Schreibrichtung umstellen, und Steuerzeichen außer Tabulator und Zeilenumbruch. In Name, Beschreibung und Lizenz zusätzlich unsichtbare Zeichen wie das Leerzeichen ohne Breite. In der Anleitung ergeben unsichtbare Zeichen und XML-Tags nur einen Hinweis.

Zusammengesetzte Emoji und Emoji mit Hautfarbe sind erlaubt. Die Flaggen von England, Schottland und Wales werden abgelehnt, weil sie aus Tag-Zeichen bestehen.

Was ein Skill nicht kann

  • Keine Rechte, keine Werkzeuge. Welche Werkzeuge und Anbindungen ein Agent hat, legen der Agent und die Organisation fest. Eine Anleitung ändert daran nichts, auch wenn sie ein Werkzeug nennt.
  • Die Angabe allowed-tools einer SKILL.md wird ignoriert.
  • Keine Skripte. Ein Skill führt nichts aus. Der Ordner scripts/ eines Skill-Pakets wird beim Import verworfen, auch wenn er nur Text enthält.
  • Nur Text. Bilder, Schriften, Vorlagen wie .pptx und andere Binärdateien werden beim Import verworfen.

Skill-Pakete (ZIP) mit Dateien

Ein Skill kann neben der Anleitung Textdateien mitbringen, etwa Preislisten, Formulierungsbeispiele oder Tabellen. Der Agent liest sie nur, wenn er sie braucht: erst lädt er den Skill, dann liest er die Datei, die die Anleitung nennt.

Import auf der Seite Neuer eigener Skill oder Neuer Firmen-Skill: dieselbe Dateiauswahl wie für eine SKILL.md, nur mit einem ZIP-Archiv. Erkannt wird das Archiv am Inhalt, nicht an der Endung. Ein Firmen-Skill landet auch hier als Entwurf.

RegelGrenze
Archivhöchstens 2,5 MB gepackt, 8 MB entpackt, 50 Einträge (Ordner und Systemdateien wie __MACOSX/ mitgezählt), keine Verschlüsselung
Aufbaugenau eine SKILL.md ganz oben – oder in genau einem Ordner, der alles enthält. Weitere Dateien daneben oder in einer Ordnerebene darunter, etwa references/
Dateienhöchstens 49 neben der SKILL.md, je Datei höchstens 256 KB, zusammen höchstens 2 MB
Endungen.md, .txt, .json, .csv, .yaml, .yml, Text in UTF-8
DateinamenBuchstaben ohne Umlaute, Ziffern, Punkt, Bindestrich und Unterstrich, je Name höchstens 64 Zeichen, nicht mit einem Punkt am Anfang oder Ende

Was verworfen wird – der Import läuft weiter, die Seite nennt es danach:

  • Dateien mit anderen Endungen (Bilder, Schriften, Vorlagen), auch große.
  • Dateien, die kein Text in UTF-8 sind, und leere Dateien.
  • Der Ordner scripts/.
  • Systemdateien wie __MACOSX/, .DS_Store und Thumbs.db. Zur Grenze von 50 Einträgen zählen sie trotzdem: Der Finder von macOS legt zu vielen Dateien eine Begleitdatei ._<name> an. Wird ein Paket deshalb abgelehnt, packen Sie es im Terminal neu, etwa mit zip -r paket.zip ordner -x '*.DS_Store' – das legt weder __MACOSX/ noch ._-Dateien an.

Was den Import ablehnt: eine Textdatei über 256 KB, ein Dateiname gegen die Regeln oder mit Umlauten, mehr als eine Ordnerebene, eine fehlende oder doppelte SKILL.md und in einer Datei Unicode-Tag-Zeichen oder Zeichen, die die Schreibrichtung umstellen. Die Anleitung verweist auf ihre Dateien beim Namen; ein stilles Verwerfen bräche diesen Verweis.

SovrGPT entfernt am Anfang einer Datei eine Byte-Reihenfolge-Markierung (BOM) und setzt zerlegte Zeichen, etwa Umlaute aus macOS, zusammen. Danach gilt für jede Datei dieselbe Prüfung wie für die Anleitung: Stellen wie Webadressen oder Formulierungen, die Regeln aushebeln wollen, ergeben einen Hinweis.

Dateien ansehen. Auf der Seite des Skills stehen die Dateien mit ihrer Größe. Ein Klick zeigt den Text als reinen Text, mit den Hinweisen der Prüfung zu dieser Datei. Bei Firmen-Skills sehen Mitglieder die Dateien der freigegebenen Fassungen, Inhaber und Admins auch die des Entwurfs. Sehen Sie vor der Freigabe jede Datei an. Hat die Prüfung in Dateien Stellen gefunden, bestätigen Sie das vor der Freigabe mit dem Häkchen.

Bearbeiten.

  • Eigener Skill: Auf seiner Seite fügen Sie eine Textdatei hinzu (oben oder in einem Ordner wie references), ersetzen eine Datei durch eine neue Fassung oder entfernen sie. Beim Ersetzen bleibt der Name im Skill derselbe, gleich wie die hochgeladene Datei heißt. Jede Änderung speichert eine neue Fassung. Ändern Sie nur Beschreibung oder Anleitung, bleiben die Dateien erhalten.
  • Firmen-Skill: Im Formular Neue Fassung steht jede Datei der Fassung, aus der das Formular vorbefüllt ist, mit einem Häkchen – entfernen Sie es, fehlt die Datei in der neuen Fassung. Dazu laden Sie neue Dateien hoch; eine Datei mit dem Namen einer übernommenen ersetzt sie. Gespeichert wird ein Entwurf mit allen Dateien; die bisherige Fassung bleibt unverändert.
  • Für hochgeladene Dateien gelten dieselben Regeln wie im ZIP-Paket (Endungen, Namen, 256 KB je Datei, 49 Dateien, 2 MB zusammen), dazu höchstens 1 MB auf einmal. Anders als beim ZIP-Import wird nichts still verworfen: Eine Datei, die nicht passt, lehnt das Speichern mit einer Meldung ab. In den Ordner scripts/ lassen sich keine Dateien legen.

Vergleichen. Fassungen vergleichen zeigt bei Firmen-Skills auch die Dateien: welche hinzugekommen, entfernt oder geändert sind. Bei einer veränderten Datei zeigt Unterschiede ansehen die geänderten Zeilen.

Export. Skills mit Dateien laden Sie als ZIP-Paket herunter (Als ZIP-Paket herunterladen bzw. Fassung N als ZIP-Paket herunterladen). Das Paket enthält einen Ordner mit dem Namen des Skills, darin die SKILL.md und alle Dateien. Es lässt sich unverändert wieder importieren; die Prüfsumme des Inhalts bleibt dieselbe. Ließe sich auch nur eine Datei gerade nicht lesen, gibt es kein Paket – nie ein unvollständiges.

Wo die Dateien liegen. In einem privaten Speicher von SovrGPT in der EU, nur über den Server erreichbar. Löschen Sie einen eigenen Skill oder verlassen Sie die Organisation, werden seine Dateien entfernt.

Import und Export als SKILL.md

Import auf der Seite Neuer eigener Skill oder Neuer Firmen-Skill: eine .md-Datei wählen oder den Text einfügen. Für ein Paket mit Dateien siehe Skill-Pakete (ZIP) mit Dateien.

  • Eine einzelne SKILL.md in UTF-8, höchstens 96 KB, mit einem Kopf zwischen zwei Zeilen ---.
  • Im Kopf Pflicht: name und description. Übernommen werden außerdem license und die Anleitung darunter.
  • compatibility, metadata und unbekannte Angaben werden verworfen, allowed-tools wird ignoriert. Die Seite nennt das nach dem Import.
  • Danach gilt dieselbe Prüfung wie beim Anlegen von Hand. Ein Firmen-Skill landet als Entwurf und gilt erst nach der Freigabe.
  • Die Lizenzsperre für docx, pdf, pptx und xlsx gilt auch hier (siehe Inhalt und Grenzen). Nur beim Import ergeben andere einschränkende Lizenzangaben einen Hinweis.

Export auf der Seite eines Skills: bei eigenen Skills mit Als SKILL.md herunterladen, bei Firmen-Skills mit Fassung N als SKILL.md herunterladen. Hat der Skill Dateien, kommt stattdessen ein ZIP-Paket (siehe oben).

  • Eigene Skills exportieren nur Sie.
  • Firmen-Skills exportieren alle Mitglieder, immer die Fassung im Einsatz. Ein Entwurf lässt sich nicht exportieren.
  • Der Kopf enthält name, description, gegebenenfalls license und unter metadata Herkunft, Fassung und Prüfsumme des Inhalts.
Skills