Skills in Aktion: Live-Demo

Theorie ist gut, Praxis ist besser. In dieser Lektion siehst du exakt, wie Skills im Alltag funktionieren — vom Aufruf bis zum fertigen Ergebnis. Wir gehen jeden Schritt durch, debuggen typische Probleme und teilen Tricks, die du nirgendwo anders findest.

Der Grundablauf: Einen Skill aufrufen

Öffne Claude Code in deinem Projekt und tippe einen Slash-Befehl:

> /brainstorm

Claude Code erkennt den Befehl, lädt die entsprechende Skill-Datei und fragt dich nach dem Input:

Claude: Was möchtest du brainstormen?
> 10 Ideen für Telegram-Posts über Vibe Coding für Anfänger

Jetzt passiert die Magie. Der Agent folgt den im Skill definierten Schritten:

1. Divergentes Denken — Generiert 20+ rohe Ideen ohne Filter
2. Clustering — Gruppiert ähnliche Ideen in Kategorien
3. Bewertung — Bewertet jede Idee nach Relevanz, Originalität und Umsetzbarkeit
4. Selektion — Wählt die Top 10 aus und begründet die Auswahl
5. Aufbereitung — Präsentiert die Ergebnisse in einem strukturierten Format

Das Ergebnis sieht etwa so aus:

## Top 10 Telegram-Post-Ideen: Vibe Coding für Anfänger

### Kategorie: Einstieg
1. "Was ist Vibe Coding? — In 60 Sekunden erklärt" (Hook: Die meisten denken, Coding sei schwer...)
2. "Dein erster Vibe-Coding-Moment" (Hook: Ich habe gerade eine App gebaut. Ohne eine Zeile Code zu schreiben.)

### Kategorie: Praktische Tipps
3. "3 Prompts, die alles verändern" (Hook: Copy-paste diese 3 Sätze...)
4. "Der größte Anfängerfehler" (Hook: 90% machen das falsch...)

[...]

Interaktionsfluss: Was passiert hinter den Kulissen?

Lass uns den Ablauf technisch verstehen:

1. Skill-Erkennung

Wenn du /brainstorm tippst, sucht Claude Code in zwei Verzeichnissen:

• ~/.claude/commands/brainstorm.md (global)
• .claude/commands/brainstorm.md (projektspezifisch)

Das projektspezifische Verzeichnis hat Vorrang. So kannst du globale Skills für einzelne Projekte überschreiben.

2. Kontext-Aufbau

Der Skill-Inhalt wird als System-Instruktion geladen. Claude Code behandelt den Skill wie eine detaillierte Aufgabenbeschreibung. Dazu kommt:

• Dein aktueller Projektkontext (offene Dateien, Repository-Struktur)
• Dein Input (das Thema, das du angegeben hast)
• Die Konversationshistorie

3. Ausführung

Claude Code arbeitet die Skill-Schritte sequenziell ab. Bei jedem Schritt:

• Liest er die Anweisung
• Führt sie aus
• Prüft das Ergebnis gegen die definierten Regeln
• Geht zum nächsten Schritt

4. Ausgabe

Das Ergebnis wird formatiert und dir präsentiert. Je nach Skill kann das sein:

• Text im Terminal
• Eine neue Datei
• Änderungen an bestehenden Dateien
• Eine Kombination aus allem

Debugging: Wenn Skills nicht funktionieren

Skills sind mächtig, aber nicht unfehlbar. Hier sind die häufigsten Probleme und ihre Lösungen:

Problem 1: Skill wird nicht gefunden

Symptom: Du tippst /mein-skill und nichts passiert.

Ursachen:

• Dateiname stimmt nicht mit dem Befehl überein
• Datei liegt im falschen Verzeichnis
• Dateiendung fehlt oder ist falsch

Lösung:

# Prüfe, ob die Datei existiert
ls ~/.claude/commands/mein-skill.md
ls .claude/commands/mein-skill.md

# Dateiname muss exakt dem Befehl entsprechen
# /mein-skill → mein-skill.md
# /brainstorm → brainstorm.md

Problem 2: Skill wird aufgerufen, aber macht das Falsche

Symptom: Der Output entspricht nicht deinen Erwartungen.

Ursachen:

• Anweisungen im Skill sind zu vage
• Schritte sind widersprüchlich
• Ausgabeformat ist nicht klar definiert

Lösung: Öffne die Skill-Datei und prüfe:

# Schlecht:
## Prozess
Schreibe einen guten Text.

# Gut:
## Prozess
1. Analysiere das Thema und identifiziere die Kernaussage
2. Schreibe einen Hook (max. 15 Wörter), der Neugier weckt
3. Entwickle 3 Absätze mit jeweils einem konkreten Beispiel
4. Schließe mit einer Handlungsaufforderung

Die Regel: Je präziser die Anweisungen, desto besser das Ergebnis.

Problem 3: Skill bricht mittendrin ab

Symptom: Claude Code stoppt nach dem zweiten Schritt.

Ursachen:

• Der Skill ist zu lang (Token-Limit erreicht)
• Ein Schritt erfordert externes Wissen, das nicht verfügbar ist
• Widersprüchliche Regeln blockieren den Fortschritt

Lösung:

• Teile den Skill in kleinere Teil-Skills auf
• Entferne unnötige Schritte
• Stelle sicher, dass alle benötigten Informationen im Skill oder im Kontext vorhanden sind

