Zum Inhalt springen
claude-os
Ratgeber

Claude Skills selbst erstellen — Tutorial

Ein eigener Claude Skill lässt sich in 30 Minuten bauen — und spart danach jede Woche Stunden, weil wiederkehrende Aufgaben nicht mehr neu gebrieft werden müssen. Dieser Ratgeber zeigt dir Skills von Grund auf: was sie sind, wie sie aufgebaut werden, drei vollständige Beispiele zum Nachbauen, Best Practices aus 200+ KMU-Rollouts und wie ihr Skills im Team sauber versioniert und ausrollt.

MS
Manuel Streit
· · 14 min Lesezeit

Das Wichtigste in 60 Sekunden

  • Ein Skill ist ein Ordner mit SKILL.md (Trigger + Anleitung) plus optionalen Referenzen, Beispielen und Templates.
  • Aktivierung erfolgt automatisch, wenn ein Nutzer eine Aufgabe beschreibt, die zum Skill-Trigger passt.
  • Drei Faustregeln: Eng scopen, Beispiele zeigen, Guardrails einbauen.
  • Speicherorte: persönlich (für Pro), Team-Workspace (für Cowork/Team), Repo-basiert (für Engineering).
  • Hebel: Skills standardisieren Output — Tone, Format, Pricing, Rechts-Disclaimer.
  • Wartung: Skills brauchen Pflege. Quartalsweise Review, sonst veralten sie.
  • Wann lohnt sich ein Skill? Wenn du dieselbe Aufgabe öfter als 3× im Monat machst.

Was ein Skill ist — und was nicht

Ein Skill ist: ein Ordner mit Anweisungen und Referenz-Material, den Claude bei passendem Anlass lädt. Vergleichbar mit einer Word-Vorlage — aber intelligent: Claude liest die Anleitung, befolgt die Schritte, nutzt die mitgelieferten Beispiele.

Ein Skill ist nicht:

  • Ein Prompt — der ist einmalig, der Skill bleibt.
  • Ein Projekt — Projekte halten Datei-Kontext für ein Thema, Skills halten Vorgehensweisen.
  • Ein n8n-Workflow — der ist deterministisch, Skills sind probabilistisch (Claude entscheidet, wie er folgt).
  • Ein MCP-Server — der ist ein Tool für Claude, der Skill ist die Anleitung, wie das Tool genutzt werden soll.

Mehr zur Abgrenzung: Claude Routines erstellen.

Die Skill-Struktur

skills/
└── angebot-erstellen/
    ├── SKILL.md            # Trigger, Beschreibung, System-Prompt
    ├── beispiele/
    │   ├── angebot-01.md
    │   ├── angebot-02.md
    │   └── angebot-03.md
    ├── referenzen/
    │   ├── preisliste.pdf
    │   ├── styleguide.md
    │   └── agb.md
    └── templates/
        ├── angebot-vorlage.docx
        └── kostenvoranschlag-vorlage.html

Die SKILL.md ist das Herz. Sie beschreibt, wann der Skill aktiviert wird (Trigger), was er tun soll (System-Prompt) und welche Materialien er nutzen darf.

Die Unter-Ordner sind optional, aber wertvoll:

  • beispiele/ — echte, anonymisierte Vorbilder. Nichts überzeugt Claude mehr als 2–3 gute Beispiele.
  • referenzen/ — Preislisten, Styleguides, Konventionen.
  • templates/ — fertige Vorlagen, in die nur eingefüllt wird.

Die SKILL.md im Detail

Eine SKILL.md hat zwei Teile:

Frontmatter (YAML)

---
name: angebot-erstellen
description: Erstellt professionelle Angebote auf Basis unserer Preisliste und im Tone-of-Voice der Firma. Nutze diesen Skill, wenn ein Kunden-Angebot, Kostenvoranschlag oder Pitch-Dokument erstellt werden soll.
---

Wichtig: das description-Feld entscheidet, ob Claude den Skill aktiviert. Schreib es als Bedingung: „Use this skill when …“. Klare Trigger-Phrasen (Angebot, Kostenvoranschlag, Pitch) erhöhen die Trefferquote.

