Claude Code agents vs skills: was wann nutzen?

Claude Code agents vs skills ist eine der ersten Fragen, sobald ein Setup über eine einzelne CLAUDE.md-Datei hinauswächst. Beide liegen in .claude/, beide sind Markdown mit ein paar Zeilen YAML oben dran, und beide können automatisch ausgelöst werden. Sie lösen aber unterschiedliche Probleme – und wer sie verwechselt, macht sein Setup langsam und schwer berechenbar.

Kurz gefasst: Ein Skill bringt Know-how in das Gespräch, in dem Sie sich gerade befinden; ein Subagent erledigt eine Aufgabe in einem eigenen Kontext und bringt nur das Ergebnis zurück. Alles Folgende orientiert sich an der offiziellen Dokumentation zu Subagents und Skills. Wir nutzen beides täglich in unserem eigenen Studio, und die Regel am Ende stammt aus dieser Arbeit.

Was ein Subagent ist

Ein Subagent ist ein spezialisierter Assistent, der in seinem eigenen Kontextfenster läuft – mit eigenem System-Prompt, eigenem Tool-Zugriff und eigenen Berechtigungen. Er sieht Ihren Gesprächsverlauf nicht. Claude schreibt ihm eine Aufgabe, der Subagent arbeitet, und zurück kommt nur eine Zusammenfassung.

Genau das ist der Punkt: Eine Nebenaufgabe, die das Hauptgespräch mit Suchergebnissen, Logs oder Dateiinhalten fluten würde, bleibt im Subagent.

---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

Speichern Sie ihn als .claude/agents/code-reviewer.md für ein einzelnes Projekt oder als ~/.claude/agents/code-reviewer.md für alle. Nur name und description sind Pflicht. tools ist eine Allowlist: Lassen Sie es weg, bekommt der Subagent jedes Tool, das für Subagents verfügbar ist.

Claude delegiert von selbst, wenn eine Aufgabe zur Beschreibung passt. Sie können ihn auch namentlich aufrufen oder als @"code-reviewer (agent)" erwähnen, um sicherzugehen, dass er läuft. Claude Code bringt außerdem eingebaute Subagents mit, etwa Explore für schnelle Nur-Lese-Suchen und Plan für Recherche im Plan-Modus.

Was ein Skill ist

Ein Skill ist ein Ordner mit einer SKILL.md-Datei: Anweisungen plus optionale Zusatzdateien wie Referenznotizen oder Skripte. Er läuft im Hauptgespräch, nicht in einem eigenen Kontext.

---
name: summarize-changes
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

Summarize the uncommitted changes in two or three bullet points,
then list anything risky: deleted files, changed permissions, new dependencies.

Speichern Sie ihn als .claude/skills/summarize-changes/SKILL.md. Standardmäßig können sowohl Sie als auch Claude ihn nutzen: Sie tippen /summarize-changes, oder Claude lädt ihn, wenn Ihre Anfrage zur Beschreibung passt.

Das Detail, das für die Kosten zählt: In einer normalen Session stehen nur die Beschreibungen der Skills im Kontext. Der volle Inhalt wird geladen, wenn der Skill benutzt wird. Lange Referenzmaterialien in einem Skill kosten also fast nichts, bis sie gebraucht werden – anders als Text in CLAUDE.md, der immer da ist.

Eigene Slash-Befehle sind heute Teil der Skills: .claude/commands/deploy.md und .claude/skills/deploy/SKILL.md erzeugen beide /deploy.

Claude Code agents vs skills im direkten Vergleich

	Subagent	Skill
Wo er läuft	eigenes Kontextfenster	das Hauptgespräch
Sieht Ihr Gespräch	nein	ja
Was zurückkommt	eine Zusammenfassung	die Arbeit geschieht direkt
Datei	.claude/agents/name.md	.claude/skills/name/SKILL.md
Typischer Auslöser	Claude delegiert eine Aufgabe	Claude oder Sie mit /name
Gut für	Suchen, Reviews, lange Nebenaufgaben	Abläufe, Hausregeln, Referenz

