Microsoft beschreibt einen Custom Skill für deklarative Agenten als Verzeichnis mit einer verpflichtenden SKILL.md und optionalen Ressourcen oder Skripten. Das Paket wird erst geladen, wenn die Aufgabe es benötigt. Dieses Prinzip kann Kontext fokussieren und wiederkehrende Ergebnisse stabilisieren.

Organisatorisch ist ein Skill jedoch mehr als eine technische Datei. Sobald mehrere Personen dieselbe Anleitung, Vorlage oder Berechnungslogik verwenden, entsteht ein Prozessbaustein. Er benötigt fachliches Eigentum, definierte Ein- und Ausgaben, Qualitätstests und nachvollziehbare Änderungen.

Den richtigen Wiederverwendungsgrad wählen

Ein persönlicher Prompt passt zu einmaliger Exploration oder situativer Urteilsarbeit. Eine Agentenanweisung enthält Regeln, die fast immer gelten. Ein Skill passt zu einer klar erkennbaren Aufgabe, die wiederkehrt, eine stabile Sequenz oder gemeinsame Assets benötigt und nur bei Bedarf in den Kontext gehört.

Ein klassischer Workflow oder eine Anwendung ist besser, wenn feste Transaktionsschritte, persistenter Status, verbindliche Freigaben oder garantierte Integrationen erforderlich sind. Skills können Arbeit anleiten und Dateien verarbeiten. Sie sind kein Ersatz für jedes deterministische System.

Ein Skill lohnt sich, wenn Aufgabe und Nutzer wiederkehren, ein stabiler Eigentümer die Qualität definieren kann und das Paket aus Anleitung, Ressourcen oder Skripten die Zuverlässigkeit messbar verbessert. Ändert sich die zugrunde liegende Richtlinie ständig, sollte zuerst der Prozess geklärt werden.

Der Skill-Vertrag mit acht Feldern

Vor der Datei entsteht ein fachlicher Vertrag.

1. Zweck

Ein einziges Ergebnis wird benannt. “Finance unterstützen” ist zu weit. “Aus der freigegebenen Eingabedatei einen Quartalsbericht vorbereiten” ist prüfbar.

2. Auslöser

Der Vertrag beschreibt passende Nutzeranfragen und ähnliche Anfragen, bei denen der Skill nicht aktiviert werden darf.

3. Eingaben

Formate, Pflichtfelder, autoritative Quellen, Aktualität und Schutzbedarf werden dokumentiert. Für fehlende oder widersprüchliche Angaben existiert ein Verhalten.

4. Ergebnisvertrag

Struktur, Zielgruppe, Quellenhinweise, Berechnungen, Dateiformat und Abnahmekriterien werden festgelegt. Ebenso wichtig ist, was nicht geschätzt werden darf.

5. Erlaubte Fähigkeiten

Ressourcen, Skripte, Connectoren und Werkzeuge werden erfasst. Die aktuelle Custom-Skill-Dokumentation beschreibt für Skill-Skripte eine Sandbox ohne Netzwerkzugriff oder Paketinstallation zur Laufzeit. Plattformgrenzen gehören in den Entwurf.

6. Tests

Repräsentative, schwierige und absichtlich manipulative Fälle besitzen erwartete Eigenschaften. Geprüft wird sowohl die Aktivierung als auch das Ergebnis.

7. Eigentum und Version

Fachlicher Eigentümer und technischer Betreuer werden benannt. Version, Änderungsgrund, Freigabe und kompatible Agenten bleiben nachvollziehbar.

8. Prüfung und Stilllegung

Ein Prüftermin, Nutzungssignal und Stilllegungskriterium verhindern, dass veraltete Richtlinien oder Vorlagen unsichtbar weiterwirken.

Beispiel: Quartalsbericht

Ein Finance-Team überführt jedes Quartal eine freigegebene Arbeitsmappe in eine Management-Präsentation. Unterschiedliche Prompts, KPI-Definitionen und Folienstrukturen erzeugen unnötige Abstimmung.

Der neue Skill hat einen Zweck: einen Entwurf des Quartalsberichts erstellen. Er enthält KPI-Definitionen, die genehmigte Folienvorlage, Regeln für Abweichungskommentare und ein geprüftes Skript zur Diagrammerzeugung. Der Ergebnisvertrag verlangt Verweise auf Quellblätter. Fehlende Werte werden markiert und nicht erfunden.

Das Testset enthält ein normales Quartal, eine fehlende Region, einen gültigen negativen Wert, ein umbenanntes Tabellenblatt und eine manipulierte Anweisung in einem Freitextfeld. Geprüft werden Summen, Fehlerbehandlung, Quellenbezug und das Ignorieren eingebetteter Instruktionen.

Finance verantwortet Definitionen und Vorlage. Das Agententeam verantwortet Paket, Tests und Release. Eine neue Umsatzdefinition führt zu einer neuen Version und vollständigen Regressionstests. So sieht eine kontrollierte Arbeitsanweisung aus.

Fünf Stufen im Lebenszyklus

In der Gestaltung wird reale Arbeit beobachtet, der Umfang begrenzt und der Vertrag abgeschlossen. Widersprüchliche Quellen werden vor dem Packaging bereinigt.

Im Test werden Aktivierung, Ergebnis und Fehlerverhalten geprüft. Dazu gehören sensible Daten, beschädigte Eingaben, eingebettete Anweisungen und die Abhängigkeiten eines Skripts.

Beim Release wird das vollständige Paket kontrolliert, nicht nur die SKILL.md. Version und zugelassener Agent werden dokumentiert. Eine gute Vorschau ersetzt keine fachliche Abnahme.

Im Betrieb zählen Nutzung, erfolgreicher Abschluss, Korrekturaufwand, falsche Aktivierung und Quellenaktualität. Zufriedenheit allein kann sachliche Fehler verdecken.

Bei Änderung oder Stilllegung wird immer eine kontrollierte Version angepasst, das Regressionstestset erneut ausgeführt und eine wesentliche Verhaltensänderung kommuniziert. Doppelte oder veraltete Skills werden entfernt.

Kein digitales Abteilungshandbuch bauen

Ein typischer Fehler ist ein großer Skill mit allen Regeln, Richtlinien und Vorlagen einer Abteilung. Sein Auslöser wird unklar, Eigentum zerfällt und jede Änderung besitzt eine große Wirkung. Unterschiedliche Ergebnisse, Datenklassen, Eigentümer, Berechtigungen oder Änderungszyklen sprechen für getrennte Skills.

Zu starke Fragmentierung ist ebenfalls problematisch. Wenn Nutzer zwischen zehn fast identischen Skills nicht unterscheiden können, wurde Komplexität nur verschoben. Ein Katalog mit Zweck, Eigentümer, Status und unterstütztem Agenten hält die Bibliothek verständlich. Tests prüfen auch das Routing zwischen benachbarten Skills.

Skills können Expertenpraxis skalierbar machen. Ebenso können sie eine veraltete Regel maschinell verbreiten. Amplified Pi verbindet Prozessauswahl, technische Umsetzung, Evaluation und Lebenszyklus, damit Wiederverwendung mit Verantwortung wächst.