Claude Code Skills: Dein eigenes Ökosystem in 30 Minuten

Claude Code Skills sind wiederverwendbare Instruktionspakete die Claude (den AI-Assistenten) für spezifische Aufgaben trainieren. Statt jedes Mal einen langen Prompt zu schreiben der erklärt was du willst und wie du es willst, packst du diese Instruktionen in einen Skill — einmal erstellt, immer wieder nutzbar.

Denk an Skills wie an Rezepte in einem Kochbuch. Jedes Mal wenn du „Mach mir Carbonara" sagst, schlägt Claude das Rezept auf und folgt den Schritten — statt jedes Mal von dir erklärt zu bekommen was Carbonara ist.

Merksatz: „Skills sind Lego-Steine. Allein nutzlos, zusammen ein System."

Was sind Claude Code Skills?

Ein Skill besteht aus einer Markdown-Datei (SKILL.md) die Claude sagt: Was ist die Aufgabe? Wann soll der Skill aktiviert werden? Welche Schritte sind zu befolgen? Welche Qualitätsstandards gelten?

Skills vs. Prompts — der Unterschied

Ein Prompt ist eine einmalige Anweisung: „Schreibe mir einen SEO-Artikel über Keyword-Recherche."

Ein Skill ist ein System von Anweisungen: „Wenn ich sage ‚Artikel schreiben', dann: Prüfe erst die Keyword-Map, nutze den SEO-Schreibstil-Standard, baue eine FAQ mit Schema-Markup ein, erstelle Merksätze, verlinke intern auf 5+ Artikel, und formatiere nach dem while.chat Template."

Der Prompt macht einmal was du sagst. Der Skill macht jedes Mal was du meinst — mit gleichbleibender Qualität, unabhängig davon wie detailliert dein Prompt ist.

Das Lego-Prinzip

Skills werden mächtig wenn sie zusammenarbeiten. Ein einzelner Skill „SEO-Artikel schreiben" ist nützlich. Ein Ökosystem aus Skills — SEO-Recherche, Content-Writer, Fakten-Checker, Konsistenz-Prüfung, Deployment — ist ein Workflow der Agentur-Qualität liefert.

Jeder Skill ist ein Baustein. Du kombinierst sie je nach Aufgabe. Für einen neuen Blogartikel: Content-Writer + SEO-Schreibstil + Fakten-Checker. Für ein Kundenprojekt: Web-Analyzer + Audit-Report + Pitch-Deck.

Warum Skills dein Vibe Coding transformieren

Ohne Skills bist du ein Solist der jedes Mal improvisiert. Mit Skills hast du eine Band die nach Noten spielt — und trotzdem improvisieren kann.

Konsistenz: Jeder Output folgt denselben Standards. Dein 50. Artikel hat dieselbe Qualität wie dein 1. — weil der Skill die Qualitätskriterien enthält.

Geschwindigkeit: Statt 200-Wort-Prompts zu schreiben, reicht ein Satz: „Schreib den nächsten Artikel aus dem Redaktionsplan." Der Skill weiß den Rest.

Wissensspeicher: Deine Best Practices, Lessons Learned und Qualitätsstandards sind im Skill gespeichert — nicht in deinem Kopf. Das Wissen geht nicht verloren wenn du einen langen Tag hattest.

Skalierung: Ein guter Skill funktioniert für 1 Artikel genauso wie für 50. Du skalierst ohne zusätzlichen Aufwand.

Deinen ersten Skill erstellen — Step by Step

Schritt 1 — SKILL.md Datei anlegen

Erstelle eine Datei SKILL.md in einem Ordner unter .claude/skills/ in deinem Projektverzeichnis.

Ordnerstruktur:

dein-projekt/
├── .claude/
│   └── skills/
│       └── mein-erster-skill/
│           └── SKILL.md

Die SKILL.md ist eine normale Markdown-Datei. Kein spezielles Format nötig — nur Markdown das Claude lesen kann.

Schritt 2 — Trigger und Beschreibung definieren

Am Anfang der SKILL.md definierst du wann der Skill aktiviert wird:

description: Erstellt SEO-optimierte Blogartikel nach dem while.chat Standard.
  USE WHEN: Artikel schreiben, Blog Post, neuer Artikel, Content erstellen.
  NICHT fuer: Social Media Posts, E-Mails, technische Docs.

Die Beschreibung enthält:

• Was der Skill tut (1 Satz)
• Wann er aktiviert wird (Trigger-Wörter)
• Wann er NICHT aktiviert wird (Abgrenzung)

Schritt 3 — Instruktionen schreiben

Der Hauptteil der SKILL.md enthält die Schritt-für-Schritt-Anleitung:

# Content-Writer Skill

## Was dieser Skill tut
Erstellt SEO-optimierte Blogartikel mit Keyword-Map, FAQ, Merksätzen
und interner Verlinkung.

## Ablauf
1. Prüfe ob ein Fokus-Keyword angegeben wurde
2. Erstelle eine Keyword-Map (Fokus + 12 Longtails)
3. Schreibe den Artikel (MOFU: 1.800-2.500 Wörter)
4. Baue 5 FAQ-Einträge ein
5. Erstelle mindestens 1 Merksatz
6. Setze 5+ interne Links zu bestehenden Artikeln
7. Erstelle den SEO-Block (Meta-Title, Meta-Description, Slug, Schema)

