Skills

Ein Skill ist eine kurze Anleitungsdatei für eine Art von Aufgabe: wie der Monatsbericht aufgebaut wird, wie eine Frachtführerrechnung geprüft wird, welche Schritte zu befolgen sind, wenn ein Kunde ein Angebot anfragt. „Anleitungen, die Ihre Agenten laden, wenn eine Aufgabe sie braucht.“ Sie schreiben ihn einmal, und der Assistent lädt ihn, sobald eine Anfrage passt. Ein Agent legt fest, wer der Assistent ist; ein Skill legt fest, wie eine bestimmte Aufgabe erledigt wird.

Bevor Sie beginnen

• Skills sind in jedem Tarif enthalten; der KI-Assistent nutzt sie, daher braucht der Tarif KI.
• Alle können Skills lesen. Mitglieder und Admins erstellen und ändern sie; alle anderen sehen: „Sie können diesen Skill lesen, haben aber keine Berechtigung, ihn zu ändern.“
• Alle in der Organisation können einen Skill lesen, also gehören keine Geheimnisse hinein.

Wie ein Skill genutzt wird

Der Assistent sieht immer den Namen und die Beschreibung der aktiven Skills und sonst nichts. Passt eine Anfrage zu einer Beschreibung, lädt er die Anleitung des Skills und befolgt sie; Begleitdateien liest er nur, wenn die Anleitung auf sie verweist.

Deshalb ist die Beschreibung am wichtigsten: „Agenten wählen einen Skill anhand der Beschreibung.“ Sagen Sie, was der Skill tut und wann er zu verwenden ist, mit den Worten, die Ihr Team tippen würde. Die Liste, die der Assistent sieht, fasst bis zu 30 Skills und insgesamt etwa 4.000 Zeichen, und jede Beschreibung wird nach 200 Zeichen abgeschnitten; stellen Sie die wichtigsten Begriffe also an den Anfang.

Der Tab Skills

Öffnen Sie Agenten in der Seitenleiste und dann Skills.

• Die Liste hat zwei Gruppen, Ihre Organisation und Global, mit Skills durchsuchen darüber. Abzeichen markieren Global, Inaktiv, Entwurf und Nicht gespeicherte Änderungen.
• Neuer Skill: Leerer Skill oder SKILL.md oder .zip importieren.
• Ein Skill öffnet sich im Editor: Quelltext oder Vorschau (Inhaltsansicht), die Zeichenzahl (zum Beispiel „1240 / 40000 Zeichen“), Erlaubte Werkzeuge sowie wann und von wem er zuletzt geändert wurde („Aktualisiert am 02.11.2026 von Kasia Próbna“).
• Aktiv: Agenten können diesen Skill verwenden: Ein inaktiver Skill bleibt in der Liste, wird dem Assistenten aber nicht angeboten.
• Änderungen speichern / Skill erstellen, Änderungen verwerfen und unter Weitere Aktionen: Exportieren, Duplizieren, Löschen („‚carrier-scorecard‘ wird mit seinen Begleitdateien gelöscht. Agenten können ihn danach nicht mehr verwenden.“).

Der Editor prüft die Datei während des Tippens und nennt jedes Problem darunter, zum Beispiel „Der Name darf nur Kleinbuchstaben ohne Umlaute, Ziffern und einzelne Bindestriche enthalten, zum Beispiel monatsbericht-kunden.“ oder „Fügen Sie im Kopfbereich eine Beschreibung (description) hinzu. Agenten wählen einen Skill anhand der Beschreibung.“ „Beheben Sie die unter dem Editor markierten Probleme, um zu speichern.“

Eine SKILL.md schreiben

„SKILL.md-Format: Der Kopfbereich zwischen den Zeilen --- enthält name, description und optional allowed-tools. Darunter folgt die Anleitung in Markdown.“

Die Anleitung unter dem Kopfbereich darf bis zu 40.000 Zeichen lang sein. Andere Felder im Kopfbereich werden nicht gespeichert: „Diese Felder des Kopfbereichs werden nicht gespeichert und entfallen beim Speichern“.

Ein kurzes, vollständiges Beispiel:

---
name: carrier-scorecard
description: Build the monthly carrier scorecard from the Zlecenia table. Use when someone asks for a carrier ranking, on-time delivery or the monthly scorecard.
allowed-tools:
  - read_spreadsheet
  - search_library
---
 
# Carrier scorecard
 
## When to use
 
Requests for a ranking of carriers, on-time delivery or the monthly scorecard.
Not for a single order: answer those directly.
 
## Steps
 
