Claude Code Skills im Jahr 2026: So baust du dir eine Skills-Bibliothek auf

Ailoot-Dokumentation: API, Schlüssel und Einrichtung.

Was ist ein Skill in Claude Code, und warum ist er nicht einfach „ein größerer Prompt“?#

Claude Code Skills sind eine native Claude-Code-Funktion, die Anthropic im Oktober 2025 für Pro/Max/Team/Enterprise eingeführt hat. Später veröffentlichte Anthropic die Spezifikation Agent Skills als Standard, der auch über Claude hinaus funktioniert. Im Code ist es einfach ein Ordner:

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

Jeder Ordner entspricht einem Skill. Die Datei SKILL.md ist eine Markdown-Datei mit YAML-Frontmatter am Anfang und gewöhnlichen Anweisungen darunter. Wenn ein Nutzer sagt: „Lass uns in der Produktion deployen“, sieht Claude die Beschreibung des Skills deploy-to-prod, erkennt den Auslöser „in der Produktion deployen“, lädt den Inhalt der SKILL.md in den Kontext und befolgt die Schritte.

Drei Stufen des progressiven Ladens

Anthropic hat Skills mit progressivem Laden entwickelt: Daten werden bei Bedarf schichtweise geladen. Im Anthropic-Engineering-Blog beschreibt Anthropic dies als das „zentrale Designprinzip, das Agent Skills flexibel und skalierbar macht“ (Anthropic Engineering).

Die drei Ladestufen:

1. Metadaten (immer) – Zu Beginn einer Sitzung sieht Claude nur den name und die description jedes Skills. Budget: etwa 100 Tokens pro Skill.
2. Anweisungen (bei Auslöser) – Wenn der Nutzer etwas Relevantes sagt, lädt Claude den Inhalt der SKILL.md. Budget: weniger als 5000 Tokens.
3. Ressourcen (auf Anfrage) – Mitgelieferte Dateien (Beispiele, Vorlagen, Datensätze) werden erst abgerufen, wenn das Modell selbst danach sucht. Budget: unbegrenzt.

Früher musste CLAUDE.md alles enthalten, woran sich die KI „erinnern“ sollte – und ein Projekt mit 50 Regeln stieß schnell an die Kontextgrenze. Mit Skills können Dutzende problemlos in einem Projekt nebeneinander bestehen, weil beim anfänglichen Laden nur ihre Beschreibungen in den Kontext gelangen.

Wo Skills liegen: vier Ebenen

Priorität: Enterprise überschreibt persönliche Einstellungen, persönliche Einstellungen überschreiben Projekteinstellungen. Plugins verwenden den Namensraum plugin-name:skill-name und stehen nicht in Konflikt. Das ist praktisch: Allgemeine berufliche Skills kannst du in ~/.claude/skills/ und projektspezifische im .claude/skills/-Ordner des Repositorys ablegen.

Was steckt in einer SKILL.md?#

Hier ein minimales Beispiel – zwanzig Zeilen, und der Skill ist einsatzbereit:

---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form video. Triggers - "make a post plan", "what should I post this week", "a 7-day channel plan". Do not activate if the request is about a website or email newsletter.
---

# Weekly Content Plan

## Steps

1. Read `knowledge/audience.md` - who we're writing for
2. Read `knowledge/tone-of-voice.md` - how we write
3. Read the last 10 posts in the channel - what has already been covered
4. Come up with 7 topics for the week: 3 sales-focused, 2 expert, 2 personal
5. For each, provide one hook line and three bullets about the post
6. Output as a table: day of the week | type | hook | plan

Das reicht. Wenn ein Nutzer schreibt: „Lass uns Beiträge für die Woche planen“, erkennt Claude den Auslöser in der Beschreibung, lädt die SKILL.md, liest die genannten Dateien und gibt eine Tabelle aus.

Was du beachten solltest: Grenzen

Die offizielle Claude-API-Dokumentation legt strenge Grenzen fest:

