Skill-Bibliothek

Ein Skill beschreibt eine wiederkehrende Arbeitsweise: Release Notes schreiben, ein Briefing prüfen oder ein Dokument nach euren Vorgaben erstellen. Er enthält eine Anweisungsdatei SKILL.md und bei Bedarf ergänzende Dateien. Pflege ihn unter Einstellungen > Skills an einer Stelle und statte die passenden Agenten damit aus.

Skills wirken überall dort, wo gearbeitet wird. Im Chat kann der Assistent jeden Skill aus deiner Bibliothek nutzen: Er liest einen, wenn er zu deiner Anfrage passt oder wenn du ihn nennst. Ein Projekt-Agent, der eine Aufgabe bearbeitet, oder ein Agent-Knoten in einer Automatisierung nutzt die Skills, mit denen er ausgerüstet ist. Eine Aufgabe kann jeder anlegen, der das Projekt öffnen kann; einen Agenten mit einem Skill auszurüsten, erfordert mindestens die Rolle Redakteur.

Jedes Mitglied kann einen Skill erstellen und seine eigenen bearbeiten. Zum Bearbeiten oder Löschen eines geteilten Skills einer anderen Person brauchst du die Rechte eines Organisationsadministrators. Deine Organisation kann das Teilen mit allen bestimmten Rollen vorbehalten; siehe Wer mit allen teilen darf.

Einen kleinen Skill erstellen

1. 1

   Den Skill benennen und seinen Einsatz erklären

   Öffne Einstellungen > Skills, dann Skill hinzufügen > Leerer Skill. Gib unter Name einen Namen wie brief-summary und eine Beschreibung ein:

   text

   Fasse ein Projektbriefing in Prüftermin, Zuständigkeit und offenen Fragen
   zusammen. Nutze den Skill für eine Übergabe oder eine kurze Briefing-Prüfung.

   Der Name ist eine eindeutige Kurzkennung: Kleinbuchstaben, Ziffern und einzelne Bindestriche, höchstens 64 Zeichen. An der Beschreibung erkennt das Modell, wann der Skill passt. Wähle unter Sichtbarkeit, wer den Skill sieht: Organisation oder Teams mit mindestens einem Team. Klicke auf Erstellen, um ihn anzulegen und den Editor zu öffnen.

2. 2

   Die Anweisungen schreiben

   Beschreibe unter Anweisungen (Body) einen kurzen Ablauf und ein überprüfbares Ergebnis. Zum Beispiel:

   markdown

   Lies das bereitgestellte Briefing. Erstelle eine Tabelle mit drei Zeilen:
   Prüftermin, Zuständigkeit und offene Fragen. Zitiere zu jeder Antwort den
   belegenden Satz. Schreibe „Nicht angegeben“, wenn eine Information fehlt.
   Leite aus einem Prüftermin keinen Veröffentlichungstermin ab.

   Ergänze Referenzdateien nur, wenn sie für den Ablauf hilfreich sind. Lege ausführliche Beispiele dort ab und erkläre, wann der Agent sie lesen soll.

3. 3

   Die Zielgruppe wählen und speichern

   Beim Erstellen ist Organisation vorausgewählt, sofern deine Organisation das nicht vorbehält. Ist der Inhalt für einen anderen Kreis bestimmt, ändere das unter Sichtbarkeit: Teams braucht mindestens ein Team. Ein Icon oder Labels können das Wiederfinden erleichtern. Klicke anschließend auf Speichern.

   Ein neuer Skill wird keinem Agenten automatisch zugeordnet. Öffne den Agenten des gewünschten Projekts und wähle den Skill in seiner Ausstattung. Starte eine kleine Aufgabe mit bekannten Eingaben und prüfe, ob das Ergebnis den Anweisungen entspricht.

Ein vorhandenes Bundle importieren

Nutze Skill hinzufügen > Zip hochladen oder Ordner hochladen. Im Stammverzeichnis muss SKILL.md liegen. Referenzen, Vorlagen und Skripte dürfen mitgeliefert werden:

brief-summary/
├── SKILL.md
└── references/
    └── example-brief.md

Die Vorschau zeigt Metadaten, Freigabe, Lizenz und Dateiliste, bevor Bundle hochladen etwas speichert. Prüfe Inhalt und Zielgruppe. Fehlt visibility, wird der Skill organisationsweit geteilt. Behält deine Organisation das vor und darfst du nicht veröffentlichen, weist die Vorschau darauf hin und Bundle hochladen bleibt gesperrt; ergänze in der SKILL.md visibility: team und die IDs deiner Teams. Wenn du einen Team-Skill anlegst oder seine Teams änderst, darfst du nur Teams deiner Organisation angeben, ohne Administratorrechte nur deine eigenen. Eine bestehende Teamliste darf unverändert bleiben, auch wenn ein Team inzwischen gelöscht wurde. Ein owner in der Datei wird ignoriert: Ein neuer Skill gehört dir. Ein ersetzter behält seinen bisherigen Eigentümer; hatte er keinen, gehört er danach dir. Existiert der Name schon, fragt Tale nach dem Ersetzen. Das betrifft auch Agenten, die diesen Skill verwenden.

Die Freigabe verstehen

Der Projektzugriff bestimmt die verfügbare Ausstattung, auch wenn du persönlich mehr Skills lesen kannst. Ein organisationsweites Projekt kann organisationsweite Skills nutzen. Ältere private Skills bleiben für ihren Inhaber sichtbar, lassen sich aber keinem Agenten zuordnen. Neue private Skills werden nicht angenommen.

Eine Einschränkung der Sichtbarkeit verlangt eine Bestätigung, weil Agenten dadurch Zugriff verlieren können. Das Löschen hat dieselbe praktische Folge: Ein Lauf, der das fehlende Bundle benötigt, kann es nicht bereitstellen. Prüfe die Verwendung eines geteilten Skills, bevor du ihn einschränkst oder entfernst.

Wer mit allen teilen darf

Standardmäßig kann jedes Mitglied einen Skill mit der ganzen Organisation teilen. Ein Admin kann das unter Skill-Freigabe Redakteuren und höher oder Inhabern und Admins vorbehalten und einzelnen Mitgliedern mit der Kompetenz Skills für die Organisation veröffentlichen das Veröffentlichen erlauben. Behält deine Organisation es vor und darfst du nicht veröffentlichen, gilt:

• Unter Sichtbarkeit ist Organisation nicht wählbar, und ein neuer Skill beginnt mit Teams. Mit deinen eigenen Teams kannst du teilen.
• Einen organisationsweiten Skill, den du erstellt hast, kannst du nicht direkt ändern. Schränke ihn auf deine Teams ein, auch zusammen mit anderen Änderungen im selben Speichervorgang, oder lösche ihn.
• Die Upload-Vorschau markiert ein Bundle, das mit der ganzen Organisation geteilt würde, auch eines ohne visibility, und Bundle hochladen bleibt gesperrt.

Skills, die schon mit der Organisation geteilt waren, bleiben geteilt.

Sehen, wer einen Skill erstellt und geändert hat

Die Spalte Erstellt von nennt das Mitglied, das den jeweiligen Skill erstellt hat. Suche in der Bibliothek nach einem Namen, um alles zu finden, was diese Person geteilt hat. Bei einem Skill ohne festgehaltenen Ersteller, etwa den Dokument-Skills, mit denen deine Organisation startet, steht dort Mitgeliefert, bei einem Skill aus einem verwalteten Konfigurations-Release Konfigurations-Release mit dem Mitglied, dessen Upload ihn installiert hat. Hat der Ersteller die Organisation verlassen, steht dort Ehemaliges Mitglied.

