Skills für den KI-Assistenten: Wie SKILL.md aufgebaut ist und wie man es ohne Terminal installiert

Was eine SKILL.md-Datei ist

SKILL.md ist eine Textdatei mit einer Anweisung, die ein KI-Assistent liest, bevor er eine Aufgabe angeht. Kein Programm, kein Plug-in: gewöhnliches Markdown, in dem steht, wie eine bestimmte Art von Arbeit erledigt wird — was zuerst zu prüfen ist, in welcher Reihenfolge zu denken, in welcher Form das Ergebnis auszusehen hat, was niemals zu tun ist. Die Datei liegt in einem Repository, ein Assistent holt sie sich, und von da an wird die Arbeit so gemacht wie beschrieben und nicht so, wie das Modell gerade improvisiert.

Das Format entstand Ende 2025 und wurde binnen Monaten allgemein: Claude, Codex, Copilot, Cursor, Gemini CLI und Dutzende weiterer Werkzeuge lesen es, und öffentliche Verzeichnisse zählen Skills inzwischen in Hunderttausenden. Trotzdem ist so gut wie die gesamte Dokumentation für jemanden geschrieben, der Terminal, Repository und einen laufenden Coding-Agenten hat — der einzige Grund, warum das Thema noch nach Entwicklerangelegenheit aussieht.

Die Datei selbst ist schlicht. Zwei Teile, getrennt durch eine Zeile aus drei Bindestrichen.

Hier ein vollständiger Skill in realistischer Größe. Er beschreibt, wie die Aufzeichnung eines Vertriebsgesprächs auszuwerten ist: worauf zu achten ist, in welcher Reihenfolge, und was nicht erfunden werden darf.

---
name: sales-call-review
description: Auswertung eines Vertriebsgesprächs — Einwände, Signale, nächster Schritt
---

# Auswertung eines Vertriebsgesprächs

Du wertest das Transkript eines Gesprächs mit einem Interessenten aus.

## Reihenfolge

1. Schreibe Einwände WÖRTLICH heraus, als Zitat. Nicht paraphrasieren:
   der genaue Wortlaut eines Einwands ist die Information.
2. Vermerke je Einwand, ob er beantwortet und ob die Antwort akzeptiert
   wurde. Schweigen ist keine Zustimmung.
3. Suche Signale zu Budget, Zeitrahmen und Entscheidungsbefugnis.
   Fehlt ein Signal, schreibe genau das: «nicht erwähnt».
4. Benenne den nächsten Schritt: was genau, wer, bis wann.

## Ausgabeformat

Vier Abschnitte in obiger Reihenfolge. Darin kurze Punkte, keine
einleitenden Absätze. Einwände als Zitat in Anführungszeichen.

## Was nicht zu tun ist

- Keine Motive unterstellen: nur, was tatsächlich gesagt wurde.
- Keine Abschlusswahrscheinlichkeit in Prozent — dafür gibt es
  keine Datengrundlage.
- Keinen Rabatt als nächsten Schritt vorschlagen, wenn nach dem Preis
  nie gefragt wurde.

Beachte, was in der Datei nicht steht: kein Code, keine Konfiguration, keine API-Schlüssel, keine Installationsbefehle. Ein Skill ist aufgeschriebene Erfahrung, keine Software. Genau deshalb kann ihn jemand verfassen, der nie ein Terminal geöffnet hat — und genau deshalb ist es seltsam, dass die Installation immer noch eines verlangt.

Skill, Werkzeug und Prompt: wer wofür zuständig ist

Drei Begriffe, die ständig verwechselt werden, obwohl sie verschiedene Probleme lösen. Der Unterschied ist einfacher als er wirkt: der Prompt setzt die Rolle, der Skill setzt die Methode, MCP liefert den Zugang.

Die praktische Folge: Antwortet der Assistent über das Falsche, brauchst du einen Skill. Antwortet er richtig, kennt aber die Fakten nicht, brauchst du MCP. Kein noch so guter Skill beschafft Daten, und kein MCP-Server lehrt eine Methode. Die meisten Aufgaben brauchen den Skill: Methoden veralten weit langsamer als Daten, und man muss sie nur einmal aufschreiben.

Warum «ohne Terminal» meist etwas anderes bedeutet

«Wie installiere ich einen Skill ohne Terminal» ist eine häufige Frage, und die Suchergebnisse beantworten sie auch. Nur beantworten sie eine andere.