• name: bis zu 64 Zeichen, nur Kleinbuchstaben, Ziffern und Bindestriche, keine XML-Tags. anthropic und claude sind reserviert.
• description: in der API bis zu 1024 Zeichen; erforderlich, keine XML-Tags.
• Auflistungsbudget: In Claude Code belegen die Beschreibungen aller Skills zusammen etwa 1 % des Kontextfensters. Bei vielen Skills werden Beschreibungen gekürzt, und die Schlüsselwörter, die Claude zum Zuordnen braucht, können dabei verschwinden.
• Inhalt der SKILL.md: Anthropic empfiehlt, den Inhalt auf höchstens 500 Zeilen zu beschränken. Verschiebe längere Inhalte in Dateien unter references/, scripts/ und examples/ und lade sie über die Anweisungen.

Nach der Kontextkomprimierung (/compact) behält Claude die ersten 5000 Tokens jedes zuvor aufgerufenen Skills bei; das Gesamtbudget für alle erneut angehängten Skills beträgt 25 000 Tokens. Wenn ein Skill nicht hineinpasst, wird sein Verhalten „vergessen“.

Vollständiges Frontmatter-Schema

Verwende mindestens name und description. Skills für den produktiven Einsatz nutzen auch weitere Felder:

Das Feld disable-model-invocation: true ist für alles unverzichtbar, was nicht automatisch ausgeführt werden darf. Ein Skill deploy-to-prod mit dieser Einstellung kann zum Beispiel nur aufgerufen werden, wenn der Nutzer ausdrücklich /deploy-to-prod eingibt. Ohne diese Einstellung könnte Claude deployen, weil „der Code bereit aussieht“.

Warum macht die Beschreibung 90 % der Arbeit aus, und wie schreibt man eine?#

Der häufigste Fehler von Vibe-Codern ist eine Beschreibung wie „Hilfe für X“. Der Skill liegt zwar in seinem Ordner, aber Claude ruft ihn nicht auf.

Eine schlechte Beschreibung

description: Build dashboards.

Was Claude nicht erkennen kann: Geht es bei der Frage „Zeig mir die Umsätze der Woche“ um ein Dashboard oder nicht? Geht es bei der Frage nach einem „Umsatzdiagramm“ um ein Dashboard oder nur um ein Diagramm im Allgemeinen? Ist ein „Monatsbericht“ eindeutig kein Dashboard?

Anthropics eigener skill-creator formuliert die Empfehlung direkt:

Die Formel für eine gute Beschreibung

Drei Teile:

1. Was der Skill tut – ein Satz zum Ergebnis, nicht zum Vorgehen. Nicht „erstellt SQL“, sondern „exportiert Umsätze in eine Tabelle für einen Telegram-Kanal“.
2. Wann der Skill ausgelöst werden soll – 3–5 zitierte Phrasen, die Nutzer tatsächlich sagen. Nicht raten, sondern den Chat- und Supportverlauf ansehen.
3. Wann er NICHT ausgelöst werden soll – 1–2 Phrasen zu ähnlichen Aufgaben, auf die der Skill nicht reagieren soll. Ohne diesen Abschnitt geraten zwei ähnliche Skills immer wieder miteinander in Konflikt.

Ein Beispiel für eine starke Beschreibung aus meinem Projekt (vereinfacht und anonymisiert):

description: |
  Writes and publishes an SEO guide to the blog, following the editorial policy.
  Triggers: "write a guide about X", "let's make a new pillar",
  "a blog article about Y", "build a blog guide about Z".
  Do not activate if the request is about an email newsletter,
  a Telegram post, or an internal team instruction—
  those are other skills.

Was daran funktioniert:

• Das Verb „schreibt und veröffentlicht“ statt „hilft mit“ bezeichnet ein konkretes Ergebnis.
• Vier Auslöser-Phrasen in Anführungszeichen decken unterschiedliche Formulierungen ab.
• Auch ein englischer Auslöser ist enthalten – falls der Nutzer in die Teamsprache wechselt, funktioniert der Skill trotzdem.
• Ein eigener Abschnitt „nicht aktivieren, wenn“ verhindert Konflikte mit Skills für E-Mails und Beiträge.

So testest du eine Beschreibung

