Claude-Code-Vorlagen: Skills, Agents, Hooks und mehr

Was sind Claude-Code-Vorlagen?

Claude-Code-Vorlagen sind wiederverwendbare Konfigurationsdateien, die steuern, wie sich Claude Code in einem Projekt oder in deiner lokalen Umgebung verhält. 

Wichtig ist: Vorlagen sind dateibasiert. Du installierst sie nicht über ein klassisches Einstellungsmenü und klickst dich durch Masken. Stattdessen entdeckt Claude Code bestimmte Dateien und Ordner, lädt die relevanten Metadaten in den Kontext und entscheidet anhand dieser Infos, wie es sich verhalten soll.

In der Praxis sind es meist Markdown-, JSON- oder Shell-Dateien auf Projektebene, z. B. im Ordner .claude/, oder sie werden für die Weitergabe in Plugin-Verzeichnissen gebündelt.

Eine typische Projektstruktur könnte so aussehen:

my-app/
├── CLAUDE.md
├── .mcp.json
└── .claude/
    ├── skills/
    │   └── database-migration/
    │       └── SKILL.md
    ├── agents/
    │   └── security-auditor.md
    ├── commands/
    │   └── summarize-pr.md
    └── settings.json

Claude-Code-Vorlagen vs CLAUDE.md

CLAUDE.md bleibt wichtig, erfüllt aber eine andere Rolle. Denk an CLAUDE.md als Projektbriefing: Was das Projekt ist, welche Befehle relevant sind, welche Coding-Standards gelten und an welche Architekturkonventionen sich Claude erinnern soll. 

Für eine ausführliche Anleitung siehe unseren CLAUDE.md-Schreibguide.

Vorlagen sind modularer:

• Ein Skill kann einen Migrations-Workflow abbilden. 
• Ein Agent kann eine Security-Review-Persona kapseln. 
• Ein Hook kann nach Dateiänderungen laufen. 
• Eine MCP-Konfiguration kann Claude mit GitHub, SQLite oder einem anderen externen System verbinden.

Hier verbinden sich Vorlagen auch mit dem übergreifenden Workflow-Design in Claude Code. Starke Vorlagen wirken am besten zusammen mit guten Gewohnheiten in Planung, Testing und Kontextübergabe. 

Mehr zu solchen Praktiken findest du in unserem Best-Practices-Guide.

Eigene Commands werden ebenfalls über das Skills-System abgedeckt, auch wenn das ältere Format .claude/commands/ weiterhin funktioniert. Das empfohlene neue Format ist .claude/skills/<name>/SKILL.md, das Slash-Command-Aufrufe und automatische Ausführung durch Claude unterstützt.

Welche Arten von Claude-Code-Vorlagen kann ich nutzen?

Das Ökosystem von Claude-Code-Vorlagen gliedert sich typischerweise in sechs Kategorien: Skills, Agents, Commands, Hooks, MCP-Integrationen und Plugins. 

Die ersten fünf verändern das Verhalten von Claude direkt. Plugins sind etwas anders: Sie sind ein Distributionsformat, das Skills, Agents, Hooks, Commands, MCP-Server und andere Komponenten zu einem wiederverwendbaren Paket bündelt.

Wir schauen uns alle Kategorien im Detail an.

1. Skills

Skills sind Anweisungspakete für wiederholbare Aufgaben mit mehreren Schritten. Ein Skill ist meist ein Ordner mit einer SKILL.md-Datei, bestehend aus YAML-Frontmatter und Markdown-Body. 

Das Frontmatter beschreibt, was der Skill tut und wie er sich verhalten soll; der Body legt die Schritte fest, denen Claude folgen soll. Ein Deep-Dive dazu findest du im Guide zu Claude Skills.

Claude nutzt die Skill-Beschreibung, um zu entscheiden, wann der Skill relevant ist. Standardmäßig können sowohl du als auch Claude einen Skill auslösen: Du kannst /skill-name tippen, oder Claude lädt ihn automatisch, wenn die aktuelle Aufgabe zur Beschreibung passt. Du kannst die automatische Ausführung auch abschalten, etwa bei Deployments, wo du manuelle Kontrolle willst.

Hier ein kurzes Beispiel für die Datei: .claude/skills/database-migration/SKILL.md

---
name: database-migration
description: Use when creating, reviewing, or modifying database migrations. Ensures migrations are reversible, tested, and checked before and after execution.
allowed-tools:
  - Read
  - Write
  - Bash
---