Body (Markdown)

Hier steht die Anleitung. Aufbau, der sich bewährt hat:

  1. Rolle: „Du bist verantwortlich für …“.
  2. Vorgehen: Schritt-für-Schritt, nummeriert.
  3. Format: Markdown? HTML? Word? Was kommt am Ende raus?
  4. Referenzen: Welche Datei nutzt Claude wann? Mit Pfad-Hinweisen.
  5. Guardrails: Wann darf Claude nicht weitermachen, sondern muss rückfragen?

Beispiel 1: Angebotserstellung

---
name: angebot-erstellen
description: Erstellt professionelle Angebote für lol.marketing auf Basis der aktuellen Preisliste. Nutze diesen Skill, wenn ein Angebot, Kostenvoranschlag, Pitch-Dokument oder Vertragsentwurf für einen Neukunden gebraucht wird.
---

# Angebotserstellung

Du bist verantwortlich für die Erstellung von Angeboten nach unserem Standard.

## Vorgehen
1. **Frage nach den Eckdaten**: Kundenname, Branche, Projekt-Scope, Termin, besondere Anforderungen.
2. **Rechne Preise** auf Basis von referenzen/preisliste.md. Bei Rabatten > 15 % rückfrage zur Geschäftsführungs-Freigabe.
3. **Nutze unseren Tone** aus referenzen/styleguide.md — Sie-Form, sachlich-warm, keine Buzzwords.
4. **Struktur**: Deckblatt → Anliegen → Lösung → Leistungen → Preis → Zeitplan → Akzeptanz.
5. **Output** als Markdown, bereit für Konvertierung in templates/angebot-vorlage.docx.

## Beispiele
Schau dir beispiele/angebot-01.md bis angebot-03.md an. Übernimm Aufbau und Tonalität, niemals Texte 1:1.

## Guardrails
- Bei Beträgen > 25.000 € muss am Ende ein Disclaimer stehen: „Vorbehaltlich Detail-Briefing“.
- Niemals Preise erfinden, immer aus der Preisliste.
- Niemals Erfolgsversprechen formulieren („Wir verdoppeln Ihren Umsatz“ — verboten).
- AGB als Anhang verlinken: referenzen/agb.md.

Beispiel 2: Meeting-Protokoll

---
name: meeting-protokoll
description: Erstellt strukturierte Meeting-Protokolle aus Transkripten oder Notizen. Nutze diesen Skill, wenn ein Protokoll, Memo, Sitzungs-Zusammenfassung oder Action-Item-Liste aus einem Meeting gebraucht wird.
---

# Meeting-Protokoll

Du erstellst aus Transkripten oder Stichpunkten ein professionelles Protokoll.

## Vorgehen
1. **Transkript / Notizen einlesen** — auch lückenhaft, du strukturierst trotzdem.
2. **Kopf**: Datum, Teilnehmer, Abwesende, Protokollführer.
3. **Themen** als H2-Sektionen.
4. **Pro Thema**: Status, Diskussion in 2–3 Sätzen, Entscheidung, Action Items.
5. **Action Items** am Ende als Tabelle: Wer | Was | Bis wann.
6. **Output** auf Deutsch, Sie-Form, sachlich-knapp.

## Format
Markdown. Nutze templates/protokoll-vorlage.md. Datumsformat 24.04.2026.

## Guardrails
- Keine Wertungen, keine Zitate ohne Sprecher-Zuschreibung.
- Bei unklaren Punkten markieren mit [?] statt zu raten.
- Niemals Action Items für Personen, die nicht im Meeting waren.

Beispiel 3: Code-Review

---
name: code-review
description: Führt einen Code-Review auf einem Git-Branch durch — prüft Sicherheit, Performance, Tests, Konventionen. Nutze diesen Skill, wenn ein Pull Request, Merge Request oder Branch reviewt werden soll.
---

# Code-Review

Du machst einen sauberen Review wie ein Senior Engineer.