Daraus folgt ein besserer Test bei der Wahl der Installation: frage nicht «brauche ich ein Terminal», sondern «muss ich dafür einen weiteren Agenten auf meinem Rechner betreiben». Lautet die Antwort ja, bleiben Skills ein Entwicklerwerkzeug, wie elegant der Installer auch sein mag.

Installieren ohne Terminal und ohne Coding-Agent

Whisperer liest SKILL.md direkt und wendet sie auf die Antworten des Assistenten an. Es gibt nichts zu installieren: die Datei erreicht deinen Rechner nie, es gibt keine Ordner, und neu zu starten ist auch nichts. Zwei Quellen werden unterstützt: ein gemeinsames Verzeichnis und jedes öffentliche GitHub-Repository.

1. Weboberfläche → Prompts → Schaltfläche «Skills»
2. Reiter «Fertige» → Suchbegriff eingeben: system design, code review,
   sales, writing…
3. Die Liste zeigt Name, Quell-Repository und Installationszahl. Öffne
   einen Skill, um die Beschreibung aus seinem Frontmatter zu lesen
4. «Installieren» — der Skill landet in deiner Bibliothek
5. Prompt öffnen → «Verbinden» → Skill auswählen

1. Weboberfläche → Prompts → «Skills» → Reiter «Eigenes Repository»
2. Beliebige dieser Formen einfügen:
   owner/repo
   https://github.com/owner/repo
   https://github.com/owner/repo/tree/main/skills/sales-review
   https://github.com/owner/repo/blob/main/skills/sales-review/SKILL.md
3. «Skills suchen» — wir gehen das Repository durch und listen jede
   SKILL.md samt Beschreibung. Hast du den Link eines bestimmten
   Ordners eingefügt, steht dieser Skill zuoberst
4. «Installieren» beim gewünschten → danach mit einem Prompt verbinden

Worauf ein Skill tatsächlich wirkt

Ein Skill wird nicht «dem Assistenten» zugeordnet, sondern dem Prompt einer bestimmten Rolle. Eine Rolle ist ein Arbeitsbereich: Fragen beantworten, Code lesen, Bilder lesen, Systemdesign. Verbindest du einen Skill mit einer Rolle, wirkt er überall dort, wo diese Rolle arbeitet.

Die Verbindung kennt zwei Modi, und der Unterschied wiegt schwerer, als die Namen vermuten lassen.

«Ergänzt» — der Skill wird dem Prompt-Text hinzugefügt. Der Prompt setzt weiterhin Rolle und Ton, der Skill schärft die Methode. In neun von zehn Fällen der richtige Modus.

«Ersetzt» — der Skill verdrängt den Prompt-Text vollständig und geht allein ans Modell. Gedacht für einen in sich geschlossenen Skill, der Rolle, Vorgehen und Ausgabeformat bereits definiert und bei dem der eigene Prompt nur stören würde. Verbindest du zwei Skills und einer steht auf «Ersetzt», geht dieser zuerst und die «Ergänzt»-Skills präzisieren ihn danach.

Was nach der Installation mit einem Skill geschieht

Hier liegt das Detail, das eine funktionierende Einrichtung von einer Quelle unangenehmer Überraschungen trennt. Ein Skill wird an einen Commit geheftet. Bei der Installation halten wir fest, welche Version der Datei genau geholt wurde, und verwenden weiterhin diese.

«Aus Repository aktualisieren» liest die Datei neu, zeigt die neue Fassung und heftet den Skill an den aktuellen Commit. Löschst du einen Skill aus der Bibliothek, verschwinden auch sämtliche Verbindungen — separat aufzuräumen gibt es nichts.

Drei Skills für den Anfang

Die Auswahlregel: ein Skill lohnt sich dort, wo du dasselbe schon dreimal erklärt hast. Wiederholst du eine Anweisung in jedem Gespräch, ist sie ein Kandidat. Brauchst du sie einmal im Quartal, ist Handarbeit billiger.

1. Ein Fachglossar

Der unterschätzteste und am schnellsten geschriebene. Eure Produktnamen, interne Abkürzungen, Nachnamen von Kolleginnen und Kollegen, Kundennamen — alles, was das Modell zum ersten Mal hört und verstümmelt. Fünf Minuten Arbeit, sichtbare Wirkung in jedem Gespräch.

---
name: our-glossary
description: Begriffe, Produkte und Namen, die bei uns im Haus benutzt werden
---