# Database Migration Skill

When working on a database migration:

1. Inspect the existing schema and migration history before writing changes.
2. Confirm whether the migration is additive, destructive, or data-transforming.
3. Create a reversible migration whenever the framework supports rollback.
4. Run the project’s migration check command before applying the migration.
5. Run tests that cover the affected models, queries, or API endpoints.
6. After writing the migration, summarize:
   - schema changes
   - rollback behavior
   - affected tables
   - test commands run

Das ist nützlich, weil die Anweisungen prozedural sind. Du sagst Claude nicht nur „Sei vorsichtig bei Migrationen“, sondern gibst ihm eine wiederholbare Checkliste. 

Skills eignen sich für alles, was du Claude sonst mehr als zweimal einfügen würdest: API-Endpunkte generieren, Changelogs schreiben, Tests aufsetzen, Release Notes erstellen, Pull Requests reviewen oder Migrationschecks durchführen.

Für mehr Inspiration, welche Workflows Entwickler in wiederverwendbare KI-Abläufe verwandeln, sieh dir unsere Liste der Agent Skills an.

2. Agents

Agents, genauer gesagt Custom-Subagents in Claude Code, sind spezialisierte KI-Assistenten mit eigener Markdown-Definition, YAML-Frontmatter, Tool-Einschränkungen, Modellwahl und System-Prompt. 

Sie können in .claude/agents/ für Projekt-Scope oder in ~/.claude/agents/ für persönlichen Scope liegen. Agents erstellst du, indem du Claude bittest oder Markdown-Dateien im Ordner .claude/agents/ direkt bearbeitest.

Zwischen Skills und Agents gibt es tatsächlich einen Unterschied. Ein Skill definiert, wie eine Aufgabe auszuführen ist. Ein Agent definiert, wer Claude bei der Arbeit sein soll: Rolle, Fokus, Berechtigungen und Grenzen.

Hier ein Beispiel für einen Agent:

---
name: security-auditor
description: Reviews code for security vulnerabilities and produces a findings report without modifying files.
tools: Read, Glob, Grep, Bash
model: sonnet
---

You are a security auditor.

Your task is to inspect the codebase for vulnerabilities, risky patterns, and missing safeguards.

Rules:
- Do not edit files.
- Do not suggest broad rewrites unless directly tied to a security issue.
- Focus on authentication, authorization, input validation, secrets, dependency risk, and unsafe shell or SQL usage.
- Produce a findings report with severity, affected files, evidence, and recommended next steps.

Dieser Agent ist hilfreich, weil er Claude klare Grenzen setzt. In einer allgemeinen Session könnte Claude sofort mit dem Fixen beginnen, sobald es ein Problem findet. Ein Security-Auditor-Agent soll hingegen nur prüfen und berichten – keine Änderungen. 

Agents eignen sich für spezialisierte Domänen wie Security-Audits, Dokumentations-Reviews, Architektur-Reviews, Data Engineering oder Codequalitätschecks, wo Kontextisolierung und Berechtigungsgrenzen wichtig sind.

Agents sind auch in Kombination mit spezialisierten Skills nützlich. Ein Security-Auditor-Agent könnte z. B. einen Findings-Report-Skill aufrufen, während ein Frontend-Reviewer-Agent einen Component-Testing-Skill nutzt.

3. Commands

Commands sind Slash-Shortcuts wie /generate-tests, /check-deps oder /summarize-pr. Historisch wurden eigene Commands als Markdown-Dateien unter .claude/commands/ gespeichert, wobei der Dateiname als Command-Name diente. 

Claude Code unterstützt dieses ältere Format weiterhin, aber für neue, command-ähnliche Workflows empfehle ich Skills, da sie denselben /name-Aufruf und bei Bedarf automatische Ausführung unterstützen.

Commands sind ideal, wenn der Auslöser ausdrücklich sein soll. Ein Skill kann automatisch aktiv werden, wenn Claude eine passende Aufgabe erkennt, aber ein Command soll nur laufen, wenn du es startest. Das macht Commands nützlich als Checkpoints: „Jetzt Tests generieren“, „Diesen PR jetzt zusammenfassen“, „Abhängigkeiten jetzt prüfen“ oder „Jetzt eine Commit-Message vorbereiten“.

4. Hooks

Hooks sind Automationsregeln, die auf Lebenszyklusereignisse von Claude Code reagieren. Es sind benutzerdefinierte Shell-Befehle, die an bestimmten Punkten im Claude-Code-Lebenszyklus laufen und dir deterministische Kontrolle über das Verhalten geben. 

