init

CLAUDE.md

@@ -0,0 +1,111 @@
+# Mein Personal Assistant
+
+> Diese Datei ist das Herzstück deines Setups. Claude liest sie als Erstes und weiß damit,
+> wer du bist, was du machst, und welche Skills dir zur Verfügung stehen.
+> Füll die Platzhalter mit deinen echten Daten aus – je konkreter, desto besser die Ergebnisse.
+
+## Onboarding (wird nach Setup gelöscht)
+
+Wenn der Nutzer zum ersten Mal eine Nachricht schreibt UND die Platzhalter in dieser Datei noch nicht ausgefüllt sind (du erkennst das an `[Dein Name]`, `[z.B. ...]` oder leeren Feldern), dann:
+
+1. **Stell dich vor:**
+   > Hey! Ich bin dein Personal Assistant – gebaut als Skills-Framework für Claude Code.
+   > Bevor ich dir richtig helfen kann, möchte ich dich kurz kennenlernen.
+   > Das dauert 2-3 Minuten, danach bin ich auf dich zugeschnitten.
+
+2. **Führe ein kurzes Interview.** Stell die Fragen einzeln, nicht alle auf einmal. Warte auf jede Antwort bevor du weitermachst:
+   - "Wie heißt du und was machst du beruflich?" (→ Name, Rolle, Branche)
+   - "Wer sind deine Kunden oder deine Zielgruppe?" (→ Zielgruppe)
+   - "Was ist gerade deine größte Priorität?" (→ Hauptgeschäft, aktuelle Priorität)
+   - "Welche Tools nutzt du regelmäßig?" (→ Tech-Stack)
+   - "Wie soll ich mit dir kommunizieren – locker per du, professionell per Sie?" (→ Sprache, Stil)
+   - "Gibt es Dinge die ich auf keinen Fall tun oder schreiben soll?" (→ Goldene Regeln)
+
+3. **Trag die Antworten in diese CLAUDE.md ein.** Ersetze die Platzhalter mit den echten Daten. Fasse zusammen, formuliere nicht 1:1 die Antworten um – schreib es so, wie es als Kontext für eine KI am nützlichsten ist.
+
+4. **Fülle auch `docs/PROFIL.md` mit den Infos**, soweit du genug hast. Was du nicht weißt, lass als Platzhalter stehen.
+
+5. **Bestätige das Setup:**
+   > Fertig! Ich hab dein Profil eingetragen. Du kannst die Datei jederzeit anpassen.
+   >
+   > Was du jetzt tun kannst:
+   > - Sag mir was du brauchst – ich helfe dir direkt
+   > - Tippe `/skill-builder` um deinen ersten eigenen Skill zu bauen
+   > - Oder frag mich einfach was, ich kenne dich jetzt
+
+6. **Lösche danach diesen "Onboarding"-Abschnitt** aus der CLAUDE.md, damit er nicht bei jeder Session mitgeladen wird.
+
+**Wichtig:** Wenn die Platzhalter bereits ausgefüllt sind, ignoriere diesen Abschnitt komplett und arbeite normal.
+
+## Wer bin ich?
+
+- **Name**: [Dein Name]
+- **Rolle**: [z.B. Freelancer, Agenturinhaber, Content Creator, Berater...]
+- **Branche**: [z.B. Webentwicklung, Marketing, E-Commerce, Handwerk...]
+- **Zielgruppe**: [Wen bedienst du? z.B. "KMUs im DACH-Raum", "SaaS-Gründer"...]
+
+## Was ich mache
+
+- **Hauptgeschäft**: [Was bringt das Geld rein?]
+- **Nebengeschäft**: [Falls vorhanden – YouTube, Newsletter, Kurse...]
+- **Aktuelle Priorität**: [Was hat gerade den höchsten Stellenwert?]
+
+## Goldene Regeln
+
+> Diese Regeln gelten für JEDE Interaktion. Claude hält sich daran, egal welcher Skill läuft.
+
+1. **Sprache**: [z.B. Deutsch, Du-Form / Sie-Form / Englisch]
+2. **Stil**: [z.B. direkt und knapp / ausführlich und didaktisch / locker und humorvoll]
+3. **Qualität vor Geschwindigkeit** – lieber einmal richtig als dreimal halbherzig
+4. **Konkret statt generisch** – Antworten immer auf meine Situation bezogen
+5. [Eigene Regel ergänzen]
+6. [Eigene Regel ergänzen]
+
+## Mein Tech-Stack
+
+> Welche Tools nutzt du? Claude kann dann besser einschätzen, was möglich ist.
+
+- **Frontend/Code**: [z.B. Next.js, Python, WordPress...]
+- **Backend/Hosting**: [z.B. Supabase, Firebase, Vercel...]
+- **Business-Tools**: [z.B. Notion, sevdesk, Stripe, Cal.com...]
+- **Content**: [z.B. Canva, Premiere Pro, Figma...]
+- **Sonstiges**: [Weitere Tools]
+
+## Meine Skills
+
+> Hier registrierst du alle Skills, die du baust. Claude nutzt diese Tabelle
+> um zu entscheiden, welcher Skill zu deiner Anfrage passt.
+
+| Skill | Aufruf | Zweck |
+|---|---|---|
+| `skill-builder` | `/skill-builder` | Neue Skills erstellen und bestehende verbessern |
+| | | |
+| | | |
+
+> Tipp: Jedes Mal wenn du einen neuen Skill erstellst, trag ihn hier ein.
+
+## Verzeichnisstruktur
+
+```
+mein-assistant/
+├── CLAUDE.md              ← Diese Datei (wird immer geladen)
+├── docs/                  ← Dein Kontext: Profil, Workflows, Stil
+│   ├── PROFIL.md          ← Wer du bist, was du machst (ausführlich)
+│   ├── WORKFLOWS.md       ← Wiederkehrende Abläufe
+│   └── STIL.md            ← Wie du schreibst und kommunizierst
+├── skills/                ← Deine Skills (jeder Skill = ein Ordner)
+│   └── skill-builder/     ← Der mitgelieferte Meta-Skill
+├── ideas/                 ← Ideen-Sammelstelle
+│   └── BACKLOG.md         ← Alles was dir einfällt, bewertet und sortiert
+├── projects/              ← Aktive Projekte mit Status
+│   └── AKTIV.md           ← Was gerade läuft
+└── research/              ← Gespeicherte Recherche-Ergebnisse
+```
+
+## Referenzen
+
+- Profil: [docs/PROFIL.md](docs/PROFIL.md)
+- Workflows: [docs/WORKFLOWS.md](docs/WORKFLOWS.md)
+- Schreibstil: [docs/STIL.md](docs/STIL.md)
+- Ideen: [ideas/BACKLOG.md](ideas/BACKLOG.md)
+- Projekte: [projects/AKTIV.md](projects/AKTIV.md)