Öffne einen Skill, um Erstellt von und Zuletzt bearbeitet von zu sehen: das Mitglied, dessen Speichern oder Hochladen in Tale die aktuelle Version erzeugt hat. Zuletzt bearbeitet von fehlt, wenn seit dem Erstellen niemand den Skill bearbeitet hat oder die Datei seit der letzten Bearbeitung außerhalb von Tale geändert wurde. Auch die Skill-Liste in der Ausrüstung eines Agenten nennt unter jedem Skill seinen Ersteller.

Tale hält das Erstellen, Bearbeiten, Hochladen und Löschen eines Skills sowie jede Änderung seiner Sichtbarkeit oder Teams im Audit-Log fest. Administratoren und Inhaber finden diese Einträge unter Einstellungen > Richtlinien > Protokolle in der Kategorie Skill.

Dateireferenz

Eine minimale SKILL.md sieht so aus:

---
name: brief-summary
description: Fasse ein Projektbriefing zusammen. Nutze dies für Übergaben und Prüfungen.
visibility: org
---

Lies das Briefing. Nenne Prüftermin, Zuständigkeit und offene Fragen.
Zitiere Belege und kennzeichne fehlende Informationen mit „Nicht angegeben“.

Unbekannte Frontmatter-Schlüssel bleiben erhalten. Die Frontmatter darf bis zu 16 KB groß sein, die gesamte SKILL.md bis zu 512 KB. Häufig gelesene Anweisungen sollten deutlich kürzer bleiben.

Aktualisieren und Probleme lösen

Öffne eine Zeile, um Beschreibung, Anweisungen, Labels und Sichtbarkeit zu ändern. Unter Bundle kannst du ergänzende Dateien prüfen. Agenten sind nicht an eine bestimmte Fassung gebunden: Beim nächsten Bereitstellen wird das aktuelle Bundle verwendet. Teste gemeinsame Änderungen deshalb mit einer typischen Aufgabe.

Unter Labels trägst du bis zu acht Labels mit je höchstens 40 Zeichen ein, durch Kommas getrennt. Ist die Liste länger oder ein Label zu lang, sagt dir das Feld, was du entfernen oder kürzen musst, und Speichern bleibt gesperrt. Von deiner Eingabe geht dabei nichts verloren. Der Baum unter Bundle merkt sich für jeden Skill in deinem Browser, welche Ordner du eingeklappt hast.

Kann Tale einen Skill oder eine seiner Dateien nicht laden, sagt der Dialog das und bietet Erneut versuchen an. Schlägt eine Aktualisierung fehl, bleibt der bereits angezeigte Stand stehen, ungespeicherte Änderungen eingeschlossen. Eine entfernte Datei meldet der Dialog als nicht mehr im Bundle, eine leere Datei als leer.

Speichert jemand anderes den Skill, nachdem du ihn geöffnet hast, lehnt Tale dein Speichern ab und sagt dir das. Nichts wird überschrieben, und deine Änderungen bleiben im Editor: Kopiere, was du brauchst, schließe den Skill und öffne ihn erneut, um die neueste Version zu sehen. Ein Editor, in dem du nichts geändert hast, übernimmt die neuere Version von selbst.

Findet ein Agent den Skill nicht, prüfe seine Ausstattung und die Sichtbarkeit für das Projekt. Tale zeigt ihm einen Beschreibungsauszug von bis zu 300 Zeichen als Auswahlhilfe. Beschreibe deshalb zuerst, wann der Skill passt. Ignoriert er einen zugeordneten Skill, nenne ihn in der Aufgabe und prüfe das Ergebnis anhand seiner Anweisungen. Skills für Agenten erklärt, wie das zugeordnete Bundle bereitgestellt und dem Agenten genannt wird.

Prüfe bei einem Importfehler, ob SKILL.md im Stammverzeichnis liegt, gültige Frontmatter enthält und einen gültigen Namen hat. Die Fehlermeldung nennt abgelehnte Pfade oder Größenlimits. Zum Entfernen öffne das Bundle und wähle nach Prüfung der betroffenen Agenten Skill löschen.