Der Unterschied zu den bislang genannten Vorlagen: Hooks werden nicht durch deine Anfrage ausgelöst, sondern durch das, was Claude tut.

Einfach gesagt: Du musst nicht hoffen, dass Claude nach dem Editieren eine Datei formatiert; ein Hook erledigt das automatisch.

Aktuelle Hook-Events umfassen z. B. PreToolUse, PostToolUse, Notification und Stop. 

Beispiel: Einen Formatter ausführen, nachdem Claude eine Datei editiert oder geschrieben hat:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Example: block risky shell commands before Claude runs them:
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/block-dangerous-bash.py"
          }
        ]
      }
    ]
  }
}

Hooks eignen sich am besten für Regeln, die Claude nicht umgehen darf: Linter ausführen, geänderte Dateien formatieren, geschützte Dateien vor Änderungen bewahren, generierten Code prüfen oder Benachrichtigungen senden, wenn Claude Eingaben braucht. 

Für ein ausführliches Tutorial lies unseren Claude-Code-Hooks-Guide.

5. MCP-Integrationen

MCP-Integrationen verbinden Claude Code über das Model Context Protocol mit externen Tools, Datenquellen und APIs. MCP fungiert als Verbindungsschicht zwischen KI-Systemen und externen Tools. In Claude Code kann Claude damit über lokale Dateien und Shell-Befehle hinausgehen. 

So kann Claude – je nach konfigurierten MCP-Servern – mit externen Diensten wie GitHub, Datenbanken, DMS, Cloud-Plattformen oder internen APIs interagieren. Für eine vollständige Erklärung und ein Demoprojekt siehe unser Tutorial zum Model Context Protocol.

Ein MCP-Server kann drei grobe Fähigkeitstypen bereitstellen:

• Tools: ausführbare Funktionen, die Claude aufrufen kann, z. B. ein GitHub-Issue erstellen oder eine Datenbankabfrage ausführen.
• Resources: schreibgeschützte Kontextquellen wie eine Datei, Datenbankzeile oder ein Dokument.
• Prompts: wiederverwendbare Aufgaben-Templates, die der Server bereitstellt.

Eine Projektdatei .mcp.json kann mehrere Server parallel konfigurieren:

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sqlite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "./data/app.db"
      ]
    }
  }
}

Das ist wichtig, weil Claude nur mit Kontext und Tools arbeiten kann, auf die es Zugriff hat. Ohne MCP kann es lokale Dateien inspizieren, aber nicht dein Issue-Tracker, deine Datenbank, Cloud-Umgebung oder interne API. 

MCP ist die richtige Wahl, wenn Claude mit deinem realen Stack statt mit einem statischen Codesnapshot arbeiten und auf externe Daten zugreifen soll.

6. Plugins

Plugins sind gebündelte Pakete. Sie können Skills, Agents, Hooks, MCP-Konfigurationen, Commands und andere Komponenten in einer einzigen installierbaren Struktur enthalten. 

In Claude Code umfasst ein Plugin typischerweise ein Manifest .claude-plugin/plugin.json sowie Komponentenordner wie skills/, agents/, hooks/ und .mcp.json im Plugin-Root.

Beispielhafte Plugin-Struktur:

frontend-workflow-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── component-test/
│       └── SKILL.md
├── agents/
│   └── frontend-reviewer.md
├── hooks/
│   └── hooks.json
└── .mcp.json

Beispiel für eine Plugin-JSON:

{
  "name": "frontend-workflow",
  "displayName": "Frontend Workflow",
  "version": "1.0.0",
  "description": "Frontend-Entwicklungsworkflow mit Review-Agents, Test-Skills und Formatting-Hooks",
  "author": {
    "name": "Your Team"
  }
}

Plugins fügen keinen neuen Verhaltenstyp hinzu. Sie machen die anderen Typen portabel. Nutze Plugins, wenn du ein komplettes Setup im Team teilen, denselben Workflow über Projekte hinweg wiederverwenden oder statt vieler Einzelschritte ein Community-Bundle installieren möchtest.

Zum eigenen Aufbau findest du bei DataCamp die Schritt-für-Schritt-Anleitung für Claude-Code-Plugins.

Welchen Vorlagentyp soll ich wählen?

Verständlich – die vielen Typen können verwirren. Alle können Claudes Verhalten ändern. Der Unterschied liegt vor allem darin, wie sie ausgelöst werden und welche Kontrolle sie bieten.

