Deinen ersten Skill erstellen

Deinen ersten Skill erstellen · 4 Min.

ZusammenfassungTranskript

Dieses Video führt dich durch den Aufbau eines Skills von Grund auf – eines persönlichen PR-Beschreibungs-Skills, der in all deinen Projekten funktioniert. Du siehst genau, wie du die SKILL.md-Datei strukturierst, sie testest und verstehst, wie Claude Code Skills erkennt und mit deinen Anfragen abgleicht. Das Video behandelt außerdem die Prioritätshierarchie, die bestimmt, welcher Skill gewinnt, wenn Namen kollidieren.

Wichtigste Erkenntnisse

Ein Skill ist ein Verzeichnis, das eine SKILL.md-Datei enthält mit Metadaten (Name, Beschreibung) im Frontmatter und Anweisungen darunter
Claude lädt beim Start nur die Namen und Beschreibungen der Skills, und gleicht eingehende Anfragen dann mithilfe semantischen Abgleichs mit diesen Beschreibungen ab
Bei einer Übereinstimmung wird ein Skill, der nur einen Namen, eine Beschreibung und Anweisungen enthält, vollständig geladen, ohne dich zu fragen. Wenn ein Skill Tools vorab genehmigt oder Hooks hinzufügt, fragt Claude Code möglicherweise zuerst um deine Zustimmung
Priorität bei Namenskonflikten: Enterprise → Personal → Project. Plugin-Skills sind namensräumlich getrennt, sodass sie zusammen mit einem Skill mit demselben Namen geladen werden
Um einen Skill zu aktualisieren, bearbeite seine SKILL.md. Um einen zu entfernen, lösche sein Verzeichnis. Claude Code übernimmt die Änderung in der aktuellen Sitzung, ohne Neustart. Wenn ~/.claude/skills in dieser Sitzung neu ist, führe nach jeder Änderung /reload-skills aus

Lass uns gemeinsam einen Skill von Grund auf erstellen und dann betrachten, wie Claude Code Skills im Hintergrund tatsächlich lädt und abgleicht.

Einen Skill erstellen

Wir erstellen einen persönlichen Skill, der Claude beibringt, wie man PR-Beschreibungen in einem einheitlichen Format schreibt. Da es sich um einen persönlichen Skill handelt, liegt er in deinem Home-Verzeichnis und funktioniert in all deinen Projekten.

Erstelle zunächst ein Verzeichnis für deinen Skill innerhalb des Skills-Ordners. Der Verzeichnisname sollte mit deinem Skill-Namen übereinstimmen:

mkdir -p ~/.claude/skills/pr-description

Erstelle dann eine SKILL.md-Datei innerhalb dieses Verzeichnisses. Die Datei besteht aus zwei Teilen, die durch Frontmatter-Bindestriche getrennt sind:

markdown

---
name: pr-description
description: Writes pull request descriptions. Use when creating a PR, writing a PR, or when the user asks to summarize changes for a pull request.
---

When writing a PR description:

1. Run `git diff main...HEAD` to see all changes on this branch
2. Write a description following this format:

## What
One sentence explaining what this PR does.

## Why
Brief context on why this change is needed

## Changes
- Bullet points of specific changes made
- Group related changes together
- Mention any files deleted or renamed

Der Name identifiziert deinen Skill. Die Beschreibung sagt Claude, wann er verwendet werden soll – das ist das Abgleichskriterium. Alles nach dem zweiten Satz Bindestriche sind die Anweisungen, denen Claude folgt, wenn der Skill aktiviert wird.

SKILL.md für pr-description, geöffnet in einem Editor, neben den Skill-Ordnern commit-message, debugging und documentation.

Deinen Skill testen

Claude Code überwacht deine Skills-Verzeichnisse, sodass ein neuer Skill in der aktuellen Sitzung ohne Neustart verfügbar ist. Wenn ~/.claude/skills beim Start der Sitzung noch nicht existierte, überwacht Claude Code es noch nicht – führe daher jetzt /reload-skills aus und erneut nach jeder späteren Änderung. Du kannst überprüfen, ob dein Skill verfügbar ist, indem du die Liste der verfügbaren Skills prüfst.