## Vorgehen
1. git diff main...HEAD lesen oder Diff erhalten.
2. **Vier Pässe**: (a) Sicherheit, (b) Performance, (c) Tests, (d) Konventionen aus referenzen/conventions.md.
3. **Output** als strukturiertes Review:
   - **Critical** (must fix vor Merge): SQL-Injection, fehlende Auth-Checks, Race Conditions.
   - **Major** (sollte fix): N+1-Queries, fehlende Tests für neue Logik.
   - **Minor** (nice-to-have): Naming, Dokumentation, Code-Style.
4. Pro Punkt: Datei, Zeilennummer, kurzer Kommentar, Vorschlag.

## Format
Markdown, mit Code-Blöcken für Vorschläge.

## Guardrails
- Niemals approven, wenn Critical-Punkte offen sind.
- Bei großen Diffs (> 1000 Zeilen) zuerst auf Funktionsblöcke aufteilen, dann reviewen.
- Konstruktiv schreiben — keine reine Kritik, immer „so wäre es besser“.

Best Practices aus 200+ KMU-Rollouts

  • Enge Scope. Ein Skill = eine Aufgabe. „Marketing-allround“ wird zum Prompt-Müll, „LinkedIn-Wochenplan“ wird zum scharfen Werkzeug.
  • Beispiele schlagen Anweisungen. 2 gute Beispiele > 20 Bullet-Points. Mit echten anonymisierten Vorbildern wird der Skill drei Klassen besser.
  • Guardrails einbauen. „Wenn Rabatt > 15 %, rückfragen“. „Wenn keine Quelle vorhanden, Fakten nicht erfinden“. Konkrete Stop-Bedingungen sind wichtiger als wohlmeinende Hinweise.
  • Versionieren. Skill-Ordner in Git, Pull-Requests, Changelog. Jeder Mitarbeiter kann Vorschläge machen.
  • Team-Rollout. Skills zentral im Claude-Team-Workspace, nicht lokal pro Mitarbeiter. Konsistenz schlägt Einzel-Kreativität.
  • Naming-Konvention. Aktion-fokussiert: angebot-erstellen statt angebote. Hilft beim Trigger-Matching.
  • Description in Bedingungs-Form. „Use this skill when …“ trifft besser als allgemeine Beschreibungen.
  • Quartalsweise Review. Wird der Skill genutzt? Trifft er noch eure Realität? Wenn nicht: anpassen oder löschen.

Versionskontrolle und Team-Rollout

Skill-Repo aufsetzen

Lege ein eigenes Git-Repo für eure Skills an, z. B. github.com/eure-firma/claude-skills. Struktur:

claude-skills/
├── README.md           # Übersicht aller Skills
├── CHANGELOG.md        # Änderungen nach Datum
├── angebot-erstellen/
├── meeting-protokoll/
├── code-review/
└── stellenanzeige-schreiben/

Pull-Request-Workflow

  1. Mitarbeiter erstellt Branch skill/feature-x.
  2. Skill hinzufügen oder anpassen.
  3. PR mit Beispiel-Output, der den neuen Skill demonstriert.
  4. Review durch Skill-Owner (HR/Marketing/Eng-Lead).
  5. Merge → Sync ins Team-Workspace.

Sync ins Team-Workspace

Aktuell entweder manuell (Skills in der UI hochladen) oder via API/MCP-Server für Auto-Deploy. Wir bauen für Kunden meist einen GitHub-Actions-Workflow, der Skills bei Merge automatisch ins Team-Workspace pusht.

Typische Anfänger-Fehler

  1. Zu viele Skills auf einmal. 3 echte Top-Skills schlagen 20 halbgare. Lieber priorisieren: welche 3 Aufgaben kostet uns wöchentlich am meisten Zeit?
  2. Keine Beispiele. Claude rät dann, statt zu folgen. Mindestens 2 Beispiele pro Skill.
  3. Keine Tests. Vor dem Rollout immer mit 3 realen Aufgaben prüfen — und mit 1 Edge-Case.
  4. Keine Pflege. Prozesse ändern sich, Skills müssen mitwachsen. Quartals-Review.
  5. Skills werden zu „Prompt-Romanen“. Wenn die SKILL.md über 200 Zeilen geht, ist sie zu lang. Lieber Referenzen verlinken.
  6. Skills werden zu generisch. „Schreibt Texte“ ist kein Skill. „Schreibt LinkedIn-Posts im Manuel-Streit-Stil“ ist einer.
  7. Geheimnisse im Skill. Skills landen oft in Git oder in geteilten Workspaces. Keine API-Keys, keine internen Preise außer den geplanten.