Sie lassen sich auch kombinieren. Ein Subagent kann über sein Feld skills Skills vorladen, sodass ein Reviewer direkt mit Ihrer Checkliste startet. Und ein Skill mit context: fork läuft in einem Subagent: Der Skill-Text wird zur Aufgabe, und Ihr Hauptkontext bleibt sauber.

Eine einfache Entscheidungsregel

Stellen Sie eine Frage: Brauche ich die Details dieser Arbeit später im Gespräch?

• Nein, nur das Ergebnis. Nutzen Sie einen Subagent. Eine große Codebase durchsuchen, einen Diff reviewen, lange Logs lesen: Sie wollen die Schlussfolgerung, nicht jede geöffnete Datei.
• Ja, es ist Teil dessen, was ich gerade tue. Nutzen Sie einen Skill. Eine Release-Checkliste, Ihr Format für Commit-Messages, wie Ihr Projekt Dinge benennt: Wissen, an das sich das Gespräch halten soll.

Zwei Warnsignale aus der Praxis: Wenn ein Abschnitt in CLAUDE.md zu einer Schritt-für-Schritt-Anleitung ausgewachsen ist, will er ein Skill sein. Wenn ein Skill ständig Dutzende Dateien ins Gespräch zieht, will er context: fork oder ein Subagent sein.

Fehler, die ein Setup unberechenbar machen

1. Vage Beschreibungen. Beide werden über ihre description ausgewählt. „Hilft bei Code“ passt auf alles und nichts. Sagen Sie, was es tut und wann man es nutzt.
2. Zu viele lange Beschreibungen. Beschreibungen werden zu Beginn jeder Session geladen. Halten Sie sie kurz und packen Sie Details in den Inhalt.
3. Ein Subagent mit allen Tools standardmäßig. Wenn ein Reviewer nur lesen soll, geben Sie ihm Read, Glob, Grep – und nichts sonst.
4. Regeln, die gelten müssen, als Skill geschrieben. Ein Skill leitet an, er erzwingt nichts. Für „das hier nie tun“ nutzen Sie Berechtigungsregeln und Hooks, wie in unserem Artikel zu Claude Code Hooks.

Wann Sie es abgeben sollten

Wenn Ihr .claude/-Ordner schnell gewachsen ist und niemand mehr weiß, welcher Agent oder Skill was tut, kartieren wir das Setup, räumen Agents und Skills auf und ergänzen getestete Regeln. Wie unser eigenes System aufgebaut ist, sehen Sie auf der Arbeitsseite.

Fragen

Ist ein Skill nur ein gespeicherter Prompt?

Fast, aber es ist mehr. Ein Skill ist ein Ordner mit einer SKILL.md-Datei und optionalen Zusatzdateien. Claude sieht zunächst nur die Beschreibung, kann den Skill bei passender Aufgabe selbst laden, und Sie können ihn auch als /skill-name aufrufen.

Sehen Subagents mein Gespräch?

Nein. Jeder Subagent startet mit einem frischen Kontextfenster: eigenem System-Prompt, der Aufgabe, die Claude ihm schreibt, CLAUDE.md und optional vorgeladenen Skills. Zurück in das Hauptgespräch kommt nur eine Zusammenfassung.

Was ist aus eigenen Slash-Befehlen geworden?

Sie sind in Skills aufgegangen. Eine Datei unter .claude/commands/deploy.md und ein Skill unter .claude/skills/deploy/SKILL.md erzeugen beide /deploy. Alte Befehlsdateien funktionieren weiterhin.

Kann ich beides gleichzeitig nutzen?

Ja, in beide Richtungen. Ein Subagent kann über sein Feld skills Skills vorladen, und ein Skill mit context: fork läuft in einem Subagent statt im Hauptgespräch.