In seinem skill-creator hat Anthropic eine Methode für Auslöser-Evaluierungen eingebaut: 20 Prompts prüfen, ob ein Skill aktiviert wird. Zehn sollten ihn auslösen und zehn nicht – darunter knapp danebenliegende Fälle, bei denen die Formulierung ähnlich, aber die Aufgabe eine andere ist.

Für Vibe-Coder bedeutet das: Öffne nach dem Schreiben der Beschreibung einen leeren Chat und probiere fünf Formulierungen aus, die du wirklich verwendest, sowie drei ähnliche Formulierungen, die etwas anderes bedeuten. Wenn der Skill nicht aktiviert wird, obwohl er sollte, oder dort aktiviert wird, wo er es nicht sollte, überarbeite die Beschreibung. Erst danach schreibst du den Anweisungstext.

Welche 5 Skills würde ich zuerst installieren?#

Die ersten zwei Wochen damit zu verbringen, eigene Skills zu schreiben, ist eine schlechte Strategie. Beginne mit fertigen Skills und schau dir an, wie sie aufgebaut sind; danach kannst du nach demselben Muster eigene hinzufügen. Bewährte Sammlungen anderer zu übernehmen und für dich anzupassen, ist günstiger, als alles von Grund auf neu zu erstellen. Mit diesen fünf Sammlungen würde ich anfangen:

1. anthropics/skills – offizielle Sammlung mit skill-creator

Repository: github.com/anthropics/skills. 138,000 GitHub-Sterne. Sie enthält offizielle Skills des Anthropic-Teams: skill-creator (ein Meta-Skill, der andere Skills erstellt), claude-api (hilft beim Erstellen von API-Integrationen) und fertige Dokumenten-Skills für PowerPoint, Excel, Word und PDF.

Installation mit Claude Code:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Der größte Mehrwert ist skill-creator. Er erstellt anhand deiner Beschreibung eine SKILL.md, führt anschließend 20 Auslöser-Evaluierungen durch und überarbeitet die Beschreibung, bis der Skill in den passenden Situationen aktiviert wird. Im Grunde ist er „ein Skill zum Erstellen von Skills“.

2. mattpocock/skills – die virale Sammlung eines TypeScript-Experten

Die Sammlung umfasst 12 aktive Skills, darunter:

• grill-me – stellt Fragen entlang eines Entscheidungsbaums, bis die Unsicherheiten der Aufgabe ausgeräumt sind. Das größte Problem von Vibe-Codern – „Ich weiß nicht, was ich will“ – wird gleich bei der ersten Iteration angegangen.
• caveman – komprimiert die Kommunikation des Modells zu einem telegrammartigen Stil.
• diagnose – Debugging nach dem Zyklus Reproduktion – Minimierung – Hypothese – Instrumentierung – Behebung – Regressionstest.
• tdd – erzwingt Red-Green-Refactor: zuerst ein fehlschlagender Test, dann eine minimale Korrektur, danach Refactoring.
• to-issues – macht aus einem Plan vertikal aufgeteilte GitHub-Issues (Full-Stack, unabhängig bereitstellbar).

Installation:

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills – eine Sammlung für Marketer

Wenn du Online-Programme durchführst, freiberuflich als Marketer arbeitest oder eine Agentur leitest, musst du nicht sechs Monate damit verbringen, eigene Skills zu schreiben. Die Hälfte der Aufgaben ist bereits abgedeckt.

4. vercel-labs/agent-skills – Design ohne KI-Look

Repository: github.com/vercel-labs/agent-skills. Der Skill web-design-guidelines prüft UI-Code anhand von mehr als 100 Regeln zu Barrierefreiheit, Leistung und Benutzerfreundlichkeit.

Daneben gibt es Anthropics frontend-design mit mehr als 110,000 Installationen pro Woche. Der Skill sorgt dafür, dass die KI einen Stil auswählt, bevor sie mit dem Schreiben von Code beginnt. Ohne ihn verwendet jede von Claude erzeugte Seite die Schriftart Inter, einen violetten Farbverlauf und Rasterkarten. Das Ergebnis sieht bei allen gleich aus.

