Claude Code wird mit einem universellen AI-Assistenten ausgeliefert. Skills ermöglichen es Ihnen, diesen zu spezialisieren. Ein Skill ist eine Markdown-Datei, die Claude Code beibringt, wie eine bestimmte Art von Aufgabe zu bewältigen ist: das Deployment auf Kubernetes, das Schreiben von Datenbank-Migrationen, das Reviewen von Pull Requests oder das Befolgen der Coding-Konventionen Ihres Teams.
Der Unterschied zwischen „Schreibe mir eine React-Komponente“ und „Schreibe mir eine React-Komponente, die unserem Design-System folgt, unsere benutzerdefinierten Hooks verwendet und über korrekte Error Boundaries sowie Accessibility-Attribute verfügt“, ist ein Skill.
Die offiziellen Claude Code-Docs stellen eines nun klar: Custom Commands wurden in Skills zusammengeführt. Bestehende Dateien in .claude/commands/ funktionieren weiterhin, aber Skills sind die empfohlene Abstraktion, da sie reichhaltigere Metadaten, unterstützende Dateien und automatisches Laden unterstützen. Wenn Sie heute einen Team-Workflow standardisieren, bauen Sie ihn zuerst als Skill auf und behandeln Sie Legacy-Commands als Kompatibilitätspfad.
Was Skills eigentlich sind
Ein Skill befindet sich in einem Verzeichnis mit einem SKILL.md-Einstiegspunkt. Claude kann ihn automatisch laden, wenn die Beschreibung zur aktuellen Aufgabe passt, oder Sie können ihn direkt mit /skill-name aufrufen.
.claude/
skills/
deploy/
SKILL.md # /deploy
review-pr/
SKILL.md # /review-pr
write-test/
SKILL.md # /write-test
Claude unterstützt weiterhin .claude/commands/deploy.md, und der Slash-Command wird weiterhin funktionieren. Aber die moderne Version ist .claude/skills/deploy/SKILL.md.
Das klingt nach einer kleinen Namensänderung. Sie ist jedoch wichtig, da Skills unterstützende Dateien, Frontmatter, Aufrufsteuerungen und Hinweise für Sub-Agents enthalten können. Eine einfache Command-Datei kann Claude sagen, was zu tun ist. Ein Skill kann Claude sagen, wie Ihr Team die Ausführung der Arbeit erwartet.
Ihren ersten Skill schreiben
Hier ist ein praktisches Beispiel: ein Skill, der die Commit-Message-Konventionen Ihres Teams erzwingt.
Erstellen Sie .claude/skills/commit/SKILL.md:
---
name: commit
description: Generate and validate conventional commits for this repo.
---
# Commit Workflow
## Steps
1. Run `git diff --staged` to see what's being committed
2. Analyze the changes and categorize: feat, fix, refactor, docs, test, chore
3. Write a commit message following our convention:
- Format: `type(scope): description`
- Scope is the package or module name
- Description is imperative mood, lowercase, no period
- Body explains WHY, not WHAT
4. If changes touch multiple scopes, create separate commits
5. Run `git commit -m "message"` with the generated message
## Rules
- Never use `--no-verify` to skip hooks
- Never amend published commits
- If tests fail in pre-commit, fix the issue first
## Examples
- `feat(billing): add stripe webhook handler`
- `fix(auth): handle expired refresh tokens`
- `refactor(api): extract rate limiter to shared package`
Nun gibt /commit Claude Code einen strukturierten Workflow anstelle einer vagen „Commit meine Änderungen“-Anweisung.
Wenn Sie bereits Legacy-Command-Dateien haben, lassen Sie diese während der Migration weiterlaufen, aber investieren Sie nicht weiter in das alte Layout. Die offiziellen Docs sagen deutlich, dass Skills der Weg in die Zukunft sind.
Wo Skills jetzt zu finden sind
Claude Code findet Skills derzeit an vier Orten:
- persönliche Skills:
~/.claude/skills/<skill-name>/SKILL.md - Projekt-Skills:
.claude/skills/<skill-name>/SKILL.md - verschachtelte Projekt-Skills in Monorepos
- von Plugins bereitgestellte Skills
Das ermöglicht eine saubere Trennung:
- persönliche Skills für Ihren eigenen Arbeitsstil
- Projekt-Skills für Repo-Konventionen
- Plugin-Skills für wiederverwendbare, paketierte Workflows
Für die Einführung im Team sollten Sie Projekt-Skills in das Repo committen. Das ist der Unterschied zwischen „Ich habe einen netten Prompt auf meinem Laptop“ und „das Team verfügt nun über einen wiederholbaren Workflow“.
Skill Design Patterns
Das Checklist-Pattern
Am besten geeignet für Aufgaben mit mehreren Verifizierungsschritten.
# Pre-Deploy Checklist
Before deploying, verify each item:
- [ ] `pnpm typecheck` passes
- [ ] `pnpm test` passes
- [ ] No console.log statements in production code
- [ ] Environment variables documented in .env.example
- [ ] Database migrations are reversible
- [ ] API changes are backward compatible
If any check fails, stop and report the issue. Do not proceed with deployment.
Das Entscheidungsbaum-Pattern
Am besten geeignet für Aufgaben, bei denen der Ansatz vom Kontext abhängt.
# Bug Fix Workflow
1. Reproduce the bug (find or write a failing test)
2. Identify the root cause:
- If it's a type error → fix the type definition at the source
- If it's a race condition → add proper locking/sequencing
- If it's a missing validation → add schema validation at the boundary
- If it's a logic error → fix and add regression test
3. Verify the fix doesn't break existing tests
4. Write a test that would have caught this bug
Das Template-Pattern
Am besten geeignet für die Generierung konsistenter Ausgaben.
# New API Endpoint
Create a new API endpoint following our conventions:
## File Structure
- Route handler: `apps/api/src/routes/{resource}/{action}.ts`
- Schema: `apps/api/src/schemas/{resource}.ts`
- Test: `apps/api/src/routes/{resource}/__tests__/{action}.test.ts`
## Required Elements
- Zod schema for request validation
- Authentication middleware
- Rate limiting
- Structured error responses using errorResponse()
- Success responses using successResponse()
- OpenAPI documentation comments
Community-Skills installieren
Das Claude Code-Ökosystem verfügt über eine wachsende Bibliothek von Community-Skills. Installieren Sie diese mit:
npx add-skill username/repo-name -y
Beliebte Skill-Sammlungen:
coreyhaines31/marketingskills(29 Marketing/SEO-Skills)hedging8563/lemondata-api-skill(LemonData API-Integration)
Installierte Skills erscheinen in ~/.claude/commands/ und funktionieren projektübergreifend.
Installierte Skill-Packs stellen zunehmend echte Skills bereit, anstatt nur Slash-Command-Markdown. Wenn Sie Ihr eigenes Repo pflegen, gilt hier auch das Muster von OpenCode + LemonData: Halten Sie den Skill nah am Workflow und verstecken Sie ihn nicht in Ad-hoc-Prompt-Dateien.
Projekt- vs. globale Skills
| Ort | Bereich | Anwendungsfall |
|---|---|---|
.claude/skills/ |
Nur dieses Projekt | Projektkonventionen, Deployment-Workflows |
~/.claude/skills/ |
Alle Projekte | Persönliche Vorlieben, wiederverwendbare Gewohnheiten |
.claude/commands/ |
Legacy-Kompatibilität | Alte Slash-Command-Dateien, die noch funktionieren |
Projekt-Skills sollten in Ihr Repo committet werden, damit das gesamte Team davon profitiert. Globale Skills sind für persönliche Workflow-Präferenzen gedacht.
Fortgeschritten: Skills mit Hooks
Skills können auf Hooks verweisen (Shell-Befehle, die bei bestimmten Ereignissen ausgeführt werden), um eine automatisierte Durchsetzung zu ermöglichen:
# Pre-Commit Check
Before any commit, the following hooks run automatically:
- `pre-commit`: runs typecheck + lint
- `post-commit`: updates changelog
If a hook fails, investigate the error output and fix the issue.
Do not use --no-verify to bypass hooks.
Die Hooks selbst werden in .claude/settings.json konfiguriert:
{
"hooks": {
"pre-commit": "pnpm typecheck && pnpm lint-staged"
}
}
Hier werden Skills zu mehr als nur Prompt-Snippets. Ein nützliches Team-Setup besteht oft aus drei Ebenen:
- ein Skill, der Claude den Workflow erklärt
- Hooks, die den Workflow erzwingen
- Repo-Docs, die den Workflow für Menschen erklären
Wenn eine dieser Ebenen fehlt, wird das System anfällig. Ein Skill ohne Hooks bleibt unverbindlich. Hooks ohne Skills werden undurchsichtig. Docs ohne beides werden zu veralteten Richtlinien, die niemand befolgt.
Unterstützende Dateien sind das wahre Upgrade
Der wichtigste Grund, Skills gegenüber altem Command-Markdown zu bevorzugen, sind unterstützende Dateien.
Bei einer Command-Datei muss alles in einem einzigen Block stehen. Mit einem Skill-Verzeichnis können Sie Folgendes aufbewahren:
- Templates
- Beispiele
- Shell-Helper
- längere Referenznotizen
- Validator-Skripte
Dadurch können Sie die SKILL.md kurz und prägnant halten, während Claude dennoch strukturiertes Material erhält, das bei Bedarf herangezogen werden kann.
Dies ist besonders nützlich für:
- Deployment-Workflows
- Checklisten für Schema-Migrationen
- mehrstufige Code-Review-Prozesse
- produktspezifische Integrations-Playbooks
Wenn Ihr Team auch mehrere Modelle oder verschiedene Coding-Tools verwendet, kombinieren Sie diese Seite mit dem Coding-Modell-Vergleich und dem Cursor / Cline / Windsurf Setup-Guide. Gute Skills gewinnen an Bedeutung, wenn sich das zugrunde liegende Modell oder der Editor ändert.
Tipps für effektive Skills
Seien Sie spezifisch bei Dateipfaden und Namenskonventionen. „Erstelle eine Komponente“ ist vage. „Erstelle eine Komponente in
src/components/ui/unter Verwendung der PascalCase-Benennung“ ist umsetzbar.Fügen Sie Beispiele für korrekte Ausgaben hinzu. Claude Code lernt besser aus Beispielen als aus abstrakten Regeln.
Definieren Sie, was NICHT zu tun ist. „Verwende niemals den Typ
any“ ist besser durchsetzbar als „verwende korrekte Typen“.Halten Sie Skills fokussiert. Ein Skill pro Workflow. Ein 200 Zeilen langer Skill, der alles abdeckt, ist weniger nützlich als fünf 40 Zeilen lange Skills, die jeweils eine Aufgabe gut bewältigen.
Versionieren Sie Ihre Skills. Wenn sich Ihre Konventionen weiterentwickeln, aktualisieren Sie die Skills. Veraltete Skills sind schlimmer als gar keine Skills, da sie alte Muster erzwingen.
Entscheiden Sie, ob der Skill automatisch geladen oder nur manuell ausgeführt werden soll. Viele Teams vergessen dies und wundern sich dann, warum Claude in nicht zusammenhängenden Konversationen einen Deployment-Skill aufruft.
Auswirkungen in der Praxis
Teams, die Skills einsetzen, berichten von konsistenten Verbesserungen:
- Code-Review-Zyklen verkürzen sich, da Konventionen bereits vor dem Review erzwungen werden
- Die Onboarding-Zeit sinkt, da neue Entwickler dieselbe Anleitung erhalten wie erfahrene Kollegen
- Die Qualität von KI-generiertem Code verbessert sich, da die KI expliziten Kontext über Projektstandards hat
Die Investition ist gering (30 Minuten, um Ihre ersten Skills zu schreiben) und der Nutzen vervielfacht sich mit jeder Interaktion.
Das nützlichste mentale Modell ist dieses: Ein Skill ist kein Shortcut für Claude. Er ist ein versioniertes Workflow-Artefakt für Ihr Team.
Wenn Sie nur einen einzigen Skill schreiben, wählen Sie denjenigen, der die kostenintensivste wiederkehrende Entscheidung in Ihrer Codebase kodifiziert.
Bauen Sie mit KI, geleitet von Ihren eigenen Regeln. LemonData bietet Ihnen einen API-Key für Coding-Modelle verschiedener Anbieter, sodass Sie nach der Kodifizierung Ihrer Workflows als Skills die Modelle wechseln können, ohne die gesamte Toolchain neu aufbauen zu müssen.