START-HIER.md

@@ -0,0 +1,73 @@
+# Claude Skills Starter – Schnellstart
+
+Du hast dir gerade ein Framework runtergeladen, mit dem du dir einen Personal Assistant in Claude Code baust.
+
+## Was ist das hier?
+
+Ein vorgefertigtes System aus Ordnern und Dateien, das Claude Code sofort versteht. Du füllst deine Infos ein, und hast einen Assistenten der dich kennt und für dich arbeitet.
+
+## Was ist drin?
+
+```
+claude-skills-starter/
+│
+├── START-HIER.md          ← Du bist hier
+├── CLAUDE.md              ← Das Herzstück: Dein Profil + Skills-Register
+│
+├── docs/                  ← Dein Kontext
+│   ├── PROFIL.md          ← Wer du bist (ausführlich)
+│   ├── WORKFLOWS.md       ← Deine wiederkehrenden Abläufe
+│   └── STIL.md            ← Wie du schreibst
+│
+├── skills/                ← Deine Skills
+│   └── skill-builder/     ← Der mitgelieferte Meta-Skill
+│       ├── SKILL.md       ← Baut neue Skills für dich
+│       └── references/    ← Technische Skill-Dokumentation
+│
+├── ideas/                 ← Ideen-Sammlung
+│   └── BACKLOG.md         ← Bewertetes Ideen-Board
+│
+├── projects/              ← Projekt-Tracking
+│   └── AKTIV.md           ← Was gerade läuft
+│
+└── research/              ← Gespeicherte Ergebnisse (füllt sich automatisch)
+```
+
+## Setup in 4 Schritten
+
+### Schritt 1: Ordner in Claude Code öffnen
+Öffne Visual Studio Code (oder dein IDE), navigiere zu diesem Ordner und starte Claude Code.
+
+### Schritt 2: CLAUDE.md ausfüllen
+Öffne `CLAUDE.md` und ersetze alle `[Platzhalter]` mit deinen echten Daten.
+Das ist das Minimum – damit funktioniert der Assistant bereits.
+
+### Schritt 3: docs/ ausfüllen (optional, aber empfohlen)
+Je mehr Kontext du in `PROFIL.md`, `WORKFLOWS.md` und `STIL.md` einträgst,
+desto bessere Ergebnisse bekommst du. Du musst nicht alles auf einmal ausfüllen.
+
+### Schritt 4: Ersten Skill bauen
+Tippe in Claude Code:
+```
+/skill-builder
+```
+oder sag einfach: "Ich brauche einen Skill der [dein Wunsch]."
+Der Skill Builder fragt dich alles was er wissen muss und erstellt den Skill für dich.
+
+## Tipps
+
+- **Fang mit EINEM Skill an.** Nicht fünf gleichzeitig planen, sondern einen bauen und testen.
+- **Beobachte den Agent.** Die ersten Male zuschauen, was er macht. Dann Feedback geben.
+- **Skills werden besser.** Kein Skill ist beim ersten Mal perfekt. Nach 5-10 Durchläufen sitzt er.
+- **Alles sind nur Textdateien.** Keine Angst – du kannst nichts kaputt machen. Wenn was nicht passt, einfach die Datei bearbeiten.
+- **Skill Builder nutzen.** Der hilft dir nicht nur beim Bauen, sondern auch beim Verbessern bestehender Skills.
+
+## Ideen für erste Skills
+
+Falls du nicht weißt wo du anfangen sollst:
+
+- **Morgen-Briefing**: Kalender + Projekte + Prioritäten zusammenfassen
+- **Content-Ersteller**: Social Media Posts, Blogposts, Newsletter in deinem Stil
+- **Recherche-Skill**: Themen recherchieren und strukturiert zusammenfassen
+- **E-Mail-Verfasser**: E-Mails nach deinem Schema vorformulieren
+- **Meeting-Vorbereitung**: Vor Calls alles Wichtige zusammentragen