5. obra/superpowers – Multi-Agenten-Workflow

Wenn du die ersten drei Sammlungen dieser Liste installierst – anthropics/skills, mattpocock/skills und coreyhaines31/marketingskills –, verfügt dein Claude Code über Dutzende fertige Skills, die im ersten Monat die meisten Aufgaben eines Unternehmers abdecken.

Du möchtest nicht nur fertige Skills installieren, sondern auch ein Setup erstellen, das Claude wirklich zu deinem Assistenten macht? Skills sind eine der drei Säulen der Methode. Das funktionierende Setup besteht aus drei Teilen: KI-Klon (Skills als verpacktes Fachwissen) + Second Brain (eine Wissensstruktur für den Kontext) + Context Engineering (wie Claude das Projekt als Ganzes sieht). Dieses Setup macht aus Claude einen Assistenten, der nach deiner Logik denkt, statt zu raten.

Welche wiederkehrenden Aufgaben solltest du in einen Skill verwandeln?#

Bei der Arbeit an Kundenprojekten und den Projekten anderer ist mir dieses Muster Dutzende Male begegnet. Jemand hat „diese eine Sache, die er jedes Mal von Grund auf neu macht“. Jeden Montag schreibt die Person denselben Berichtstyp. Jedes Mal, wenn ein neuer Kunde dazukommt, durchläuft sie dasselbe Verfahren. Jede Veröffentlichung folgt derselben Vorlage. Und jedes Mal dauert es 30–90 Minuten, weil die Person sich die Schritte ins Gedächtnis rufen, die richtigen Dateien öffnen und den Claude-Prompt von Neuem formulieren muss.

Die Lösung ist, die Arbeit einmal in einem Skill zu bündeln. Danach sagst du eine einzige Formulierung, Claude lädt die Methode, liest die erforderlichen Quellen und erstellt das Ergebnis. Hier drei Beispiele aus verschiedenen Bereichen:

Beispiel 1. Freiberuflicher Marketer – Skill weekly-content-plan

Was manuell erledigt wird: Jeden Montag bereitet man Telegram-Beiträge für eine Woche und drei Kunden vor. Man öffnet den Leitfaden zur Markenstimme des Kunden, prüft die letzten Beiträge, denkt sich auf Grundlage des Produktkalenders Themen aus und erstellt eine Tabelle mit Aufhängern und Stichpunkten.

Als Skill wird daraus eine fünfstufige Anweisung: die Datei zur Tonalität des Kunden lesen, den Produktkalender lesen, die letzten 10 Beiträge auf Wiederholungen prüfen, sieben nach Typ aufgeteilte Themen entwickeln (verkaufsorientiert, fachlich, persönlich) und eine Tabelle ausgeben.

Mit dem Befehl „Lass uns die Beiträge für Kunde X für diese Woche planen“ wird aus einer Stunde Vorbereitung drei Minuten Wartezeit. Der Marketer prüft das Ergebnis, nimmt gezielte Änderungen vor und schickt es dem Kunden.

Beispiel 2. Ausgelagerte Buchhaltung – Skill monthly-receipts-close (Beispiel des Autors)

Was manuell erledigt wird: Jeden Monat exportiert man für jeden Kunden im Bestand den Kontoauszug, gleicht ihn mit den Zahlungen im Buchhaltungssystem ab, kennzeichnet nicht zugeordnete Zahlungen, erstellt einen vorläufigen Einnahmenbericht und vergleicht die Einnahmenstruktur mit dem Vormonat.

Der Skill besteht aus einer sechsstufigen Anweisung sowie ein paar Shell-Skripten im Ordner scripts/, die Kontoauszüge einlesen. Der Auslöser „Schließ Mai für Kunde X ab“ veranlasst Claude, in 4–5 Minuten einen Bericht mit gekennzeichneten Auffälligkeiten zu erstellen.

Beispiel 3. Anbieter eines Online-Programms – Skill welcome-letter-new-participant