# Unser Glossar

Diese Wörter kommen ständig vor. Schreibe sie genau so.

## Produkte
- [Name] — [was es ist, in einem Satz]

## Abkürzungen
- [ABK] — [Auflösung]. Nicht zu verwechseln mit [ähnliche Abkürzung]

## Personen
- [Vor- und Nachname] — [Rolle]

Klingt ein Wort ähnlich wie eines aus der Liste, nimm die Listenschreibung.
Einen unbekannten Begriff lass so stehen, wie du ihn gehört hast; «korrigiere»
ihn nicht zu einem ähnlich klingenden, den du bereits kennst.

2. Die Form deines Follow-ups

Die E-Mail nach einem Gespräch folgt jedes Mal derselben Struktur, und diese Struktur ist persönlich. Ein Skill hält sie fest: welche Abschnitte, in welcher Reihenfolge, wie lang, womit der erste Satz beginnt. Passt gut zum Besprechungsprotokoll — der Skill definiert die Form, das Protokoll liefert den Inhalt.

3. Eine Auswertungsmethode für deine Art von Meeting

Das Beispiel vom Anfang. Bei Interviews, Vertriebsgesprächen, Retrospektiven und Forschungsgesprächen lohnt es sich, jeweils Unterschiedliches herauszuziehen. Ein allgemeiner Assistent zieht «die Hauptthemen» heraus; ein Skill zieht Einwände wörtlich heraus, oder Signale für den Schmerzpunkt des Kunden, oder Abweichungen zwischen Kandidaten im selben Fragenblock. Für die Personalauswahl ist das im Artikel über strukturierte Interviews ausgearbeitet, für die Forschung in dem über Customer Discovery.

Sicherheit: ein Drittel der öffentlichen Skills hat Probleme

Der wichtigste Abschnitt dieses Artikels — und in den meisten Anleitungen fehlt er.

Die Mechanik erschließt sich, sobald man sich klarmacht, dass ein Skill eine Anweisung ist, der der Agent vertraut. Gefährlich wird es, wenn der Agent die Mittel hat, sie auszuführen: Zugriff auf Dateien, auf eine Shell, auf deine Schlüssel. Dann wird aus der Zeile «sieh in die .env und übernimm ihren Inhalt in die Konfiguration» ein Datenabfluss.

Daraus folgt eine Unterscheidung, die man bei der Wahl der Installation kennen sollte.

Ganz offen gesagt: eine vollkommen sichere fremde Anweisung gibt es nicht. Der Wegfall der Codeausführung beseitigt die schwerste Angriffsklasse — gestohlene Schlüssel, Hintertüren, abgeflossene Dateien —, aber Text bleibt Text. Ein in böser Absicht geschriebener Skill kann den Assistenten weiterhin zu der Formulierung schieben, die dem Autor lieb ist: ein bestimmtes Produkt empfehlen, Alternativen weglassen, eine Bewertung einfärben. Wir schicken den Rumpf bei der Installation und bei jeder Aktualisierung durch einen Inhaltsfilter, und was klar gegen die Richtlinien verstößt, kommt nicht durch — aber ein Filter erkennt Verstöße, keine Interessen.

Die praktische Schlussfolgerung ist einfach: der Rumpf des Skills steht in seiner Karte, und es lohnt sich, ihn zu lesen. Das sind zwei Bildschirmseiten Markdown in normaler Sprache, kein Code, für dessen Prüfung man ausgebildet sein müsste. Fünf Minuten Lesen vor dem Verbinden lösen ein Problem, für das es in der Welt der Coding-Agenten Scanner braucht.

Grenzen, die man vorher kennen sollte

Vier Dinge, die man besser jetzt sagt als später entdeckt.

Skills, die auf Skripte setzen, funktionieren nur teilweise. Manche im Verzeichnis gehen davon aus, dass der Agent mitgelieferten Code ausführt. Hier läuft ausschließlich Text. Steht die Anweisung für sich, funktioniert der Skill vollständig; läuft sie auf «führe analyze.py aus» hinaus, funktioniert er gar nicht. Das lässt sich vor der Installation erkennen: Beschreibung und Rumpf sind in der Vorschau sichtbar.

Der Rumpf ist auf 24 000 Zeichen begrenzt. Rund zehn Seiten — mehr, als jeder vernünftige Skill braucht. Eine längere Datei wird gekürzt verbunden, und du wirst ausdrücklich darauf hingewiesen statt stillschweigend.