docs/PROFIL.md

@@ -0,0 +1,35 @@
+# Mein Profil
+
+> Diese Datei enthält ausführliche Infos über dich und dein Business.
+> Claude liest sie nicht automatisch – aber Skills können darauf zugreifen, wenn sie Kontext brauchen.
+> Je ehrlicher und konkreter du hier schreibst, desto besser werden die Ergebnisse.
+
+## Beruflicher Hintergrund
+
+- **Aktuelle Position**: [Was machst du hauptberuflich?]
+- **Erfahrung**: [Wie lange? Welche Stationen?]
+- **Spezialisierung**: [Worin bist du richtig gut?]
+
+## Mein Angebot
+
+- **Dienstleistung/Produkt**: [Was verkaufst du?]
+- **Preisrange**: [z.B. "Projekte zwischen 5k-20k€" oder "149€/Monat Abo"]
+- **Typischer Kunde**: [Wer bucht dich? Branche, Größe, Problem]
+- **Wie Kunden dich finden**: [z.B. YouTube, Empfehlungen, LinkedIn, Ads]
+
+## Aktuelle Ziele
+
+- **Kurzfristig (nächste 4 Wochen)**: [Was muss jetzt passieren?]
+- **Mittelfristig (3-6 Monate)**: [Wohin soll es gehen?]
+- **Langfristig (1 Jahr+)**: [Die große Vision?]
+
+## Stärken & Schwächen
+
+- **Stärken**: [Was fällt dir leicht?]
+- **Schwächen/Engpässe**: [Was kostet dich am meisten Zeit? Was schiebst du auf?]
+
+## Tagesstruktur
+
+- **Produktivste Zeit**: [Wann arbeitest du am besten?]
+- **Typischer Tag**: [Grober Ablauf]
+- **Deep Work pro Tag**: [Realistisch – wie viele Stunden fokussierte Arbeit?]