Zur Orientierung hier ein Vergleich:

Eine einfache Entscheidungsregel hilft:

• Wenn du eine Regel automatisch durchsetzen willst, sobald Claude Code berührt, nutze einen Hook. 
• Wenn Claude für eine Aufgabe tiefe Fachexpertise annehmen soll, nutze einen Agent. 
• Wenn du einen Workflow festhalten willst, den Claude konsequent wiederholt, nutze einen Skill. 
• Wenn du eine Aktion selbst zum richtigen Zeitpunkt auslösen willst, nutze einen Command oder einen command-ähnlichen Skill. 
• Wenn Claude externe Dienste oder Live-Daten braucht, nutze MCP. 
• Wenn du ein komplettes Workflow-Setup installieren oder teilen möchtest, nutze ein Plugin.

In realen Projekten werden diese Typen meist kombiniert. Ein Security-Plugin kann z. B. einen security-auditor-Agent, einen audit-findings-Skill, einen Dependency-Check-Command und einen Pre-Commit-Hook bündeln. Der Agent definiert die Rolle, der Skill die Reportstruktur, der Command gibt dir einen expliziten Checkpoint und der Hook setzt die Leitplanke durch.

Für Workflows, bei denen Claude einem formalen Plan folgen soll, bevor die Umsetzung startet, ist spec-driven development oft die bessere Wahl als Ad-hoc-Prompts.

Wo finde ich Claude-Code-Vorlagen?

Es gibt drei praktikable Quellen: Anthropic, Community-Sammlungen und dich selbst.

Erstens: Starte mit offiziellen Anthropic-Ressourcen und Dokumentation. Die Claude-Code-Dokumentation von Anthropic deckt Skills, Subagents, Hooks, MCP und Plugins ab und ist die beste Quelle, um aktuelle Dateiformate und Verhaltensweisen zu verifizieren, bevor du etwas produktiv einsetzt.

Zweitens: Nutze Community-Sammlungen. Der sichtbarste Community-Hub ist aitmpl.com – ein Katalog fertig nutzbarer Konfigurationen für Claude-Code-Projekte. Die Live-Navigation umfasst aktuell Skills, Agents, Commands, Settings, Hooks, MCPs und Plugins. 

Der aktuelle interaktive Installationsbefehl lautet:

npx claude-code-templates@latest

Die Projektdoku zeigt auch ein kürzeres Alias:

npx cct@latest

Für einzelne Komponenten listet das GitHub-README Installationsbefehle wie:

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

Auch eine Batch-Installation eines vollständigen Stacks mit mehreren Flags in einem Befehl wird gezeigt.

Bei der Bewertung von Community-Vorlagen achte auf folgende Qualitätsmerkmale:

• Ist die description präzise genug, damit Claude den Skill oder Agent korrekt auslöst?

• Sind die allowed-tools eng gefasst, oder fordert die Vorlage unnötig breite Write- und Bash-Rechte?

• Wurde das Repository kürzlich gepflegt?

• Erklärt die Vorlage, was sie verändert?

• Enthält sie Hooks oder MCP-Server, die Code ausführen, den du nicht geprüft hast?

Drittens: Schreibe deine eigenen. Das ist meist die beste Lösung für Workflows, die eng mit deinem Stack verzahnt sind. Eine Community-Vorlage ist ein guter Startpunkt, kennt aber nicht deine internen Migrationsrichtlinien, Namenskonventionen, dein Datenmodell oder eure Risikotoleranz beim Deployment.

Fazit

Claude-Code-Vorlagen machen aus Claude Code mehr als einen Session-Assistant – sie formen eine dauerhafte Entwicklungsumgebung. 

Die sechs Kategorien sind eigentlich Schichten: Skills bilden Workflows ab, Agents definieren Rollen, Commands schaffen explizite Aktionen, Hooks setzen Leitplanken durch, MCP bindet externe Systeme an, und Plugins packen alles zur Wiederverwendung zusammen.

Der beste Start ist kein riesiges Plugin-Bundle. Starte mit einem Skill für deinen am häufigsten wiederholten Workflow. Sobald klar wird, wo Claudes Standardverhalten noch Reibung erzeugt, ergänze einen spezialisierten Agent, einen Hook zur Durchsetzung oder einen MCP-Server für Live-Zugriff auf Systeme.

Mehr Lernmaterial zu Claude Code findest du in unseren Kursen Claude Code 101 und Claude Code in Action.