Mintlify erlaubt Teams, eigene Skills für den Docs-Agenten hochzuladen

So funktionieren eigene Skills

Ein Skill ist laut Mintlify ein Ordner mit einer SKILL.md-Datei im Zentrum, dazu kommen bei Bedarf Referenzdateien und Beispiele. Der Agent akzeptiert Ordner, .zip-Dateien, einzelne Skill-Dateien und .skill-Dateien, darunter auch solche, die aus Claude exportiert wurden.

Skills lassen sich auf zwei Ebenen hochladen. Persönliche Skills gelten nur für die eigenen Anfragen des Hochladenden. Org-Skills gelten für alle im Team, sodass ein einmal hochgeladener Styleguide jede Änderung des Agenten für jeden Nutzer prägt. Der Agent liest die Beschreibung jedes Skills und wählt den, der zur Anfrage passt.

Mintlify weist darauf hin, dass die Dokumentationen bereits einen generierten Skill unter /.well-known/skills/ veröffentlichen, damit externe Agenten ein Produkt anhand einer URL kennenlernen können. Eigene Skills funktionieren in die andere Richtung: Sie bringen dem Agenten von Mintlify bei, wie ein Team schreibt.

Was sich als Skill eignet

Mintlify empfiehlt, mit dem Feedback zu beginnen, das Reviewer bei jedem Pull Request wiederholen. Zu den Beispielen des Unternehmens zählen:

• Ein Styleguide-Skill, der Tonalität, Produktterminologie, Schreibweise von Überschriften und verbotene Wörter abdeckt.
• Ein Seitentyp-Skill, der festlegt, was eine Quickstart-Seite enthalten muss und wie sie sich von einer Referenzseite unterscheidet.
• Ein Changelog-Skill mit dem Eintragsformat und drei echten Einträgen, die das Team für gelungen hält.
• Ein Review-Skill, den der Agent vor dem Öffnen eines PR ausführt, mit Regeln, um unbelegte Behauptungen, fehlende Voraussetzungen und Schritte ohne erwartete Ausgabe zu erkennen.
• Ein API-Referenz-Skill für Parameterbenennung, Reihenfolge der Abschnitte und das Format von Fehlercodes.

Der Beitrag nennt außerdem Open-Source-Skills, die man forken und umschreiben kann. Dazu gehört documentation-writer im awesome-copilot-Repository von GitHub, der Seiten in die vier Diátaxis-Typen einordnet, sowie technical-writer, der Engineering-Dokumentation in getrennte Skills für Design-Dokumente, Changelogs, Runbooks und Postmortems aufteilt. Ebenfalls genannt werden no-ai-slop von Peter Yang, das mehr als 20 typische KI-Schreibmuster entfernt, brand-guidelines und internal-comms im Skills-Repository von Anthropic sowie documentation-and-adrs von Addy Osmani.

Mintlify rät, einen Skill vor dem Upload auf Org-Ebene zu lesen und seine Lizenz zu prüfen. Laut dem Beitrag steht no-ai-slop unter der MIT-Lizenz, während Skills, die den Leitfaden von Wikipedia adaptieren, womöglich dessen CC-BY-SA-Bedingungen tragen.

Einen Skill schreiben, der auch greift

Die Beschreibung entscheidet, wann ein Skill ausgeführt wird, so Mintlify, denn Agenten lesen vorab nur Name und Beschreibung jedes Skills. Das Unternehmen empfiehlt, Beschreibungen in den Worten zu verfassen, die Menschen tatsächlich eintippen, da „Helps with documents“ nie anspringt. Weitere Ratschläge aus dem Beitrag:

• Jeder Skill sollte nur eine Aufgabe haben, etwa das Changelog-Format getrennt vom Styleguide.
• Die zentrale SKILL.md sollte unter etwa 500 Zeilen bleiben; lange Inhalte wie eine vollständige Terminologieliste gehören in Referenzdateien.
• Beispiele statt Adjektive verwenden. Zwei Vorher-nachher-Umformulierungen lehren mehr als „sei klar und prägnant“.
• Am Ende eine Checkliste anfügen, die der Agent auf seinen eigenen Entwurf anwenden kann.

Die Beispielbeschreibung im Beitrag für einen Skill namens writing-changelogs besagt, er solle verwendet werden, wenn ein Changelog, Release Notes oder ein „What's new“-Eintrag verfasst werden soll oder wenn ein PR ein für Nutzer sichtbares Feature hinzufügt.

Einstieg und Verfügbarkeit

Um einen Skill hinzuzufügen, öffnet man die Skills-Seite der eigenen Organisation, klickt auf Add Skill, lädt einen Skill-Ordner, eine .zip- oder eine .skill-Datei hoch und legt fest, ob er persönlich oder organisationsweit gilt. Anschließend stellt man dem Agenten eine Aufgabe, die der Skill abdeckt, und prüft das Ergebnis anhand der Checkliste des Skills. Für unterstützte Formate und Limits verweist Mintlify auf seine Dokumentation.

Eigene Skills funktionieren überall dort, wo der Agent eingesetzt wird, wofür laut dem Beitrag ein Pro- oder Enterprise-Tarif nötig ist. Für Dokumentationsteams bedeutet das praktisch: Wiederkehrende Review-Kommentare lassen sich einmal festhalten und auf die Änderungen des Agenten anwenden, entweder für eine einzelne Person oder für die gesamte Organisation.