docs/STIL.md

@@ -0,0 +1,49 @@
+# Mein Schreibstil
+
+> Diese Datei definiert, wie Claude für dich schreibt und kommuniziert.
+> Skills können hierauf verweisen, damit Texte nach DIR klingen – nicht nach KI.
+
+## Tonalität
+
+- **Grundton**: [z.B. professionell aber locker / ernst und sachlich / humorvoll und direkt]
+- **Anrede**: [Du / Sie / je nach Kontext]
+- **Sprache**: [Deutsch / Englisch / Gemischt]
+
+## Schreibregeln
+
+- [z.B. Kurze Sätze bevorzugen]
+- [z.B. Keine Fremdwörter wenn ein deutsches Wort reicht]
+- [z.B. Immer konkrete Beispiele statt abstrakte Aussagen]
+- [z.B. Aktiv statt Passiv]
+
+## Verbotene Phrasen
+
+> Welche Formulierungen klingen NICHT nach dir? Hier sammeln.
+> Claude vermeidet diese dann konsequent.
+
+- "In der heutigen digitalen Welt..."
+- "Es ist wichtig zu beachten, dass..."
+- "Lass uns eintauchen in..."
+- [Eigene Phrasen ergänzen, die du nie sagen würdest]
+
+## Beispiele für guten Stil
+
+> Kopiere hier 2-3 echte Texte von dir rein (E-Mails, Posts, Skripte).
+> Das ist der beste Weg, Claude deinen Stil beizubringen.
+
+### Beispiel 1
+```
+[Hier einen echten Text von dir einfügen]
+```
+
+### Beispiel 2
+```
+[Noch einen echten Text einfügen]
+```
+
+## Plattform-spezifisch
+
+- **E-Mails**: [z.B. Kurz, max. 5 Sätze, immer mit klarem nächsten Schritt]
+- **Social Media**: [z.B. Hook in Zeile 1, keine Hashtag-Wände, authentisch]
+- **Blogposts**: [z.B. Scanbare Struktur, Mehrwert pro Absatz]
+- **YouTube**: [z.B. Gesprochene Sprache, persönliche Anekdoten]

docs/WORKFLOWS.md

@@ -0,0 +1,42 @@
+# Meine Workflows
+
+> Hier dokumentierst du wiederkehrende Abläufe in deinem Business.
+> Das sind die Prozesse, die du immer wieder machst – und die sich perfekt als Skills eignen.
+> Schreib sie erstmal auf, auch wenn du noch keinen Skill daraus gebaut hast.
+
+## Workflow-Vorlage
+
+Für jeden Workflow: Beschreibe die Schritte so, wie du sie einem neuen Mitarbeiter erklären würdest.
+
+---
+
+## [Workflow-Name 1]
+
+**Wann**: [z.B. "Jeden Morgen", "Wenn ein Kunde bucht", "Vor jedem Video"]
+**Dauer**: [z.B. "30 Minuten"]
+**Schritte**:
+1. [Erster Schritt]
+2. [Zweiter Schritt]
+3. [Dritter Schritt]
+
+**Kann das ein Skill?**: [ ] Ja / [ ] Teilweise / [ ] Nein
+**Notizen**: [Was nervt daran? Was dauert am längsten?]
+
+---
+
+## [Workflow-Name 2]
+
+**Wann**:
+**Dauer**:
+**Schritte**:
+1.
+2.
+3.
+
+**Kann das ein Skill?**: [ ] Ja / [ ] Teilweise / [ ] Nein
+**Notizen**:
+
+---
+
+> Tipp: Geh deine letzte Woche durch. Was hast du mehr als einmal gemacht?
+> Das sind deine besten Kandidaten für den ersten Skill.

ideas/BACKLOG.md

