From 5719de33538fd1531168bd74553afb75d02006b3 Mon Sep 17 00:00:00 2001 From: "Christoph K." Date: Tue, 7 Apr 2026 09:42:38 +0200 Subject: [PATCH] init --- CLAUDE.md | 111 ++++++++++++ START-HIER.md | 73 ++++++++ docs/PROFIL.md | 35 ++++ docs/STIL.md | 49 +++++ docs/WORKFLOWS.md | 42 +++++ ideas/BACKLOG.md | 46 +++++ projects/AKTIV.md | 22 +++ skills/skill-builder/SKILL.md | 168 ++++++++++++++++++ .../references/skill-referenz.md | 62 +++++++ 9 files changed, 608 insertions(+) create mode 100644 CLAUDE.md create mode 100644 START-HIER.md create mode 100644 docs/PROFIL.md create mode 100644 docs/STIL.md create mode 100644 docs/WORKFLOWS.md create mode 100644 ideas/BACKLOG.md create mode 100644 projects/AKTIV.md create mode 100644 skills/skill-builder/SKILL.md create mode 100644 skills/skill-builder/references/skill-referenz.md diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..871596b --- /dev/null +++ b/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) diff --git a/START-HIER.md b/START-HIER.md new file mode 100644 index 0000000..e3a8b69 --- /dev/null +++ b/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 diff --git a/docs/PROFIL.md b/docs/PROFIL.md new file mode 100644 index 0000000..3bea58e --- /dev/null +++ b/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?] diff --git a/docs/STIL.md b/docs/STIL.md new file mode 100644 index 0000000..9189e62 --- /dev/null +++ b/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] diff --git a/docs/WORKFLOWS.md b/docs/WORKFLOWS.md new file mode 100644 index 0000000..7c5116d --- /dev/null +++ b/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. diff --git a/ideas/BACKLOG.md b/ideas/BACKLOG.md new file mode 100644 index 0000000..df6ebc5 --- /dev/null +++ b/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 | +|---|---|---| +| | | | diff --git a/projects/AKTIV.md b/projects/AKTIV.md new file mode 100644 index 0000000..ba7bf5a --- /dev/null +++ b/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**: diff --git a/skills/skill-builder/SKILL.md b/skills/skill-builder/SKILL.md new file mode 100644 index 0000000..55e0d99 --- /dev/null +++ b/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 diff --git a/skills/skill-builder/references/skill-referenz.md b/skills/skill-builder/references/skill-referenz.md new file mode 100644 index 0000000..56658c9 --- /dev/null +++ b/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