SKILL.md-Body und Referenzdateien
Detaillierte Anweisungen schreiben, externen Kontext verlinken
⏱ ca. ~5 Min
01 · Lesen
Der Markdown-Body unter der Frontmatter ist der Ort, an dem die wahre Kraft steckt. Hier schreibst du detaillierte Anweisungen, Beispiele, Einschränkungen und Regeln, an die sich Claude halten soll.
Stell dir das als hochpräzises Anleitungshandbuch für eine Aufgabe vor.
Gliedere Abschnitte mit Markdown-Überschriften, schreib Regeln als Bullet-Points und nutze Code-Fences für Beispiele. Je klarer und konkreter du bist, desto konsistenter arbeitet Claude.
Ein Body, der „Schreib guten Code" sagt, bringt nichts — Claude versucht das ohnehin schon. Ein Body, der sagt „Variablen in camelCase, React-Komponenten in PascalCase, CSS-Klassen in kebab-case", lässt sich durchsetzen.
Kernpunkte
- Der Body ist freies Markdown — Überschriften, Bullet-Points, Code-Fences, Fettdruck
- Sei explizit: „Variablen in camelCase" schlägt „Nimm gute Namen"
- Pack Beispiele rein, wie gute Ausgaben aussehen
- Strukturier mit Überschriften, damit Claude die passenden Regeln schnell findet
02 · Code-Beispiel
Hier ist ein „API Developer"-Skill mit einem reichhaltig strukturierten Body — Überschriften, Regeln und Code-Beispiele.
api-developer/SKILL.md (Body-Bereich)
## API Conventions
- All endpoints return JSON
- Use kebab-case for URL paths: `/user-profiles` not `/userProfiles`
- Use camelCase for JSON fields: `{ "firstName": "Ada" }`
- Always include `Content-Type: application/json` header
## Error Response Format
Always return errors in this exact shape:
```json
{
"error": {
"code": "NOT_FOUND",
"message": "User with id 42 not found"
}
}
```
## Status Code Rules
- 200 for successful reads
- 201 for successful creates
- 400 for invalid input
- 404 for missing resources
- 500 should never be intentional — fix the bug
Claude liest jede Überschrift, jeden Bullet-Point und jedes Code-Beispiel. Wenn du später sagst „Bau mir einen GET /users-Endpoint", hält sich Claude automatisch an diese Konventionen — kebab-case-URLs, camelCase-JSON, dein genau festgelegtes Fehlerformat.
03 · Lesen
Manchmal verweisen deine Anweisungen auf externes Wissen — ein Datenbankschema, einen Style Guide, Type-Definitionen, Templates.
Statt all das in die SKILL.md zu kopieren (was sie aufbläht und schwer wartbar macht), kannst du Referenzdateien verlinken.
Leg sie in denselben Skill-Ordner wie die SKILL.md und verweise im Body darauf. Wenn der Skill aktiv ist, liest Claude die verlinkten Dateien als zusätzlichen Kontext.
Der Vorteil von Referenzdateien: Sie sind die echte Source of Truth. Ändert sich dein Schema, sieht Claude automatisch die aktuelle Version — kein manuelles Aktualisieren des Skills nötig.
Kernpunkte
- Referenzdateien liegen im selben Skill-Ordner wie die SKILL.md
- Sie liefern Kontext, ohne die Skill-Datei aufzublähen
- Übliche Referenzdateien: Schema-Dateien, Style Guides, Templates, Type-Definitionen
- Referenzdateien bleiben aktuell, weil sie selbst die Source of Truth sind
04 · Code-Beispiel
Hier ist ein Skill, der ein Prisma-Schema als Referenzdatei verlinkt — Claude bekommt damit vollständiges Wissen über deine Datenbankstruktur.
Ordnerstruktur
.claude/skills/db-developer/
├── SKILL.md
└── schema.prisma
db-developer/SKILL.md
---
name: Database Developer
description: Writes database queries and migrations following our schema
---
## Context
Our database schema is defined in `schema.prisma` (included in this skill folder).
Always reference it when writing queries or migrations.
## Rules
- Never use raw SQL — use Prisma Client
- Always include `createdAt` and `updatedAt` on new models
- Foreign keys must have `onDelete: Cascade` unless specified otherwise
- Index any column used in WHERE clauses
Wenn dieser Skill aktiv ist, kann Claude schema.prisma lesen und deine Datenbankstruktur verstehen. Änderst du das Schema später, sieht Claude automatisch die neueste Version — ohne den Skill anzupassen.
05 · Quiz
Stell dir vor, dein Datenbankschema ändert sich häufig. Warum eine Referenzdatei nutzen, statt das Schema direkt in die SKILL.md zu kopieren?
- Referenzdateien laden schneller als eingebetteter Inhalt
- SKILL.md hat ein striktes Limit von 100 Zeilen
- Claude kann nur Dateien lesen, die von der SKILL.md getrennt sind
- Referenzdateien bleiben mit der Quelle aktuell und halten die SKILL.md fokussiert
06 · Zuordnen
Du hast die vier Bestandteile eines Skills gelernt. Ordne jeder Komponente zu, was sie tut — denk daran, wo Metadaten, Anweisungen und externer Kontext jeweils zu Hause sind.
(Diese Sektion ist interaktiv — aktiviere JavaScript, um sie zu nutzen.)
Andere Lektionen aus diesem Kapitel
⚠ Das volle interaktive Erlebnis braucht JavaScript. Bitte aktiviere es und lade die Seite neu.
※ Diese Seite ist ein unabhängiges Bildungsprojekt — kein offizielles Anthropic-Produkt. Claude™ ist eine eingetragene Marke von Anthropic, PBC.