@@ -0,0 +1,46 @@
+# Ideen-Backlog
+
+> Sammelstelle für alle Ideen – egal ob groß oder klein.
+> Regelmäßig durchgehen und bewerten (z.B. alle 2 Wochen).
+
+## Bewertungs-Schema
+
+Jede Idee bekommt eine Kategorie:
+- **A** = Hoher Impact, machbar, gutes Timing → Umsetzen (in projects/AKTIV.md übertragen)
+- **B** = Interessant, aber nicht dringend → Aufheben, später nochmal prüfen
+- **C** = Nett, aber niedriger Impact → Irgendwann vielleicht
+- **X** = Nicht mehr relevant → Archivieren mit kurzer Begründung
+
+---
+
+## Skill-Ideen
+
+> Welche Skills könntest du gebrauchen?
+
+- [ ] [Beschreibung der Skill-Idee] | Bewertung: _
+
+---
+
+## Projekt-Ideen
+
+- [ ] [Projektidee] | Bewertung: _
+
+---
+
+## Content-Ideen
+
+- [ ] [Content-Idee] | Bewertung: _
+
+---
+
+## Sonstiges
+
+- [ ] [Idee] | Bewertung: _
+
+---
+
+## Archiv (X-Bewertungen)
+
+| Idee | Begründung | Datum |
+|---|---|---|
+| | | |

projects/AKTIV.md

@@ -0,0 +1,22 @@
+# Aktive Projekte
+
+> Hier trackst du alles woran du gerade arbeitest.
+> Skills können diese Datei lesen, um Kontext über deine aktuelle Situation zu haben.
+
+## Projekt-Vorlage
+
+### [Projektname]
+- **Status**: [Aktiv / Pausiert / Abgeschlossen]
+- **Deadline**: [Datum oder "keine"]
+- **Nächster Schritt**: [Was muss als nächstes passieren?]
+- **Notizen**: [Offene Fragen, Blocker, Abhängigkeiten]
+
+---
+
+## Meine Projekte
+
+### [Projekt 1]
+- **Status**:
+- **Deadline**:
+- **Nächster Schritt**:
+- **Notizen**:

skills/skill-builder/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: skill-builder
+description: Erstellt neue Skills und verbessert bestehende. Nutze diesen Skill wenn du einen neuen Skill bauen, einen bestehenden optimieren, oder das Skill-Format verstehen willst.
+
+---
+
+# Skill Builder
+
+Baut maßgeschneiderte Skills – Schritt für Schritt, durch gezielte Fragen.
+
+## Wann nutzen
+
+- "Neuen Skill erstellen" / "Skill bauen" / "Ich brauche einen Skill für..."
+- "Skill verbessern" / "Skill optimieren" / "Der Skill funktioniert nicht gut"
+- "Wie ist das Skill-Format?" / "Skill-Architektur erklären"
+
+---
+
+## Kontext: Was ist ein Skill?
+
+Ein Skill ist ein Ordner mit einer `SKILL.md`-Datei. Diese Markdown-Datei enthält Anweisungen, die der KI sagen, **was sie tun soll, wann, und wie**. Im Prinzip eine Checkliste für einen digitalen Mitarbeiter.
+
+### Wo leben Skills?
+```
+~/.claude/skills/skill-name/     → Global: Funktioniert in jedem Projekt
+.claude/skills/skill-name/       → Lokal: Nur in diesem Projekt verfügbar
+```
+
+### Ordnerstruktur eines Skills
+```
+skill-name/
+├── SKILL.md              ← Pflicht: Hauptdatei mit Anweisungen
+├── references/           ← Optional: Vorlagen, Beispiele, Doku
+└── scripts/              ← Optional: Ausführbare Skripte
+```
+
+Die meisten Skills brauchen NUR die `SKILL.md`. Unterordner erst anlegen, wenn die SKILL.md über 300 Zeilen geht oder externe Logik gebraucht wird.
+
+---
+
+## Anweisungen: Neuen Skill erstellen
+
+### Schritt 1: Bedarf klären
+
+Stelle diese Fragen (nacheinander, nicht alle auf einmal):
+
+1. **Was soll der Skill tun?** – Das Ziel in einem Satz.
+2. **Wann nutzt du ihn?** – In welchen Situationen? Wie oft?
+3. **Was sagst du, um ihn auszulösen?** – Natürliche Sätze sammeln.
+4. **Wie sieht ein gutes Ergebnis aus?** – Konkretes Beispiel oder Format.
+5. **Welche Infos braucht der Skill?** – Dateien, APIs, Kontext?
+6. **Was darf NICHT passieren?** – Harte Regeln, Einschränkungen.
+
+### Schritt 2: SKILL.md schreiben
+
+Nutze dieses Format:
+
+```markdown
+---
+name: [skill-name]                     # Kleinbuchstaben, Bindestriche
+description: [Was + Wann in 1-2 Sätzen]  # Entscheidend für Skill-Erkennung!
+user-invocable: true
+---
+
+# [Skill Name]
+
+[Was macht der Skill? Ein Satz.]
+
+## Wann nutzen
+
+- [Trigger-Satz 1]
+- [Trigger-Satz 2]
+- [Trigger-Satz 3]
+
+## Kontext
+
+[Hintergrundwissen das die KI jedes Mal braucht]
+
+## Anweisungen
+
+1. [Erster Schritt – klar und konkret]
+2. [Zweiter Schritt]
+3. [Dritter Schritt]
+...
+
+## Regeln
+
+- [Harte Regel 1]
+- [Harte Regel 2]
+
+## Output-Format
+
+[Wie soll das Ergebnis aussehen? Template zeigen.]
+```
+
+### Schritt 3: Skill-Ordner anlegen
+
+```bash
+mkdir -p skills/[skill-name]
+```
+
+Die SKILL.md dort ablegen.
+
+### Schritt 4: Testen
+
+- Skill direkt in der Session testen
+- Output mit dem Nutzer abgleichen
+- Feedback einarbeiten
+
+### Schritt 5: Installieren
+
+Für globale Verfügbarkeit (funktioniert in jedem Projekt):
+```bash
+ln -sf "$(pwd)/skills/[skill-name]" ~/.claude/skills/[skill-name]
+```
+
+### Schritt 6: In CLAUDE.md eintragen
+
+Den neuen Skill in die Skills-Tabelle in der CLAUDE.md einfügen.
+
+---
+
+## Anweisungen: Bestehenden Skill verbessern
+
+1. SKILL.md des Ziel-Skills lesen
+2. Fragen: Was funktioniert nicht? Was fehlt? Was ist zu langsam?
+3. Gezielt anpassen:
+   - **Falscher Output** → Anweisungen präzisieren, Beispiel ergänzen
+   - **Falscher Ton/Stil** → Referenzdatei mit echten Beispielen erstellen
+   - **Gleicher Fehler wiederholt** → Explizite Regel hinzufügen
+   - **Zu langsam / zu viele Tokens** → Konstante Werte hardcoden, Referenzdateien statt API-Calls
+   - **Triggert nicht** → Description im Frontmatter konkreter machen
+   - **Triggert zu oft** → Description eingrenzen
+
+---
+
+## Best Practices
+
+### Die Beschreibung entscheidet alles
+Die `description` im Frontmatter ist das Wichtigste am ganzen Skill. Claude liest NUR Name und Beschreibung beim ersten Scan. Wenn die Beschreibung unklar ist, wird der Skill nie gefunden.
+
+**Schlecht**: `description: Hilft bei Content`
+**Gut**: `description: Erstellt YouTube-Titel, Thumbnails und Beschreibungen aus einem Video-Transkript. Nutze wenn ein fertiges Video optimiert werden soll.`
+
+### Schritte statt Prosa
+Nummerierte Schritte statt Fließtext. Die KI arbeitet Checklisten sauberer ab als Absätze.
+
+### Verweise statt Wiederholung
+Wenn Wissen schon in einer Datei existiert (z.B. Schreibstil in `docs/STIL.md`), dort verlinken statt kopieren:
+```markdown
+Beachte den Schreibstil aus [docs/STIL.md](../../docs/STIL.md)
+```
+
+### Beispiele schlagen Regeln
+Ein konkretes Beispiel (Input → Output) ist effektiver als zehn abstrakte Regeln.
+
+### SKILL.md unter 500 Zeilen halten
+Wenn es mehr wird: Auslagern in `references/` Unterordner. Die KI verliert bei zu langen Dateien den Fokus.
+
+### Kein Overengineering
+Ein Skill muss nicht alles abdecken. Lieber drei fokussierte Skills als ein Monster-Skill.
+
+### Der Feedback-Loop
+Kein Skill ist beim ersten Mal perfekt. Der Ablauf:
+1. Skill bauen → testen → beobachten was die KI macht
+2. Feedback geben → Skill anpassen
+3. Wiederholen bis das Ergebnis stimmt
+4. Nach 5-10 Durchläufen ist der Skill richtig gut