1. Read the Zlecenia table for the month the user asked about.
2. For each carrier count the orders, the late ones and the claims.
3. Rank carriers by the share of on-time deliveries, best first.
4. For the wording of the summary read templates/summary.md.
 
## Rules
 
- An order is late when Rozładunek is after the agreed date.
- Leave out carriers with fewer than 5 orders and say that you did.
- Always state the month and the number of orders the ranking is based on.

Das Beispiel setzt allowed-tools, weil eine Bewertung nur liest; die Einschränkung gilt, wenn jemand den Skill mit / wählt. Die meisten Skills brauchen das nicht: Lassen Sie das Feld weg, und der Assistent behält alles, was er normalerweise hat.

Gewohnheiten, mit denen ein Skill funktioniert:

• Beginnen Sie die Beschreibung damit, was der Skill tut, dann wann: „Use when...“ bzw. „Verwenden, wenn...“.
• Nummerieren Sie die Schritte in der Reihenfolge, in der sie erledigt werden.
• Schreiben Sie Regeln mit ihren Zahlen („weniger als 5 Aufträge“), nicht „sei vorsichtig“.
• Nennen Sie Ihre echten Tabellen, Spalten, Schwellenwerte und Formulierungen.
• Halten Sie Geheimnisse heraus: Alle in der Organisation können einen Skill lesen.

Begleitdateien

„Textdateien, auf die der Skill verweisen kann: Referenzen, Vorlagen, Beispiele.“ Ein Skill fasst bis zu 10 davon („Ein Skill fasst bis zu 10 Dateien.“).

1. Klicken Sie unter Begleitdateien auf Datei hinzufügen.
2. Geben Sie einen Pfad an, etwa referenzen/preisliste.md (bis zu 120 Zeichen, Schrägstriche, kein ..).
3. Tippen Sie den Inhalt ein oder nutzen Sie Aus einer Datei laden (nur Text, bis zu 60.000 Zeichen). Klicken Sie auf Datei speichern.

Verweisen Sie in der Anleitung auf jede Datei mit ihrem genauen Pfad und sagen Sie, wann sie zu lesen ist, wie es Schritt 4 des Beispiels tut. Eine Datei, die die Anleitung nie erwähnt, wird nie gelesen.

Import und Export

Skills verwenden das offene Format Agent Skills (agentskills.io). Ein in Quanty geschriebener Skill funktioniert daher in anderen Werkzeugen, die das Format lesen, und Skills von anderswo lassen sich übernehmen.

• Import: SKILL.md oder .zip importieren, oder legen Sie die Datei auf der Seite ab („SKILL.md oder .zip hier ablegen, um zu importieren“). Eine Datei, bis zu 2 MB; eine .zip enthält die SKILL.md und bis zu 10 Begleitdateien. Was nicht übernommen werden konnte, steht unter Mit Hinweisen importiert.
• Export: lädt den Skill mit seinen Begleitdateien als .zip herunter. „Exportiert die gespeicherte Version, ohne Ihre nicht gespeicherten Änderungen.“

Globale Skills

Globale Skills kommen mit Quanty: „Globale Skills werden von Quanty gepflegt und können nicht bearbeitet werden. Duplizieren Sie diesen Skill, um eine eigene Version zu erhalten.“ Zum Bearbeiten duplizieren legt eine Kopie in Ihrer Organisation an.

Skills pro Agent

Die Einstellungen jedes Agenten haben einen Bereich Skills:

• Alle aktiven Skills: jeder aktive Skill, auch später hinzugefügte.
• Ausgewählte Skills: nur die Skills, die Sie wählen (bis zu 50).

Mit Ausgewählte Skills und ohne Auswahl arbeitet der Agent ohne Skills. Skills verwalten öffnet den Tab Skills.

Einen Skill im Chat wählen

Tippen Sie / in das Nachrichtenfeld. Zuerst kommt die Gruppe Erstellen (ein Dashboard, Folien, ein Word-Dokument, eine Excel-Datei, eine PowerPoint-Datei), dann die Skills Ihrer Organisation unter Skills. Tippen Sie weiter, um die Liste einzugrenzen („Kein passender Skill“), wählen Sie einen und schreiben Sie Ihre Anfrage. Der Skill gilt für diese eine Nachricht. Ist er nicht mehr verfügbar: „Der ausgewählte Skill ist nicht verfügbar, daher wurde diese Antwort ohne ihn geschrieben.“

Grenzen

Verwandte Seiten

• Agenten: wer der Assistent ist und welche Skills jeder Agent nutzt.
• Tabellen, Dateien, Dashboards und Präsentationen aus dem Chat: das Menü / und im Chat erstellte Dateien.
• Einen Bericht im Chat schreiben: eine Anleitung, die Skills nutzt.