Problem 4: Output-Qualität schwankt

Symptom: Manchmal liefert der Skill großartige Ergebnisse, manchmal nicht.

Lösung: Füge Qualitätsanker hinzu:

## Regeln
- Jeder Punkt MUSS ein konkretes Beispiel enthalten
- KEINE generischen Aussagen (z.B. "ist wichtig", "hat viele Vorteile")
- Mindestens 3 Fakten oder Zahlen pro Absatz
- Output MUSS zwischen 200 und 400 Wörtern liegen

Tipps und Tricks für Profis

Trick 1: Skill-Chaining

Kombiniere Skills in einer einzigen Session:

> /brainstorm "Content-Ideen für diese Woche"
> [Wähle Idee Nr. 3]
> /draft "Schreibe einen Post über Idee Nr. 3"
> /deaiify "Bereinige den Post"
> /review "Prüfe den finalen Text"

Jeder Skill baut auf dem Ergebnis des vorherigen auf. Das ist manuelle Pipeline-Arbeit — die automatisierte Version lernst du in der Lektion über die 5-Phasen-Pipeline.

Trick 2: Kontext-Priming

Gib dem Skill zusätzlichen Kontext, bevor du ihn aufrufst:

> Hier ist mein Stil-Guide: [Stil-Guide einfügen]
> Hier sind meine letzten 3 Posts: [Posts einfügen]
> /linkedin-post "Neuer Post über Prompt Engineering"

Je mehr Kontext der Agent hat, desto besser passt der Output zu deinem Stil.

Trick 3: Negativ-Beispiele

Füge deinem Skill Beispiele hinzu, was er nicht produzieren soll:

## Anti-Beispiele (so NICHT)
- "In der heutigen schnelllebigen Welt der KI..."
- "Künstliche Intelligenz revolutioniert..."
- "Es ist wichtig zu verstehen, dass..."

## Positiv-Beispiele (so JA)
- "Ich habe gestern 47 Posts in 3 Stunden erstellt."
- "Der Trick, den niemand kennt:"
- "Vergiss alles, was du über Content weißt."

Trick 4: Dynamische Parameter

Mache deine Skills flexibel mit Platzhaltern:

## Eingabe
- Thema: {THEMA}
- Zielgruppe: {ZIELGRUPPE} (Standard: Tech-Interessierte, 25-40)
- Tonalität: {TON} (Standard: Professionell, aber locker)
- Länge: {LAENGE} (Standard: 200-300 Wörter)

So kann derselbe Skill für verschiedene Szenarien verwendet werden.

Trick 5: Skill-Bibliothek organisieren

Mit wachsender Skill-Sammlung wird Organisation wichtig:

.claude/commands/
├── content/
│   ├── linkedin-post.md
│   ├── telegram-post.md
│   └── blog-artikel.md
├── dev/
│   ├── tdd.md
│   ├── debug.md
│   └── review.md
└── meta/
    ├── brainstorm.md
    └── deaiify.md

Hinweis: Die Verzeichnisstruktur beeinflusst den Befehlsnamen. /content/linkedin-post statt /linkedin-post.

Skills mit anderen Tools kombinieren

Skills entfalten ihre volle Kraft in Kombination mit anderen Werkzeugen:

Skills + MCP Server

Verbinde einen Skill mit einem MCP-Server für externe Daten:

> /research "Aktuelle Trends in Vibe Coding"

Wobei der /research-Skill intern Exa MCP für die Webrecherche nutzt. Mehr über Exa erfährst du in der Lektion über den Content-Plan mit Exa MCP.

Skills + Dateisystem

Ein Skill kann Dateien lesen und schreiben:

> /generate-week "Erstelle 7 Posts für nächste Woche"

Der Skill könnte:

1. Bestehende Posts analysieren (Dateien lesen)
2. Neue Themen brainstormen (intern /brainstorm nutzen)
3. Posts erstellen (Dateien schreiben)
4. Eine Übersicht generieren (Markdown-Tabelle ausgeben)

Skills + Git

Automatisiere deinen Git-Workflow:

> /ship "Feature: Neuer Login-Screen"

Der Skill könnte:

1. git add relevante Dateien
2. git commit mit einer strukturierten Nachricht
3. git push zum Remote
4. Eine Pull-Request-Beschreibung generieren

Die wichtigste Erkenntnis

Skills sind nicht nur Shortcuts. Sie sind kodiertes Wissen. Jeder Skill, den du erstellst, ist eine Investition:

• Beim ersten Mal sparst du nichts — du investierst Zeit in den Skill
• Beim zweiten Mal sparst du 50% der Zeit
• Beim zehnten Mal sparst du 90% der Zeit
• Beim hundertsten Mal hat sich die Investition hundertfach zurückgezahlt

Das ist der Unterschied zwischen jemandem, der KI nutzt, und jemandem, der mit KI arbeitet.

Zusammenfassung

• Skill-Aufruf mit /skill_name — einfach, direkt, mächtig
• Debugging: Dateiname prüfen, Anweisungen präzisieren, Qualitätsanker setzen
• Chaining: Skills hintereinander schalten für komplexe Workflows
• Kontext: Mehr Kontext = bessere Ergebnisse
• Kombination: Skills + MCP + Dateisystem + Git = Superkräfte

Weiter geht es mit Modul 5, wo wir Content-Pläne mit Exa MCP erstellen.