Ausgabe der verfügbaren Skills in Claude Code, mit Skills wie „documentation", „debugging", pr-description und commit-message.

Du solltest deinen Skill in der Liste sehen. Um ihn zu testen, nimm einige Änderungen an einem Branch vor und sage etwas wie „Schreibe eine PR-Beschreibung für meine Änderungen." Claude zeigt an, dass es den PR-Beschreibungs-Skill verwendet, prüft deinen Diff und schreibt eine Beschreibung nach deiner Vorlage – jedes Mal im selben Format.

Wie der Skill-Abgleich funktioniert

Wenn Claude Code startet, durchsucht es mehrere Orte nach Skills, lädt aber nur Name und Beschreibung, nicht den vollständigen Inhalt. Das ist ein wichtiges Detail.

Wenn du eine Anfrage sendest, vergleicht Claude deine Nachricht mit den Beschreibungen aller verfügbaren Skills. Zum Beispiel würde „erkläre, was diese Funktion macht" zu einem Skill passen, der als „Code mit visuellen Diagrammen erklären" beschrieben ist, weil sich die Absicht überschneidet.

Sobald eine Übereinstimmung gefunden wurde, liest Claude die vollständige SKILL.md-Datei und folgt ihren Anweisungen. Ein Skill, der nur einen Namen, eine Beschreibung und Anweisungen enthält (wie pr-description), lädt, ohne dich zu fragen. Wenn ein Skill Tools vorab genehmigt oder Hooks hinzufügt, fragt Claude Code dich je nach deinem Berechtigungsmodus möglicherweise zuerst um Zustimmung. Das Video oben und das Bild unten zeigen den Genehmigungsschritt, den Claude Code v2.1.19 für Skills wie pr-description entfernt hat.

Frontmatter für einen Skill, der Backend-Code auf Sicherheitsprobleme und Compliance-Verstöße überprüft, sowie „Use backend-review Skill?".

Skill-Priorität

Wenn du ein Repository klonst, das einen Skill mit demselben Namen wie einer deiner persönlichen Skills enthält, welcher gewinnt? Es gibt eine klare Prioritätsreihenfolge:

Enterprise – verwaltete Einstellungen, höchste Priorität
Personal – dein Home-Verzeichnis (~/.claude/skills)
Project – das Verzeichnis .claude/skills innerhalb eines Repositorys

Dadurch können Organisationen Standards über Enterprise-Skills durchsetzen und gleichzeitig individuelle Anpassungen ermöglichen. Wenn dein Unternehmen einen Enterprise-Skill „code-review" hat und du einen persönlichen Skill „code-review" mit demselben Namen erstellst, hat die Enterprise-Version Vorrang. Skills aus installierten Plugins stehen außerhalb dieser Reihenfolge. Sie sind als /plugin-name:skill-name namensräumlich getrennt, sodass ein Plugin-Skill und ein anderer Skill mit demselben Namen beide geladen werden.

Um Konflikte zu vermeiden, verwende beschreibende Namen. Statt nur „review" zu verwenden, nimm etwas wie „frontend-review" oder „backend-review".

Skills aktualisieren und entfernen

Um einen Skill zu aktualisieren, bearbeite seine SKILL.md-Datei. Um einen zu entfernen, lösche sein Verzeichnis. Claude Code übernimmt die Änderung in der aktuellen Sitzung, sodass du nicht neu starten musst. Wenn du /reload-skills zuvor in dieser Sitzung ausgeführt hast, weil ~/.claude/skills neu war, führe es nach jeder Änderung erneut aus.

Reflexion zur Lektion

Welche Aufgabe in deinem täglichen Workflow könntest du jetzt sofort in einen Skill verwandeln? Wie würde die Beschreibung aussehen?
Wie könnte die Prioritätshierarchie die Skill-Management-Strategie deines Teams beeinflussen? Würdest du dich eher auf persönliche Skills oder Skills auf Projektebene verlassen?

Was kommt als Nächstes

In der nächsten Lektion lernst du erweiterte Konfigurationsoptionen kennen, einschließlich Metadatenfeldern, der Vorabgenehmigung von Tools mit allowed-tools und wie du größere Skills mithilfe von progressiver Offenlegung und Multi-Datei-Organisation strukturierst.