Wenn du einen professionellen Skill-Katalog für dein Team willst — wir bauen euch die ersten 5–10 Skills zur Übernahme: Skills bauen lassen.

Skills mit MCP und Routines kombinieren

Skills entfalten ihren wahren Wert in Kombination:

  • Skill + MCP: Der „Lead-Anreichern“-Skill zieht über MCP die Firmenwebsite und LinkedIn-Profile, schreibt sie aufbereitet ins CRM. Mehr: MCP Server einrichten.
  • Skill + Routine: Routine triggert „Wöchentlicher KPI-Report“-Skill jeden Montag 7:00 Uhr und sendet das Resultat in Slack. Mehr: Claude Routines.
  • Skill + Artifact: „Angebot erstellen“ liefert direkt ein druckfähiges HTML-Artifact. Mehr: Claude Artifacts.

Aus diesen drei Bausteinen bauen wir KMU-Betriebssysteme: KI-Betriebssystem einrichten.

Nächster Schritt

Bist du am Start: ein erster Skill in 30 Minuten. Brauchst du gleich einen kompletten Katalog für dein Team — wir liefern euch 5–10 Skills passgenau für eure Prozesse, inkl. Schulung und Pflege-Plan. Skill-Katalog bauen lassen.

Häufige Fragen

Noch offene Punkte?

Schreib uns auf hello@claude-os.de — oder buche direkt einen Termin, wir nehmen uns Zeit.

Brauche ich Programmier-Skills?
Nein. Skills sind Markdown + Dateien. Jeder, der ein Word-Dokument schreiben kann, kann einen ersten Skill bauen. Coding-Skills helfen erst, wenn du Skills automatisiert deployen oder mit MCP-Servern verbinden willst.
Wo speichere ich Skills?
Lokal pro Account oder zentral im Team-Workspace. Für Unternehmen empfehlen wir ausschließlich zentrale Verwaltung — Konsistenz schlägt Einzel-Kreativität.
Wie viele Skills sind sinnvoll?
Im KMU-Schnitt: 5–15 hochwertige, gepflegte Skills. Mehr wird unübersichtlich. Lieber jährlich 2–3 hinzufügen und ungenutzte streichen.
Können Skills aufeinander aufbauen?
Ja. Ein Skill kann andere Skills referenzieren („Verwende den Skill 'Tone-Check' am Ende“). In der Praxis aber sparsam einsetzen, sonst wird die Auflösung unzuverlässig.
Sind Skills mit Pro-Plan möglich?
Ja, persönliche Skills schon im Pro-Plan. Geteilte Team-Skills mit zentraler Pflege erst ab Team-Plan.
Wie groß darf ein Skill werden?
SKILL.md unter 200 Zeilen, Referenzen je nach Inhalt (PDFs, Bilder ok). Wenn es zu groß wird, in Sub-Skills splitten.
Können Skills sensitive Daten enthalten?
Im Prinzip ja, aber: Skills landen meist in Git und Workspaces — keine Geheimnisse, die nicht alle Team-Mitglieder sehen sollen. Echte Secrets gehören in MCP-Server mit Auth.
Kann ich Skills von anderen Anbietern importieren?
Anthropic hat 2025 ein Skill-Marketplace-Konzept eingeführt — fertige Skills von Drittanbietern lassen sich ins Workspace übernehmen. Vorsicht: prüft den Inhalt, bevor ihr Skills von außen einbindet, gerade bei Guardrails und Referenz-Material.

Noch Fragen zu Claude Skills erstellen?

Wir beraten ehrlich — 30 Minuten, unverbindlich.

Termin buchen