SKILL.md erklärt: Warum eine einzige Datei deine KI-Nutzung komplett verändert
Eine SKILL.md ist eine Textdatei im Markdown-Format, die einer KI genau sagt, wie sie eine Aufgabe erledigen soll. Einmal geschrieben, arbeitet die KI bei jeder Anfrage nach denselben Regeln.
Die meisten Menschen prompten KI wie ein Gespräch.
Frage rein, Antwort raus, nicht zufrieden, nochmal nachbessern, wieder nicht zufrieden, nochmal von vorne und nach 45 Minuten und acht Versuchen hat man einen Text, der halbwegs passt.
Das Problem ist nicht die KI. Das Problem ist, dass du bei jeder Anfrage von null anfängst. Die KI weiß nicht, wer du bist, wie du schreibst, für wen du schreibst und welche Qualitätsstandards du hast. Also rät sie und liegt meistens daneben.
Die Lösung heißt SKILL.md. Eine einzige Datei, die alles enthält, was die KI über deine Arbeit wissen muss. Einmal geschrieben, bei jeder Anfrage automatisch aktiv. Kein Rätselraten mehr, kein Nachbessern, keine acht Versuche.
Was ist eine SKILL.md?
Eine SKILL.md ist eine strukturierte Textdatei im Markdown-Format, die einer KI präzise Anweisungen gibt. Sie definiert: Was soll die KI tun? Für wen? In welchem Stil und mit welchen Qualitätsregeln und was darf sie auf keinen Fall?
Stell dir eine SKILL.md vor wie ein Briefing, das du einem neuen Mitarbeiter gibst. Nicht bei jedem Auftrag, sondern einmalig: “So arbeiten wir hier. Das sind unsere Standards. Das sind die Fehler, die du vermeiden musst.” Danach reicht ein kurzer Auftrag — der Mitarbeiter weiß, was zu tun ist.
Genau so funktioniert eine SKILL.md für KI-Modelle wie Claude, ChatGPT oder Gemini.
Warum Prompts allein nicht reichen
Ein Prompt ist eine einzelne Anweisung. “Schreib mir einen Blog-Artikel über KI-Agenten.” Die KI hat keine Ahnung, ob du einen 500-Wörter-Listicle oder einen 2.000-Wörter-Tiefgang willst. Ob locker oder formell. Ob für Einsteiger oder Experten, also entscheidet sie selbst und du korrigierst hinterher.
Mit einer SKILL.md sind all diese Informationen bereits hinterlegt. Der Prompt reduziert sich auf: “Schreib einen Artikel zu KI-Agenten.” Die KI kennt deine Zielgruppe, deinen Schreibstil, deine Mindestlänge und deine verbotenen Formulierungen. Ein Versuch, fertiges Ergebnis.
Der Unterschied ist nicht marginal. Er ist der Unterschied zwischen 45 Minuten und 5 Minuten pro Text. Zwischen “geht so” und “kann ich so veröffentlichen”.
Wie ist eine SKILL.md aufgebaut?
Jede SKILL.md besteht aus fünf Bausteinen. Du brauchst kein technisches Wissen, um sie zu schreiben, es ist reiner Text.
Baustein 1: Metadaten
Am Anfang steht der Name und eine kurze Beschreibung. Das hilft dir, den Überblick zu behalten, wenn du mehrere SKILL-Dateien hast.
---
name: blog-artikel-schreiber
description: Schreibt SEO-optimierte Blog-Artikel für Medium
---
Baustein 2: Ziel und Zielgruppe
Was soll die KI erreichen und für wen? Je konkreter, desto besser. “Schreibe gute Texte” ist zu vage. “Schreibe Blog-Artikel, die auf Seite 1 bei Google ranken, für Selbstständige im DACH-Raum” ist ein klares Ziel.
Baustein 3: Ablauf
Die Schritte, die die KI in welcher Reihenfolge abarbeiten soll. Nummeriert, klar, ohne Interpretationsspielraum. Bei einem Blog-Artikel wäre das: Keyword einbauen → Titel formulieren → Artikel strukturieren → FAQ anhängen → CTA einfügen.
Baustein 4: Stil-Regeln
Wie soll die Ausgabe klingen? Hier definierst du deinen Schreibstil: Satzlänge, Tonalität, Fachsprache ja oder nein, Du oder Sie. Das ist der Baustein, der dafür sorgt, dass Texte nach dir klingen — nicht nach generischer KI.
Baustein 5: Anti-Patterns
Das ist der wichtigste Baustein, den die meisten weglassen. Anti-Patterns definieren, was die KI nicht tun darf. Keine Floskeln wie “es ist wichtig zu beachten”. Keine erfundenen Quellen. Keine Absätze, die mit “Zusammenfassend lässt sich sagen” beginnen. Die Anti-Pattern-Liste ist dein Qualitätsfilter.
Eine SKILL.md schreiben Schritt für Schritt
Du brauchst dafür 30 Minuten und einen Texteditor. Mehr nicht.
Schritt 1: Öffne einen beliebigen Texteditor (Notepad, VS Code, sogar die Notizen-App auf deinem Handy). Erstelle eine neue Datei und nenne sie blog-skill.md.
Schritt 2: Kopiere dieses Grundgerüst:
---
name: [dein-skill-name]
description: [was dieser Skill macht]
---
# Ziel
[Was soll die KI erreichen?]
# Zielgruppe
[Für wen schreibst du?]
# Ablauf
1. [Erster Schritt]
2. [Zweiter Schritt]
3. [Dritter Schritt]
# Stil
- [Tonalität]
- [Satzlänge]
- [Ansprache]
# Anti-Patterns
- Niemals: [Formulierung 1]
- Niemals: [Formulierung 2]
Schritt 3: Füll die Platzhalter mit deinen konkreten Anforderungen. Denk an die letzten 5 Texte, die du mit KI geschrieben hast. Was musstest du jedes Mal korrigieren? Genau das gehört in die Anti-Patterns.
Schritt 4: Teste den Skill. Gib der KI die SKILL.md als Kontext und einen kurzen Auftrag. Wenn das Ergebnis nicht passt, justiere die Regeln und nicht den Prompt.
Wo setzt du eine SKILL.md ein?
Eine einzige gut geschriebene SKILL.md ist kein Einmalprojekt. Sie funktioniert überall, wo du KI für Text, Kommunikation oder Automatisierung einsetzt:
Blog-Artikel — Die SKILL.md steuert Länge, SEO-Struktur, Tonalität und CTA. Jeder Artikel folgt deinem Standard.
Social-Media-Posts — Gleicher Stil, ob LinkedIn, Instagram oder Threads. Die KI kennt deine Hooks, deine Hashtag-Strategie und deine Zielgruppe.
E-Mail-Kampagnen — Konsistente Kundenansprache über Newsletter, Outreach und Support-Mails.
Buchkapitel — Einheitlicher Schreibstil über 200+ Seiten, ohne dass sich Kapitel 12 anders liest als Kapitel 3.
KI-Agenten — SKILL.md-Dateien sind das Herzstück jedes KI-Agenten. Sie definieren, wie der Agent denkt, entscheidet und kommuniziert.
Das Prinzip: Einmal dein Briefing schreiben, überall denselben Standard bekommen.
Drei Beispiel-SKILLs für den sofortigen Einsatz
Beispiel 1: LinkedIn-Post-Skill
---
name: linkedin-post
description: Schreibt LinkedIn-Posts mit hoher Reichweite
---
# Ziel
Erstelle einen LinkedIn-Post, der Engagement erzeugt
und auf einen Blog-Artikel verlinkt.
# Ablauf
1. Hook: Provokante erste Zeile, die zum Weiterlesen zwingt
2. 3-4 Absätze mit konkretem Mehrwert
3. CTA: Link im Kommentar ankündigen
4. 3-5 Hashtags am Ende
# Stil
- Ich-Perspektive, direkt, ohne Floskeln
- Kurze Absätze (max. 2 Zeilen)
- Kein Emoji-Overload (max. 0-1 Emoji)
# Anti-Patterns
- Kein "Ich freue mich, mitteilen zu dürfen"
- Kein "Was denkt ihr?" als Frage ohne echtes Interesse
- Keine Aufzählungspunkte mit Emoji-Prefix
Beispiel 2: E-Mail-Antwort-Skill
---
name: email-antwort
description: Beantwortet Kundenanfragen professionell und schnell
---
# Ziel
Erstelle eine Antwort-E-Mail, die die Frage
in maximal 5 Sätzen beantwortet.
# Stil
- Freundlich aber knapp
- Du-Ansprache
- Kein Smalltalk
# Anti-Patterns
- Kein "Vielen Dank für Ihre Nachricht"
- Kein "Zögern Sie nicht, uns zu kontaktieren"
Beispiel 3: Marktrecherche-Skill
---
name: marktrecherche
description: Erstellt eine strukturierte Marktanalyse
---
# Ziel
Analysiere einen Markt oder ein Thema und liefere
einen strukturierten Report.
# Ablauf
1. Marktgröße und Wachstum
2. Top 5 Wettbewerber mit Stärken/Schwächen
3. Chancen für den DACH-Markt
4. Konkrete Handlungsempfehlung
# Stil
- Faktenbasiert, keine Spekulation
- Zahlen und Quellen wo verfügbar
- Maximal 800 Wörter
FAQ — Häufig gestellte Fragen
Brauche ich technische Kenntnisse, um eine SKILL.md zu schreiben? Nein. Es ist reiner Text im Markdown-Format. Wenn du eine E-Mail schreiben kannst, kannst du eine SKILL.md schreiben.
Funktioniert SKILL.md mit jedem KI-Modell? Ja. Die SKILL.md funktioniert mit Claude, ChatGPT, Gemini und jedem anderen Sprachmodell. Du gibst die Datei als Kontextanweisung mit, wie genau, hängt vom Tool ab: Bei Claude als Teil der System-Anweisung oder im Gespräch, bei ChatGPT als Custom Instruction oder direkt im Chat.
Wie viele SKILL-Dateien brauche ich? Starte mit einer. Eine SKILL.md für deine häufigste Aufgabe, wahrscheinlich Texte schreiben. Wenn die funktioniert, erstellst du weitere für andere Bereiche. Ich arbeite aktuell mit 8 verschiedenen SKILL-Dateien.
Was ist der Unterschied zu Custom Instructions oder GPTs? Custom Instructions und GPTs sind plattformgebunden, sie funktionieren nur bei ChatGPT. Eine SKILL.md ist universell. Du kannst dieselbe Datei bei Claude, ChatGPT, Gemini oder einem lokalen Modell verwenden und sie ist versionierbar. Du kannst Änderungen nachverfolgen und ältere Versionen wiederherstellen.
Kann ich mit SKILL-Dateien auch Geld verdienen? Ja. Gut geschriebene SKILL-Dateien für spezifische Nischen lassen sich als digitale Produkte verkaufen, auf Gumroad, Elopage oder im eigenen Shop. Ein “Content-Creator SKILL Pack” für 19,99 Euro, das sofort einsetzbare SKILLs für Blog, Social Media und Newsletter enthält, hat einen klaren Marktwert.
Nächster Schritt
Öffne jetzt einen Texteditor. Kopiere das Grundgerüst aus diesem Artikel. Füll es mit deinen Anforderungen. Teste es. In 30 Minuten hast du eine SKILL.md, die deine KI-Nutzung dauerhaft verändert.
Wenn du tiefer einsteigen willst: In meinem Buch SKILL.md, das Handbuch für KI-Anweisungen zeige ich dir fortgeschrittene Techniken und mehrstufige SKILLs, Quality Gates, Agent-Orchestrierung und die komplette SKILL-Architektur.
Bruno Treichel ist KI-Systemarchitekt und Gründer von KI-REX Media & Marketing Solutions. Er hat das SKILL.md-Konzept für den deutschsprachigen Markt entwickelt und setzt es in über 15 Buchprojekten und Dutzenden KI-Agenten ein.
Mehr auf ki-rex.de
Tags für Medium: Artificial Intelligence, Prompt Engineering, Productivity, Tech, KI
