# Claude Code Skills: schreiben, installieren, prüfen

URL: https://agentvera.dev/de/blog/claude-code-skills/ · Veröffentlicht: 2026-10-24

Claude Code Skills erklärt: das SKILL.md-Format, Projekt- und persönliche Ordner, wann Claude einen Skill lädt und wie du Skills aus einer Galerie findest und prüfst.

**Kurz gesagt:**

- Ein Claude Code Skill ist ein Ordner mit einer SKILL.md-Datei: Name und Beschreibung im Frontmatter, danach die Anweisungen. Claude liest die Beschreibungen und lädt einen Skill nur, wenn er relevant ist.
- Projekt-Skills liegen in .claude/skills und werden über Git geteilt; persönliche Skills liegen in ~/.claude/skills. Du kannst einen Skill auch direkt als /skill-name aufrufen.
- Ein Skill sind Anweisungen, die dein Agent befolgt, also behandle einen heruntergeladenen wie Code. Die Galerie von AgentVera prüft jeden Skill vor der Installation auf riskante Befehle, Secrets und Prompt Injection.

**Claude Code Skills sind Ordner mit einer `SKILL.md`-Datei, die Claude eine wiederkehrende Aufgabe beibringen, etwa einen PR zu prüfen oder ein Release zu schneiden, und Claude lädt einen nur, wenn deine Anfrage ihn braucht.** Damit sind Skills der richtige Ort für Anweisungen, die für manche Aufgaben wichtig sind, aber nicht für jede Session. Der Haken: Ein Skill sind Anweisungen, denen dein Agent folgt, also verdient ein Skill aus dem Internet dieselbe Sorgfalt wie ein Skript aus dem Internet.

Dieser Beitrag behandelt das Skill-Format, wo Skills liegen, wie Claude sie auswählt, wie du einen guten schreibst und wie du geteilte Skills findest und installierst, ohne deinem Agenten etwas Gefährliches in die Hand zu geben.

## Was ein Claude Code Skill ist

Ein Skill ist ein Ordner. Die einzige Pflichtdatei ist `SKILL.md`:

```markdown
---
name: release-notes
description: Use when the user asks for release notes or a changelog entry for a version.
---

1. Run `git log --oneline <last-tag>..HEAD`.
2. Group the commits into Features, Fixes and Other.
3. Write one plain sentence per change, for users, not developers.
4. Ask before writing to CHANGELOG.md.
```

Das Frontmatter enthält `name` und `description`. Der Hauptteil ist die Anweisung, der Claude folgt, sobald der Skill geladen ist. Der Ordner kann auch Skripte und Referenzdateien enthalten, auf die die Anweisungen verweisen. Ein Skill kann also sagen „führe `scripts/check.sh` aus“ oder „lies `reference/api.md` für die Endpunktliste“.

## Wo Claude Code Skills liegen

| Ort | Wer ihn bekommt | Typischer Einsatz |
| --- | --- | --- |
| `.claude/skills/<name>/SKILL.md` | Alle, die am Repo arbeiten, über Git | Projekt-Workflows: Deploy, Migrationen, Release |
| `~/.claude/skills/<name>/SKILL.md` | Du, in jedem Projekt | Persönliche Gewohnheiten: deine Review-Checkliste, Commit-Stil |

Der Ordnername wird zum Befehl, also lässt sich `.claude/skills/release-notes/SKILL.md` auch als `/release-notes` ausführen. Tippe `/skills` in einer Session, um die Skills aufzulisten, die Claude sieht. Die übrigen Slash-Befehle findest du im [Claude Code Befehle Spickzettel](/de/blog/claude-code-commands-cheat-sheet/ "Claude Code Befehle Spickzettel").

## Wie Claude entscheidet, einen Skill zu verwenden

Zu Beginn einer Session sieht Claude die Beschreibungen der Skills, nicht ihre vollständigen Inhalte. Passt deine Anfrage zu einer Beschreibung, lädt es diesen Skill. Daraus folgen zwei Dinge:

- **Die Beschreibung übernimmt das Routing.** „Release-Notes-Skill“ ist eine schwache Beschreibung. „Use when the user asks for release notes or a changelog entry for a version“ sagt Claude, wann es danach greifen soll.
- **Skills halten deinen Basiskontext klein.** Nur die Beschreibungen werden in jeder Session geladen. Wenn du aufgabenspezifische Anweisungen aus `CLAUDE.md` in Skills verschiebst, wird jeder Turn leichter. Mehr dazu im Beitrag [Claude Code Kontextfenster](/de/blog/claude-code-context-window/ "Claude Code Kontextfenster").

## Skills, CLAUDE.md, Subagents und MCP

Diese vier überschneiden sich, deshalb hilft es zu wissen, welcher passt.

| Werkzeug | Geladen | Am besten für |
| --- | --- | --- |
| `CLAUDE.md` | Jede Session, ganze Datei | Regeln, die immer gelten |
| Skill | Beschreibung immer, Inhalt bei Bedarf | Ein Workflow, den du ab und zu wiederholst |
| Subagent | Bei Delegation, im eigenen Kontext | Schwere Arbeit, deren Details du nicht zurückbrauchst |
| MCP-Server | Tool-Definitionen in jeder Session | Zugriff auf externe Systeme oder Daten |

