Erstelle deine erste Skill

Was du lernen wirst

Geschätzte Zeit: 20 Minuten

Am Ende dieser Lektion wirst du in der Lage sein:

Eine Skill von Grund auf mit korrekter Frontmatter-Struktur zu erstellen
Eine Skill zu testen und zu überprüfen, dass sie korrekt in Claude Code geladen wird
Zu erklären, wie Claude Code eingehende Anfragen mit verfügbaren Skills abgleicht
Die Skill-Prioritätshierarchie zu beschreiben (Enterprise, Personal, Project, Plugins)

(4 Minuten)

Dieses Video zeigt dir, wie du eine Skill von Grund auf erstellst — eine persönliche PR-Beschreibungs-Skill, die über alle deine Projekte hinweg funktioniert. Du wirst sehen, wie du die SKILL. md-Datei strukturierst, sie testest und verstehst, wie Claude Code Skills entdeckt und zu deinen Anfragen passt. Das Video behandelt auch die Prioritätshierarchie, die bestimmt, welche Skill gewinnt, wenn Namen in Konflikt geraten.

Wichtigste Erkenntnisse

Eine Skill ist ein **Verzeichnis, das eineSKILL. md Datei** mit Metadaten (Name, Beschreibung) in Frontmatter und Anweisungen darunter enthält
Claude lädt beim Start nur Skill-Namen und Beschreibungen, gleicht dann eingehende Anfragen gegen diese Beschreibungen mit semantischem Matching ab
Du erhältst eine Bestätigungsaufforderung, bevor Claude den vollständigen Skill-Inhalt in den Kontext lädt
Priorität bei Namenskonflikten: Enterprise → Personal → Project → Plugins
Um eine Skill zu aktualisieren, bearbeite ihre SKILL. md. Um sie zu entfernen, lösche ihr Verzeichnis. Starte Claude Code immer neu damit Änderungen wirksam werden

Lass uns eine Skill von Grund auf erstellen und dann schauen, wie Claude Code Skills hinter den Kulissen tatsächlich lädt und abgleicht.

Erstelle eine Skill

Wir werden eine persönliche Skill erstellen, die Claude beibringt, wie man PR-Beschreibungen in einem konsistenten Format schreibt. Da es eine persönliche Skill ist, befindet sie sich in deinem Home-Verzeichnis und funktioniert über alle deine Projekte hinweg.

Erstelle zunächst ein Verzeichnis für deine Skill im Skills-Ordner. Der Verzeichnisname sollte deinem Skill-Namen entsprechen:

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

Erstelle dann eine SKILL. md Datei in diesem Verzeichnis. Die Datei hat zwei Teile, getrennt durch Frontmatter-Bindestriche:

--- 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:

Run git diff main... HEAD to see all changes on this branch
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 deine Skill. Die Beschreibung sagt Claude, wann es sie verwenden soll — das sind die Abgleichkriterien. Alles nach dem zweiten Satz von Bindestrichen sind die Anweisungen, die Claude befolgt, wenn die Skill aktiviert wird.

Teste deine Skill

Claude Code lädt Skills beim Start, also starte deine Sitzung neu, nachdem du eine erstellt hast. Du kannst überprüfen, dass sie verfügbar ist, indem du die Liste der verfügbaren Skills überprüfst.

Du solltest deine Skill aufgelistet sehen. Um sie zu testen, nimm einige Änderungen auf einem Branch vor und sag etwas wie „schreib eine PR-Beschreibung für meine Änderungen. " Claude wird anzeigen, dass es die PR-Beschreibungs-Skill verwendet, dein Diff überprüft und eine Beschreibung nach deiner Vorlage schreibt — jedes Mal das gleiche Format.

Wie Skill-Matching funktioniert

Wenn Claude Code startet, scannt es vier Orte nach Skills, lädt aber nur den Namen und die 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 tut" mit einer Skill übereinstimmen, die als „erkläre Code mit visuellen Diagrammen" beschrieben wird, weil die Absicht überlappt.

Sobald eine Übereinstimmung gefunden wird, fragt Claude dich, um die Skill zu laden zu bestätigen. Dieser Bestätigungsschritt hält dich darüber informiert, welchen Kontext Claude einbezieht. Nach deiner Bestätigung liest Claude die vollständige SKILL. md Datei und befolgt ihre Anweisungen.

Skill-Priorität

Wenn du ein Repository klonst, das eine Skill mit dem gleichen Namen wie eine deiner persönlichen Skills hat, welche gewinnt? Es gibt eine klare Prioritätsreihenfolge:

Enterprise — verwaltete Einstellungen, höchste Priorität
Personal — dein Home-Verzeichnis (~/. claude/skills)
Project — das . claude/skills Verzeichnis in einem Repository
Plugins — installierte Plugins, niedrigste Priorität

Dies ermöglicht es Organisationen, Standards durch Enterprise-Skills durchzusetzen und gleichzeitig individuelle Anpassungen zu ermöglichen. Wenn dein Unternehmen eine Enterprise-Skill „code-review" hat und du eine persönliche Skill „code-review" mit dem gleichen Namen erstellst, hat die Enterprise-Version Vorrang.

Um Konflikte zu vermeiden, verwende aussagekräftige Namen. Verwende statt nur „review" etwas wie „frontend-review" oder „backend-review".

Skills aktualisieren und entfernen

Um eine Skill zu aktualisieren, bearbeite ihre SKILL. md Datei. Um sie zu entfernen, lösche ihr Verzeichnis. Starte Claude Code nach allen Änderungen neu, damit sie wirksam werden.

Lektion-Reflexion

Welche Aufgabe in deinem täglichen Arbeitsablauf könntest du jetzt in eine Skill umwandeln? Wie würde die Beschreibung aussehen?
Wie könnte die Prioritätshierarchie deine Team-Skill-Management-Strategie beeinflussen? Würdest du dich mehr auf persönliche oder projektbezogene Skills verlassen?

Was kommt als Nächstes

In der nächsten Lektion lernst du über erweiterte Konfigurationsoptionen, einschließlich Metadatenfelder, Tool-Einschränkungen mit allowed-tools und wie du größere Skills mit progressiver Offenlegung und Multi-Datei-Organisation strukturierst.

Feedback

Während du den Kurs durcharbeitest, würden wir gerne hören, wie du Skills in deiner Arbeit nutzt, sowie jedes Feedback, das du hast. Teile dein Feedback hier.