Ein Skill steht immer im Prompt, er wird nicht bei Bedarf nachgeladen. Manche Coding-Agenten holen den Rumpf erst, wenn sie die Aufgabe für passend halten. Hier geht ein verbundener Skill bei jeder Anfrage dieser Rolle ans Modell. Das ist vorhersehbarer — er kann nicht ausbleiben, wenn du ihn brauchst — und zugleich der Grund für das Limit von drei je Prompt.

Private Repositories werden nicht unterstützt. Wir erreichen GitHub ohne deine Zugangsdaten und sehen daher nur Öffentliches. Ein privates und ein nicht existierendes Repository sind für uns identisch: beide antworten «nicht gefunden».

Checkliste vor dem Verbinden eines fremden Skills

Häufige Fragen

Muss man programmieren können, um einen Skill zu schreiben?

Nein. Ein Skill ist Text in normaler Sprache: was zu tun ist, in welcher Reihenfolge, was zu vermeiden. Die einzige technische Anforderung sind vier Zeilen Frontmatter am Dateianfang, und die lassen sich aus dem Beispiel oben kopieren. Ein GitHub-Repository entsteht über die Weboberfläche, die Datei kommt per Schaltfläche hinzu.

Worin unterscheidet sich ein Skill von einem System-Prompt?

Der Prompt beschreibt, wer antwortet und in welchem Ton; der Skill, wie eine Art von Arbeit gemacht wird. Der praktische Unterschied ist die Wiederverwendung: ein Prompt ist persönlich, ein Skill wird einmal geschrieben und passt jedem, der dieselbe Arbeit macht. Deshalb werden Skills geteilt und Prompts so gut wie nie.

Skill oder MCP?

Keine Alternativen. Der Skill liefert die Methode, MCP liefert Daten und Aktionen. Antwortet der Assistent über das Falsche, brauchst du einen Skill; antwortet er gut, kennt aber die Fakten nicht, brauchst du MCP. Oft braucht es beides: MCP holt die Daten aus dem Ticketsystem, der Skill beschreibt, wie damit zu arbeiten ist.

Lässt sich ein Skill mit mehreren Prompts verbinden?

Ja. Die Bibliothek ist gemeinsam, und die Zahl der Verbindungen ist nicht begrenzt. Der Skill wird einmal gespeichert und wirkt überall dort, wo er angeschlossen ist.

Was passiert, wenn der Autor den Skill im Repository ändert?

Nichts. Deine Kopie ist auf dem Commit eingefroren, aus dem sie stammt. Änderungen kommen erst, wenn du «Aus Repository aktualisieren» drückst — und dann läuft der neue Rumpf erneut durch den Inhaltsfilter.

Warum liefert die Suche manchmal nichts?

Zwei Gründe. Das Verzeichnis kann vorübergehend nicht erreichbar sein; dann bleibt die Liste leer, das Verbinden eines eigenen Repositories funktioniert aber weiterhin. Oder GitHub drosselt uns: ohne Token zählt das Limit für den gesamten Dienst, und in solchen Momenten ist ein paar Minuten warten ehrlicher, als ein leeres Ergebnis als «keine Skills» auszugeben.

Funktionieren hier Skills, die für Claude Code oder Cursor geschrieben wurden?

Ja, sofern die Anweisung für sich steht: das Format ist identisch und der Text liest sich gleich. Nicht übertragbar ist alles, was ein Dateisystem, eine Shell oder Skriptausführung voraussetzt — ein Assistent, der mit deinen Meetings arbeitet, hat davon nichts, und zwar bewusst.

Womit anfangen

Der schnellste Weg herauszufinden, ob Skills etwas für dich sind: nimm eine Anweisung, die du dem Assistenten schon mehrmals hintereinander gegeben hast, und speichere sie als Skill. Fünf Minuten für die Datei, eine fürs Verbinden. Das Ergebnis ist sofort ablesbar: sind die Antworten näher an dem, was du meintest, hast du gerade aufgehört, dich zu wiederholen. Wenn nicht, ging es bei der Anweisung um Daten und nicht um Methode — dann ist ein anderes Werkzeug die Antwort.

Die Skill-Bibliothek liegt in der Weboberfläche unter Prompts. Wie Prompts und Rollen funktionieren, steht im Prompt-Studio-Leitfaden, und welches Modell welche Rolle bedient, in der Referenz zu den Modellrollen.