Wenn du denselben Absatz zweimal pro Woche in Prompts einfügst, sollte es ein Skill sein. Muss der Agent mit einer Datenbank oder einer API sprechen, ist das ein MCP-Server ([was ein MCP-Server ist](/de/blog/what-is-mcp-server/ "Was ist ein MCP-Server?")).

## So schreibst du einen guten Skill

1. **Starte mit einer Aufgabe, die du schon wiederholst.** Schreibe die Schritte auf, die du heute tippst.
2. **Schreibe die Beschreibung als Auslöser.** Beginne mit „Use when…“ und nenne die Wörter, die ein Nutzer sagen würde.
3. **Halte den Hauptteil kurz und geordnet.** Nummerierte Schritte schlagen Absätze.
4. **Lege langes Material in Dateien.** Eine Referenztabelle oder ein Skript kommt neben `SKILL.md`, und der Hauptteil sagt, wann es zu lesen oder auszuführen ist.
5. **Sag, was nicht zu tun ist.** „Ask before writing to CHANGELOG.md“ verhindert die Überraschung, die du sonst von Hand korrigieren müsstest.
6. **Teste ihn in einer frischen Session.** Bitte in eigenen Worten um die Aufgabe und prüfe, ob Claude den Skill ohne Hinweis wählt.

## Das Risiko bei geteilten Skills

Beim Teilen werden Skills nützlich und riskant. Ein Skill kann deinem Agenten sagen, einen Shell-Befehl auszuführen, eine Datei außerhalb des Projekts zu lesen oder etwas an eine URL zu senden. Läuft dein Agent mit weitreichenden Rechten, läuft ein bösartiger oder nachlässiger Skill mit denselben. Worauf du vor der Installation achten solltest:

- Destruktive oder privilegierte Befehle (`rm -rf`, `sudo`)
- Das Lesen von Secrets, etwa `.env`-Dateien oder SSH-Schlüssel
- Daten, die an einen unbekannten Host gesendet werden
- Download-und-Ausführen-Muster, etwa `curl` in eine Shell zu pipen
- Verschleierter Code oder versteckte Unicode-Zeichen
- Prompt Injection: Text, der versucht, deine Anweisungen zu überschreiben

Der Beitrag [Sicherheit bei KI-Coding-Agenten](/de/blog/ai-coding-agent-security/ "Sicherheit bei KI-Coding-Agenten") behandelt Berechtigungen und Sandboxing ausführlicher.

## Skills in AgentVera verwalten

Die [Skill-Galerie](/de/features/skill-gallery/ "Skill-Galerie") von AgentVera findest du auf der Details-Seite eines Projekts unter **Automation → Skills**. Sie hat drei Ansichten: **Local**, **Discover** und **My published**.

**Local** listet die Skills auf deinem Computer für beide Agenten, die Skill-Ordner nutzen:

| Agent | Projektordner | Persönlicher Ordner |
| --- | --- | --- |
| Claude Code | `.claude/skills` | `~/.claude/skills` |
| Codex | `.agents/skills` | `~/.codex/skills` |

Von dort aus kannst du:

- Mit **New skill** einen anlegen: wähle den **Agent** (Claude Code oder Codex), den **Scope** (**This project** oder **All projects**), einen **Name** (Kleinbuchstaben, Ziffern und Bindestriche) und **When should it be used?**, was zur Beschreibung wird. **Create and edit** öffnet die neue `SKILL.md`.
- Einen Skill ausschalten, ohne ihn zu löschen. Der Schalter verschiebt den Ordner an einen Ort, den die CLIs nicht durchsuchen.
- `SKILL.md` ansehen oder bearbeiten, einen Skill für den anderen Agenten oder Scope kopieren oder ihn löschen, wodurch der Ordner in den Papierkorb wandert.

## Skills sicher finden und installieren

**Discover** zeigt die Skills deiner Organisation und die öffentliche Galerie. Suche, wähle eine von 10 Kategorien (Coding, Testing, Code Review, DevOps, Daten, Doku, Design, Sicherheit, Produktivität, Sonstiges), filtere nach Agent und sortiere nach **Popular** oder **New**. Dieselbe Galerie gibt es im Web unter app.agentvera.dev/skills.

Die Detailansicht jedes Skills hat die Tabs **Files**, **Security** und **Versions**. Der Security-Tab zeigt den **Server scan**. Der Scan sucht nach destruktiven oder privilegierten Befehlen, dem Lesen von Secrets, eingebetteten Schlüsseln, nach außen gesendeten Daten, Download-und-Ausführen, verschleiertem Code, Prompt Injection, verstecktem Unicode, rohen IP-Adressen und externen Hosts. Die Ergebnisse reichen von unbedenklich über Info, geringes, mittleres und hohes Risiko bis kritisch.

Die Installation hat zwei Schritte:

1. **Download and scan.** AgentVera lädt die Dateien herunter, prüft ihr SHA-256 und scannt sie auf deinem Computer erneut.
2. **Install.** Skripte werden als normale Dateien geschrieben und nicht ausführbar gemacht.

Agenten sehen den Skill in ihrer nächsten Session. Wird eine neue Version veröffentlicht, erscheint neben dem installierten Skill ein Update-Button. Galerie-Skills werden nur für die Agenten installiert, die sie unterstützen: Claude Code und Codex.

Öffentliche Skills durchlaufen einen Sicherheits-Scan und ein Moderator-Review, aber sieh dir trotzdem die Ergebnisse und die Dateien an. Der Scan erkennt Muster; du weißt, was dein Projekt tun soll und was nicht.

## Eigene Skills teilen

Mit einem Pro- oder Team-Plan und einem AgentVera-Konto veröffentlicht **Share** einen lokalen Skill. Du gibst ihm einen Titel, eine Zusammenfassung von 20 bis 300 Zeichen, bis zu 6 Tags, eine Kategorie und eine Version wie `1.0.0`, mit einem Changelog für jede Version. Ein Skill ist auf 50 Textdateien, 256 KB pro Datei und 1 MB insgesamt begrenzt.

- **Nur Organisation:** sofort für deine Organisation sichtbar, wenn der Scan nichts Hohes oder Kritisches findet; andernfalls wird er abgelehnt.
- **Öffentlich:** wartet auf die Freigabe durch einen Moderator, und kritische Funde werden nicht akzeptiert. Verfolge ihn unter **My published**.

## Skills und Token-Verbrauch

Jeder Skill fügt seine Beschreibung dem Basiskontext hinzu. Eine Handvoll ist in Ordnung; Dutzende persönlicher Skills summieren sich in jedem Turn. Das Lean-Kontextprofil von AgentVera lädt keine Skills auf Benutzerebene, was einer der Gründe ist, warum seine erste Anfrage kleiner ist ([hier gemessen](/de/blog/claude-code-token-usage/ "Claude Code Token-Verbrauch um 61 % senken")). Halte Projekt-Skills im Repo und räume persönliche auf, die du nicht mehr nutzt.

## Fazit

Claude Code Skills machen aus wiederholten Prompts Ordner, die Claude bei Bedarf lädt: eine `SKILL.md` mit klarer „Use when“-Beschreibung, kurzen geordneten Schritten und den nötigen Skripten, in `.claude/skills` für das Projekt oder `~/.claude/skills` für dich. Geteilte Skills lohnen sich nur, wenn du sie vorher prüfst. AgentVera listet Claude Code und Codex Skills an einem Ort, scannt Galerie-Skills auf dem Server und vor der Installation noch einmal auf deinem Computer und lässt Pro- und Team-Nutzer eigene veröffentlichen. [Lade AgentVera herunter](/de/download/), um deine Skills zu verwalten.

## Häufige Fragen

**Was sind Claude Code Skills?** Wiederverwendbare Anweisungen, verpackt als Ordner mit einer SKILL.md-Datei. Das Frontmatter enthält Name und Beschreibung, der Hauptteil sagt, was zu tun ist. Der Ordner kann auch Skripte und Referenzdateien enthalten, auf die der Skill verweist.

**Wo lege ich einen Claude Code Skill ab?** In .claude/skills/<name>/SKILL.md für ein Projekt, sodass alle im Repo ihn bekommen, oder in ~/.claude/skills/<name>/SKILL.md für dich selbst in allen Projekten.

**Wie entscheidet Claude, einen Skill zu verwenden?** Es sieht die Skill-Beschreibungen und lädt den vollständigen Skill, wenn deine Anfrage zu einem passt. Deshalb sollte die Beschreibung sagen, wann der Skill zu nutzen ist, nicht nur, was er ist. Du kannst ihn auch selbst mit /skill-name starten.

**Sind Skills aus dem Internet sicher zu installieren?** Nicht automatisch. Ein Skill kann deinem Agenten sagen, Befehle auszuführen, Dateien zu lesen oder Daten nach außen zu senden. Lies ihn zuerst. AgentVera prüft Galerie-Skills auf destruktive Befehle, das Lesen von Secrets, ausgehende Daten, Download-und-Ausführen sowie Prompt Injection und prüft vor der Installation auf deinem Computer erneut.

**Kostet die Skill-Galerie von AgentVera Geld?** Skills zu verwalten, zu durchsuchen und zu installieren gehört zum kostenlosen Plan. Eigene Skills in der Galerie zu veröffentlichen erfordert einen Pro- oder Team-Plan und ein AgentVera-Konto.

---

**Über AgentVera.** AgentVera ist eine Desktop-App für macOS, Windows und Linux, entwickelt von Solviera Teknoloji. Sie führt 18 KI-Coding-Agenten (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) nebeneinander aus, pro Projekt, in echten Terminals mit den eigenen CLI-Installationen und Logins des Nutzers. Der kostenlose Plan hat unbegrenzt viele Agenten. Download: https://agentvera.dev/de/download/ · Preise: https://agentvera.dev/de/pricing/