## Qualitätsstandards
- Mindestens 2 externe Quellen (Buch, Studie, offizielle Doku)
- Keine halluzinierten Fakten
- Zitierfähige Absätze für GEO
- Sprache: Deutsch, informell, Du-Form

Schritt 4 — Referenz-Dateien hinzufügen

Für komplexere Skills kannst du Referenz-Dateien im selben Ordner ablegen:

mein-erster-skill/
├── SKILL.md
├── article-template.md    (Vorlage für Artikel)
├── keyword-map-example.md (Beispiel einer Keyword-Map)
└── quality-checklist.md   (Prüfliste für Qualität)

In der SKILL.md referenzierst du diese Dateien: „Nutze article-template.md als Vorlage für die Artikelstruktur."

5 Skill-Ideen die sofort Mehrwert bringen

Skill: Content-Writer

Zweck: Blogartikel nach einem festen Standard erstellen.

Trigger: „Artikel schreiben", „Blog Post", „neuer Content"

Was er tut: Keyword-Map erstellen, Artikel nach Template schreiben, FAQ + Schema + interne Links einfügen, Qualitäts-Checkliste durchgehen.

Zeitersparnis: 30–60 Minuten pro Artikel (kein manuelles Prompt-Engineering mehr).

Skill: Preflight-Check

Zweck: Vor der Erstellung von Dateien für Dritte fehlende Informationen sammeln.

Trigger: „PDF erstellen", „Angebot schreiben", „Dokument für Kunden"

Was er tut: Prüft ob alle nötigen Infos vorhanden sind (Empfänger, Zweck, Tonalität, Branding), fragt gezielt nach was fehlt, startet erst dann die Erstellung.

Zeitersparnis: Verhindert Neuerstellungen weil Infos fehlten.

Skill: SEO-Audit-Starter

Zweck: Schnelle SEO-Analyse einer Website.

Trigger: „Analysiere die Seite", „SEO-Check", „Website-Audit"

Was er tut: 6 Dimensionen prüfen (SEO, Performance, Content, Conversion, Accessibility, Technik), Ergebnisse als Report formatieren, Handlungsempfehlungen nach Priorität sortieren.

Zeitersparnis: 2–3 Stunden (manuelle Analyse vs. 15 Minuten mit Skill).

Skill: Deployment-Prüfer

Zweck: Vor jedem Deploy eine Checkliste durchgehen.

Trigger: „Deploy", „Live schalten", „Veröffentlichen"

Was er tut: Performance-Check, Security-Review, SEO-Basics (Meta-Tags, Sitemap, robots.txt), Mobile-Test, Accessibility-Check. Gibt erst grünes Licht wenn alles passt.

Zeitersparnis: Verhindert Post-Deploy-Panik.

Skill: Fakten-Checker

Zweck: Zahlen, Statistiken und Behauptungen in Outputs verifizieren.

Trigger: Automatisch nach Outputs mit konkreten Zahlen oder Behauptungen.

Was er tut: Identifiziert prüfbare Aussagen, recherchiert per Web-Search, markiert Bestätigtes als ✅ und Unbestätigtes als ⚠️.

Zeitersparnis: Verhindert peinliche Fehler in veröffentlichten Inhalten.

Skill-Architektur für Fortgeschrittene

Wenn du mehr als 5 Skills hast, brauchst du Struktur.

Kategorien

Gruppiere deine Skills nach Funktion:

• Orchestrierung: Skills die andere Skills koordinieren (z.B. Skill-Router, Todo-Orchestrator)
• Content: Skills für die Inhaltserstellung (Content-Writer, SEO-Schreibstil)
• Qualität: Skills die prüfen und verbessern (Fakten-Checker, Konsistenz-Checker)
• Development: Skills für Code und Deployment (Deployment-Prüfer, Code-Review)

Skill-Ketten

Manche Aufgaben brauchen mehrere Skills in Folge. Beispiel für einen neuen Blogartikel:

1. SEO-Schreibstil → definiert Keywords und Strategie

2. Content-Writer → schreibt den Artikel

3. Fakten-Checker → prüft Zahlen und Quellen

4. Konsistenz-Checker → prüft Stil und Verlinkung

Du kannst diese Kette in einem Orchestrierungs-Skill definieren der die anderen in der richtigen Reihenfolge aufruft.

CLAUDE.md als zentrale Steuerung

Die CLAUDE.md Datei im Projektstamm ist dein Leit-Dokument. Sie sagt Claude: Wer bist du? Was sind die Regeln? Welche Skills gibt es? In welcher Reihenfolge?

Eine gute CLAUDE.md enthält:

• Projektkontext (was wird gebaut, für wen)
• Sprachregeln (Deutsch/Englisch, Du/Sie)
• Qualitätsstandards (keine halluzinierten Fakten, Quellen angeben)
• Skill-Übersicht (welche Skills existieren, wann welcher)
• Wichtige Pfade und Konventionen