Was manuell erledigt wird: Ein neuer Teilnehmer hat bezahlt, und man muss eine Willkommens-E-Mail schreiben. Eine gute Begrüßung ist persönlich: Sie berücksichtigt, über welchen Kanal der Teilnehmer kam, welches Produkt er gekauft hat, zu welcher Gruppe er gehört und welche Materialien mitgeschickt werden sollen. Eine Vorlage mit „Hallo, wir freuen uns“ leistet das nicht.

Der Skill weist Claude an, knowledge/audience.md zu lesen (wer diese Menschen sind), knowledge/products/<product>.md (was sie erhalten) und die letzten drei Willkommens-E-Mails (um Wiederholungen zu vermeiden). Anschließend schreibt Claude die E-Mail nach folgender Struktur: Aufhänger – Produktdetails – erste drei Schritte – Grußformel.

Viel schneller als die manuelle Arbeit. Die Qualität ist gleichmäßiger, weil Claude daran denkt, drei Quellen zu prüfen, während eine Person in Eile eine davon überspringt.

Was du NICHT in einen Skill verwandeln solltest

• Einmalige Aufgaben. Wenn du eine Aufgabe einmal im Jahr für die Steuererklärung erledigst, beschreibe sie einfach im Chat gegenüber Claude. Ein Skill lohnt sich nach 3+ Wiederholungen.
• Zu allgemeine Aufgaben. „Hilf mir beim Marketing“ ist kein Skill, sondern umfasst das gesamte Marketing. Ein Skill ist „ein wöchentlicher Inhaltsplan“ – eine bestimmte Handlung mit einem bestimmten Ergebnis.
• Aufgaben ohne wiederholbare Schritte. Wenn der Ablauf jedes Mal anders ist, handelt es sich nicht um einen Skill, sondern um einmalige Arbeit.

Wie erstellt Skill Creator Skills für dich?#

Der Haken: Es ist schwer, gleich beim ersten Versuch einen guten Skill zu schreiben. Eine Beschreibung ist oft zu eng oder zu weit gefasst, verfehlt die tatsächlichen Formulierungen der Nutzer oder steht mit einem benachbarten Skill in Konflikt. Anthropic hat darauf mit der Veröffentlichung von skill-creator reagiert, einem Meta-Skill, der andere Skills erstellt.

Nach der Installation von anthropics/skills sagst du zu Claude /skill-creator (oder einfach „Lass uns einen Skill für den Wochenbericht erstellen“) und folgst einem sechsstufigen Ablauf:

1. Entwurf – skill-creator stellt Fragen: Was soll der Skill tun, welche Auslöser-Phrasen sollen verwendet werden, welche Quellen soll er lesen und welche Schritte befolgen? Das Ergebnis ist die erste Version der SKILL.md.
2. Test – skill-creator erstellt 20 Test-Prompts: 10, die den Skill auslösen sollten, und 10, die wie Auslöser klingen, ihn aber nicht auslösen sollten (knapp danebenliegende Fälle).
3. Bewertung – jeder Prompt wird in einem frischen Chat ausgeführt, und es wird geprüft, ob der Skill aktiviert wurde. Wird er aktiviert, obwohl er es nicht sollte, oder wird er nicht aktiviert, obwohl er es sollte, kennzeichnet das Tool das Ergebnis.
4. Überarbeitung – anhand der Fehler wird die Beschreibung neu geschrieben und die Tests werden erneut ausgeführt.
5. Optimierung – der letzte Feinschliff: Es wird geprüft, ob die Grenze von 1024 Zeichen überschritten wird und ob es Konflikte mit vorhandenen Projekt-Skills gibt.
6. Paketierung – die fertige SKILL.md und die Referenzdateien werden in der richtigen Struktur gebündelt.

In der Praxis sieht das so aus: Du sprichst 15–20 Minuten mit Claude, beantwortest 7–8 Rückfragen und erhältst am Ende einen fertigen, getesteten Skill, der auf die richtigen Auslöser reagiert.

Ein weiterer Vorteil: skill-creator zeigt beispielhaft, wie man eine SKILL.md schreibt. Du kannst die eigene Datei öffnen und dir Format, Ton und Aufbau der Schritte ansehen. Das Tool führt vor, was es selbst lehrt – beim Lesen lernst du, eigene Skills zu schreiben.