skills/skill-builder/references/skill-referenz.md

@@ -0,0 +1,62 @@
+# Skill-Referenz
+
+> Diese Datei enthält technisches Hintergrundwissen über Claude Code Skills.
+> Der Skill Builder greift bei Bedarf darauf zu, damit er nicht jedes Mal das Web durchsuchen muss.
+
+## Frontmatter-Optionen (YAML-Header)
+
+| Feld | Pflicht | Beschreibung |
+|---|---|---|
+| `name` | Ja | Skill-Name (Kleinbuchstaben, Bindestriche) |
+| `description` | Ja | Was der Skill tut + wann er genutzt wird |
+| `user-invocable` | Nein | `true` = per /slash-command aufrufbar |
+| `model-invocable` | Nein | `false` = NUR per Slash-Command, nicht automatisch |
+| `allowed-tools` | Nein | Welche Tools der Skill nutzen darf |
+| `agent` | Nein | Dedizierter Sub-Agent für den Skill |
+
+## Progressive Context Loading
+
+So entscheidet Claude, welchen Skill er lädt:
+
+**Level 1 – Scan**: Nur `name` und `description` werden gelesen (~100 Tokens). Passiert bei JEDER Anfrage.
+**Level 2 – Match**: Wenn der Skill passt, wird die komplette SKILL.md gelesen (~1.000-3.000 Tokens).
+**Level 3 – Referenzen**: Nur wenn die Aufgabe es erfordert, werden Dateien aus `references/` oder `scripts/` geladen.
+
+→ Das bedeutet: Die `description` muss perfekt sein, weil sie der einzige Filter ist.
+
+## Skill-Speicherorte
+
+```
+~/.claude/skills/         → Global: Funktioniert überall
+.claude/skills/           → Projekt-lokal: Nur in diesem Ordner
+```
+
+Globale Skills eignen sich für: Schreibstil, Firmenkontext, persönliche Workflows.
+Lokale Skills eignen sich für: Projektspezifische Aufgaben, Team-Skills.
+
+## Symlinks erstellen
+
+Skill lokal entwickeln, global verfügbar machen:
+```bash
+# Linux/Mac
+ln -sf /pfad/zu/skills/skill-name ~/.claude/skills/skill-name
+
+# Windows (PowerShell als Admin)
+New-Item -ItemType SymbolicLink -Path "$env:USERPROFILE\.claude\skills\skill-name" -Target "C:\pfad\zu\skills\skill-name"
+```
+
+## Typische Skill-Größen
+
+| Typ | Zeilen | Beispiel |
+|---|---|---|
+| Einfach | 30-80 | Schreibstil-Checker, Format-Konverter |
+| Mittel | 80-200 | Content-Ersteller, Recherche-Skill |
+| Komplex | 200-500 | Orchestrator (ruft andere Skills auf), Multi-Step-Workflows |
+
+## Häufige Fehler
+
+1. **Description zu vage** → Skill wird nie gefunden
+2. **Zu viele Schritte in einer SKILL.md** → KI verliert Fokus
+3. **Keine Beispiele** → Inkonsistente Ergebnisse
+4. **Alles in einem Skill** → Lieber aufteilen
+5. **Referenzdateien nicht verlinkt** → KI weiß nicht dass sie existieren