init
This commit is contained in:
Christoph K.
111
CLAUDE.md
Normal file
111
CLAUDE.md
Normal file
@@ -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)
|
||||||
73
START-HIER.md
Normal file
73
START-HIER.md
Normal file
@@ -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
|
||||||
35
docs/PROFIL.md
Normal file
35
docs/PROFIL.md
Normal file
@@ -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?]
|
||||||
49
docs/STIL.md
Normal file
49
docs/STIL.md
Normal file
@@ -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]
|
||||||
42
docs/WORKFLOWS.md
Normal file
42
docs/WORKFLOWS.md
Normal file
@@ -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.
|
||||||
46
ideas/BACKLOG.md
Normal file
46
ideas/BACKLOG.md
Normal file
@@ -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 |
|
||||||
|
|---|---|---|
|
||||||
|
| | | |
|
||||||
22
projects/AKTIV.md
Normal file
22
projects/AKTIV.md
Normal file
@@ -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**:
|
||||||
168
skills/skill-builder/SKILL.md
Normal file
168
skills/skill-builder/SKILL.md
Normal file
@@ -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
|
||||||
62
skills/skill-builder/references/skill-referenz.md
Normal file
62
skills/skill-builder/references/skill-referenz.md
Normal file
@@ -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
|
||||||
Reference in New Issue
Block a user