Skills, CLAUDE.md, Subagenten, MCP, Hooks: Was solltest du verwenden?#

Das häufigste Problem in den Projekten, die ich geprüft habe: In CLAUDE.md stehen zugleich Projektrichtlinien, schrittweise Veröffentlichungsanweisungen, eine Commit-Vorlage und eine Datenbankbeschreibung. Das überlastet den Kontext und funktioniert in der Praxis nicht: Claude führt die Anweisung „wenn der Nutzer um eine Veröffentlichung bittet“ nicht aus, weil das Modell den gesamten Inhalt von CLAUDE.md als allgemeinen Kontext ohne explizite Auslöser behandelt.

Die Lösung: Jedes Element dem passenden Grundbaustein zuordnen:

In Alex Ops Rezension der Claude-Code-Grundbausteine („Understanding Claude Code's Full Stack“) lässt sich das Bild auf eine einfache Logik reduzieren: Skills und MCP decken die meisten Abläufe ab; Hooks automatisieren Routineaufgaben wie Codeprüfungen, Tests und Schutzvorkehrungen. Subagenten sind nötig, wenn der Kontext umfangreich wird. Der häufigste Fehler ist, einen Subagenten zu erstellen, obwohl ein Skill gebraucht wird.

Entscheidungsbaum

Wenn du denkst: „Ich brauche Claude für X“:

1. Wird dieses Wissen ständig benötigt? Zum Beispiel: „Das Projekt hat eine festgelegte Sprache“ oder „Wir verwenden keine Gedankenstriche.“ → In CLAUDE.md ablegen.
2. Ist es ein durch einen Auslöser gestarteter Ablauf, den du bisher manuell ausführst? Zum Beispiel: „Ich schreibe jeden Montag einen Bericht.“ → Einen Skill erstellen.
3. Brauchst du Zugriff auf ein externes System? Zum Beispiel auf die Stripe-API oder dein CRM. → Einen MCP-Server verbinden.
4. Soll Claude Code automatisch auf ein Ereignis reagieren? Zum Beispiel nach jedem Edit einen Linter ausführen. → Einen Hook schreiben.
5. Ist die Aufgabe umfangreich, verbraucht sie den gesamten Kontext und musst du parallel noch etwas anderes erledigen? → In einem Subagenten ausführen.

90 % der Aufgaben eines Unternehmers, der mit Vibe-Coding arbeitet, fallen in die Kategorien 1–3. Hooks und Subagenten sind fortgeschrittene Werkzeuge für den nächsten Schritt, wenn du mehr als „eine Aufgabe nach der anderen“ erledigst.

Slash-Befehle und Skills sind dasselbe

Eine wichtige Änderung in Claude Code: Das alte Slash-Befehlssystem (.claude/commands/) und Skills sind praktisch zusammengeführt worden. Die Datei .claude/commands/deploy.md und die Datei .claude/skills/deploy/SKILL.md erstellen beide einen Befehl /deploy. Stimmen die Namen überein, hat der Skill Vorrang. Wenn du also noch das alte Slash-Befehlsformat verwendest, wechsle zu Skills. Die Syntax ist klarer und es gibt mehr Funktionen.

7 Fehler, die einen Skill am Funktionieren hindern#

1. Eine Beschreibung ohne Auslöser: Der Skill wird nicht aktiviert

Symptom: Du hast einen Skill geschrieben, den Aufbau geprüft, alles ist gültig, aber Claude ruft ihn bei Nutzeranfragen nicht auf. Die Ursache ist fast immer dieselbe: eine Beschreibung wie „Hilfe beim Schreiben von Inhalten“. Claude weiß nicht, auf welche Formulierungen es reagieren soll. Abhilfe: Füge 3–5 tatsächliche Formulierungen von Nutzern direkt in Anführungszeichen in die Beschreibung ein.

2. SKILL.md mit mehr als 500 Zeilen: Die Aufmerksamkeit lässt nach

Anthropic empfiehlt ausdrücklich, den Dateiinhalt auf höchstens 500 Zeilen zu beschränken. Sind deine Anweisungen 2,000 Zeilen lang, verliert Claude den Fokus, befolgt Schritte nur teilweise und bringt deren Reihenfolge durcheinander. Abhilfe: Verschiebe große Abschnitte in nahegelegene Dateien unter examples/, references/ oder scripts/ und verweise in der SKILL.md darauf.

3. Ein Skill für „alles rund um Inhalte“ statt drei kleinen Skills

Eine verlockende Lösung: ein großer Skill content mit Telegram-Beiträgen, Landingpages und E-Mails. Das funktioniert nicht. Der Skill wird bei den falschen Anfragen aktiviert, vermischt Methoden und liefert ein gemitteltes Ergebnis. Abhilfe: Ein Skill entspricht einer wiederholbaren Handlung. Hast du tatsächlich drei Routinen rund um „Inhalte“, erstelle drei Skills: telegram-post, landing-section, email-broadcast.

4. Ein Skill ohne Abschnitt „Wann NICHT verwenden“: Konflikte

Symptom: Im Projekt gibt es zwei ähnliche Skills, und Claude ruft den falschen auf. Ein Skill behandelt etwa E-Mail-Newsletter, ein anderer speziell Willkommens-E-Mails für Teilnehmer eines Programms. Ohne eine ausdrückliche Klausel „nicht aktivieren, wenn die Anfrage einen allgemeinen E-Mail-Verteiler betrifft“ wird der Skill für Willkommens-E-Mails bei jeder Erwähnung von „E-Mail“ ausgelöst. Abhilfe: Formuliere die negativen Fälle ausdrücklich in der Beschreibung.

5. 50 Skills in einem Projekt: Beschreibungen werden gekürzt

Aus der Claude-Code-Dokumentation:

Wenn du 50 Skills-Sammlungen von einem Marketplace herunterlädst, werden einige Beschreibungen gekürzt. Die Schlüsselwörter, auf die du gesetzt hast, könnten verschwinden. Abhilfe: Behalte die 10–15 nützlichsten Skills im aktiven Projekt. Bewahre den Rest in einem inaktiven Archiv außerhalb aller durchsuchten Skillverzeichnisse auf, etwa in einem eigenen Ordner skill-archive/ bei deinen Materialien. Installiere nur benötigte Skills im Projekt- oder persönlichen Bereich. ~/.claude/skills/ ist eine installierte, projektübergreifend sichtbare Bibliothek. Ein Verschieben dorthin entfernt Skills nicht aus der Erkennung.

6. Skills aus ungeprüften Quellen: Sicherheitsrisiko

Anthropic warnt davor in der offiziellen Dokumentation:

Ein beliebiges GitHub-Repository könnte einen Skill enthalten, der deine API-Schlüssel beim ersten Aufruf offenlegt. Abhilfe: Öffne die SKILL.md und lies sie selbst, bevor du den Skill installierst. Führe Skills von unbekannten Autoren nicht in wichtigen Projekten aus.

7. Ein Skill ohne Wissensordner liefert „durchschnittliches ChatGPT“

Das subtilste und häufigste Anti-Pattern: Ein Skill ist eine Methode, aber ohne Kontext bedeutet die Methode nichts. Schreibst du einen Skill für „eine Willkommens-E-Mail erstellen“, aber im Projekt gibt es weder eine Datei über die Zielgruppe noch eine Datei zur Markenstimme, schreibt Claude eine durchschnittliche ChatGPT-E-Mail, die nicht von denen anderer zu unterscheiden ist.

Ein Skill funktioniert am besten, wenn du das Second Brain des Projekts bereits nach den Prinzipien im Leitfaden zu CLAUDE.md aufgebaut hast. Erstelle zuerst die Wissensstruktur und danach die Skills, die darauf angewiesen sind. Machst du es andersherum, erhältst du routinemäßige Durchschnittsqualität statt personalisierter Arbeit in deinem Stil.

So erstellst du deinen ersten Skill in 30 Minuten#

Hier ist der konkrete Plan, nach dem ich die ersten Skills in meinen Projekten erstellt habe:

Schritt 1. Eine wiederholbare Handlung auswählen

Öffne deinen Kalender für den vergangenen Monat. Finde eine Aufgabe, die du mindestens 4–5 Mal erledigt hast und die jedes Mal 30–60 Minuten dauert. Nicht ein allgemeines „Marketing“, sondern etwas Konkretes: „Montagsbericht zu Verkäufen“, „Einarbeitung eines neuen Kunden“ oder „Aktualisierung der Preisliste für eine Werbeaktion“.

Je enger die Formulierung, desto einfacher der Skill und desto eindeutiger der Auslöser.

Schritt 2. Den Ablauf von Hand aufschreiben

Schreibe die Schritte, die du ausführst, in eine separate Datei oder einen Chat mit Claude (nicht für den Skill, sondern als Entwurf):

1. Open the client database
2. Filter by status "awaiting welcome email"
3. Check which channel the client came from
4. Get the email template for that channel from the "templates" folder
5. Fill in the name, product, and start date
6. Send

Das ist noch kein Skill, sondern eine Notiz. Ohne diese Notizen gerätst du beim Schreiben der SKILL.md jedoch von Anfang an durcheinander.

Schritt 3. Die Ordnerstruktur erstellen

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Wenn du den Skill projektübergreifend verwenden möchtest, legst du ihn in ~/.claude/skills/ ab.

Schritt 4. Die SKILL.md nach der Vorlage schreiben

Grundgerüst:

---
name: welcome-email-new-client
description: |
  Prepares a welcome email for a new client using the template for their acquisition channel.
  Triggers: "write a welcome email for new client X",
  "onboard new participant Y", "welcome email for client from channel Z".
  Do not activate if the request is about a general mailing list
  or an email campaign—those are other skills.
---

# Welcome Email for a New Client

## Steps

1. Read `knowledge/audience/segments.md` - what client segments we have
2. Read `knowledge/templates/welcome/` - templates by channel
3. Identify the client's channel from the request context
4. Insert the client's name, product name, and start date
5. Check the length—it should be no more than 800 characters
6. Output the final email text in a copy-ready format

## Important

- Do not use “dear friend” or “hello”—use natural speech
- One paragraph, one idea
- End with one call to action, not two

Schritt 5. Mit 5–8 Prompts testen

Öffne in diesem Projekt einen leeren Chat mit Claude Code. Probiere fünf Formulierungen aus, die du tatsächlich verwendest, sowie drei ähnliche, die den Skill nicht auslösen sollten:

Sollten auslösen:

• “Write a welcome email for new client Ivanov”
• “Onboard a new participant who bought program X”
• “Welcome email for a client from Instagram”

Sollten nicht auslösen:

• “Send a promotion email to the whole list”
• “Email campaign for the New Year holidays”
• “Write a follow-up to a client who hasn't paid”

Prüfe für jede Formulierung, ob der Skill aktiviert wurde. Wird er in den falschen Fällen aktiviert, schränke die Beschreibung ein. Wird er in den passenden Fällen nicht aktiviert, erweitere die Auslöser-Phrasen.

Schritt 6. Die Beschreibung überarbeiten

Ändere nach jedem fehlgeschlagenen Test nur die Beschreibung – nicht den Anweisungstext. Nach 2–3 Überarbeitungen wird der Skill zuverlässig aktiviert. Speichere und committe ihn, dann verwendest du ihn jeden Tag.

Letzter Rat: Versuche nicht, deinen ersten Skill perfekt zu machen. Bring ihn zum Funktionieren. Den Feinschliff erledigst du nach deinem fünften oder zehnten Skill, wenn du Muster in deinen Formulierungen und in Claudes Antworten erkennst.

Wähle für diese Woche eine wiederkehrende Aufgabe aus deinem Kalender, nimm dir 30 Minuten Zeit und befolge die sechs Schritte oben. Dann arbeitet Claude nach deiner Methode, statt zu raten.

Das funktionierende Setup lautet KI-Klon + Second Brain + Context Engineering. Drei Teile einer gemeinsamen Methode.

Wenn du über Ailoot auf KI-Modelle zugreifen möchtest, sieh dir Ailoot an.