WordPress-Plugins entwickeln mit Claude Code – Teil 2: Skills, Hooks, MCP und Agents

Von /

Von der Grundkonfiguration zum professionellen Entwicklungs-Workflow

Sönke Schäfer, Datenschäfer, SeSoft.de · März 2026

Im ersten Teil haben wir die Grundlagen gelegt: LocalWP als Entwicklungsumgebung, die CLAUDE.md-Hierarchie und die 5 goldenen Regeln für ein sauberes Projektgedächtnis. Damit haben Sie bereits einen funktionierenden Workflow.

Jetzt gehen wir weiter. Claude Code bietet vier fortgeschrittene Features, die Ihren Entwicklungs-Workflow auf ein neues Level heben: Skills für wiederverwendbare Workflows, Hooks als automatische Sicherheitsnetze, MCP-Server für die Anbindung an externe Systeme und Agents für spezialisierte Aufgaben.

Jedes dieser Features baut auf dem vorherigen auf. Wir arbeiten uns Schritt für Schritt vor – mit konkreten Beispielen aus der WordPress-Plugin-Entwicklung.

Skills: Wiederverwendbare Workflows auf Abruf

Was sind Skills?

Erinnern Sie sich an die CLAUDE.md-Regeln und den .claude/rules/-Ordner aus Teil 1? Diese werden immer geladen – bei jeder Session, egal was Sie gerade tun. Skills funktionieren anders: Sie werden nur geladen, wenn sie gebraucht werden. Das spart Tokens und hält den Kontext sauber.

Ein Skill ist im Kern eine Markdown-Datei (SKILL.md) in einem eigenen Ordner. Claude erkennt automatisch, wann ein Skill relevant ist, oder Sie rufen ihn direkt als Slash-Command auf.

Der Unterschied auf einen Blick:

FeatureGeladenZweck
CLAUDE.mdImmer, bei jeder SessionGrundregeln, die immer gelten
.claude/rules/Immer (ggf. pfadspezifisch)Thematisch getrennte Regeln
.claude/skills/Nur bei BedarfWiederverwendbare Workflows

Einen Skill erstellen: Schritt für Schritt

Jeder Skill braucht einen eigenen Ordner mit mindestens einer SKILL.md-Datei. Diese beginnt mit YAML-Frontmatter (Name und Beschreibung) gefolgt von den eigentlichen Anweisungen in Markdown.

Hier ein konkretes Beispiel – ein Skill, der neue Datenbanktabellen nach Ihren Projektkonventionen anlegt:

.claude/skills/
  add-table/
    SKILL.md

Die SKILL.md sieht so aus:

---
name: add-table
description: Erstellt eine neue Datenbanktabelle nach Projekt-Konventionen
  inkl. PHP-Klasse. Nutzen bei "neue Tabelle", "Tabelle anlegen" oder
  "Datenbank erweitern".
---

# Neue Datenbanktabelle anlegen

Wenn eine neue Tabelle erstellt werden soll, folge diesen Konventionen:

## Tabellen-Schema
- Präfix: {$wpdb->prefix}crm_
- Primary Key: INT NOT NULL AUTO_INCREMENT (kein BIGINT, kein UNSIGNED)
- Jede Tabelle hat: created_at DATETIME, updated_at DATETIME, deleted_at DATETIME NULL
- Source-Tracking: source_fk INT NULL, source_name VARCHAR(100), source_url VARCHAR(500)
- Feldnamen auf Deutsch (firma, strasse, telefon, etc.)
- Zeichensatz: DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci

## PHP-Klasse
- Erstelle includes/class-crm-{tabellenname}.php
- Nutze $wpdb->prepare() für alle Queries
- Implementiere CRUD-Methoden: get(), create(), update(), soft_delete()
- PHPDoc-Blöcke für alle public-Methoden

## Workflow
1. Frage nach Tabellenname und Feldern
2. Zeige das CREATE TABLE Statement zur Bestätigung
3. Erstelle die SQL-Migration in sql/
4. Erstelle die PHP-Klasse
5. Aktualisiere docs/architecture.md

Den Skill nutzen

Nach dem Erstellen können Sie den Skill auf zwei Arten nutzen:

Direkt aufrufen:

/add-table

Automatisch: Claude erkennt anhand der Beschreibung, wann der Skill passt. Wenn Sie schreiben „Ich brauche eine neue Tabelle für LinkedIn-Profile“, lädt Claude den Skill selbstständig.

Wann eigene Skills statt Regeln?

Die Faustregel ist einfach: Wenn Sie sich dabei ertappen, denselben Prompt immer wieder einzutippen, wird es Zeit für einen Skill. Typische Kandidaten in WordPress-Projekten:

  • /add-table – Neue DB-Tabelle nach Konventionen
  • /add-api-endpoint – REST-API-Endpoint mit Validierung
  • /add-admin-page – WordPress-Admin-Seite mit Menüeintrag
  • /release-check – Checkliste vor dem Deployment prüfen

Skills steuern: Wer darf was?

Über Frontmatter-Optionen kontrollieren Sie, wer einen Skill aufrufen darf:

---
name: deploy
description: Plugin auf den Live-Server deployen
disable-model-invocation: true
---

Mit disable-model-invocation: true kann nur Sie den Skill aufrufen – Claude wird nie von sich aus deployen. Das ist wichtig für alles mit Seiteneffekten.

Umgekehrt macht user-invocable: false einen Skill zum reinen Hintergrundwissen, das Claude automatisch nutzt, das aber als Slash-Command keinen Sinn ergibt.

Skills mit Zusatzdateien

Skills können mehr als eine einzelne Markdown-Datei enthalten. Für komplexere Workflows legen Sie Referenzdateien im Skill-Ordner ab:

.claude/skills/
  google-places-sync/
    SKILL.md              # Workflow-Anleitung
    field-mapping.md      # Detailliertes Feldmapping (60+ Felder)
    rate-limits.md        # SKU-Preise und Limits

In der SKILL.md verweisen Sie auf die Zusatzdateien. Claude lädt sie nur, wenn es die Details tatsächlich braucht. So bleibt Ihr Kontextfenster schlank, aber das Wissen ist bei Bedarf verfügbar.

Praxis-Tipp: Halten Sie die SKILL.md unter 500 Zeilen. Alles darüber hinaus gehört in Referenzdateien im selben Ordner.

Hooks: Automatische Sicherheitsnetze

Was sind Hooks?

Hooks sind Shell-Skripte, die automatisch bei bestimmten Events innerhalb von Claude Code ausgeführt werden – vor einem Commit, nach einer Dateiänderung, beim Session-Start. Sie sind Ihr Sicherheitsnetz für den Fall, dass Claude etwas tut, das es nicht sollte.

Hooks werden besonders wichtig, wenn Sie Claude Code zunehmend eigenständig arbeiten lassen. Sie schlafen ruhiger, wenn Sie wissen, dass ein Hook verhindert, dass API-Keys ins Git-Repository wandern.

Hooks einrichten

Hooks liegen im .claude/hooks/-Verzeichnis. Hier drei praktische Beispiele:

1. Pre-Commit: Sensible Dateien blockieren

#!/bin/bash
# .claude/hooks/pre-commit.sh
# Verhindert, dass Credentials committed werden

if git diff --cached --name-only | grep -qE '\.(env|key|pem)$|wp-config\.php'; then
  echo "BLOCKED: Sensible Dateien dürfen nicht committed werden"
  exit 1
fi

2. Nach PHP-Änderungen: Coding-Standards prüfen

#!/bin/bash
# .claude/hooks/post-edit-php.sh
# Prüft geänderte PHP-Dateien gegen WordPress-Standards

CHANGED_FILE="$1"
if [[ "$CHANGED_FILE" == *.php ]]; then
  phpcs --standard=WordPress --colors "$CHANGED_FILE" 2>/dev/null
  if [ $? -ne 0 ]; then
    echo "WARNUNG: WordPress-Coding-Standard-Verletzung in $CHANGED_FILE"
  fi
fi

3. Schema-Guard: ODBC-Kompatibilität sicherstellen

#!/bin/bash
# .claude/hooks/schema-guard.sh
# Warnt bei ODBC-inkompatiblen Datentypen

CHANGED_FILE="$1"
if [[ "$CHANGED_FILE" == *.sql ]]; then
  if grep -qiE 'BIGINT|UNSIGNED' "$CHANGED_FILE"; then
    echo "WARNUNG: BIGINT oder UNSIGNED gefunden in $CHANGED_FILE"
    echo "Diese Datentypen sind nicht ODBC/Access-kompatibel."
    echo "Verwende INT ohne UNSIGNED stattdessen."
  fi
fi

Vergessen Sie nicht, die Skripte ausführbar zu machen:

chmod +x .claude/hooks/*.sh

Wichtig: Hooks sind kein Ersatz für Code-Reviews. Sie fangen die offensichtlichen Fehler ab und geben Ihnen ein zusätzliches Sicherheitsnetz – besonders wenn Claude Code längere Aufgaben autonom erledigt.

MCP-Server: Claude an externe Systeme anbinden

Was ist MCP?

Das Model Context Protocol (MCP) ist ein standardisiertes Protokoll, mit dem Claude Code auf externe Tools, Datenbanken und APIs zugreift. Stellen Sie sich MCP als universellen Adapter vor: Einmal angeschlossen, kann Claude direkt mit dem jeweiligen System arbeiten – ohne dass Sie Daten manuell hin- und herkopieren müssen.

Die wichtigsten MCP-Server für WordPress-Entwickler

MariaDB/MySQL: Direkter Datenbankzugriff

Das ist vermutlich der größte Produktivitätsgewinn. Statt SQL-Ergebnisse manuell in Claude zu kopieren, kann Claude Ihre Datenbank direkt abfragen:

claude mcp add --transport stdio mysql-db \
  -- npx -y @anthropic/mysql-mcp-server \
  --host localhost --port 10025 --database local

Danach können Sie Dinge sagen wie:

  • „Zeige mir die 10 Firmen mit den meisten Duplikaten“
  • „Prüfe, ob alle Tabellen die deleted_at-Spalte haben“
  • „Erstelle einen Index auf crm_companies.plz“

Claude schreibt die Queries, führt sie aus und interpretiert die Ergebnisse – alles in einer Konversation. Bei einem CRM mit zehntausenden Datensätzen und über einem Dutzend Tabellen spart das enorm viel Zeit.

GitHub: Versionskontrolle automatisieren

claude mcp add --transport stdio github \
  -- npx -y @anthropic/github-mcp-server

Damit kann Claude Code direkt Issues erstellen, Pull Requests anlegen und Commit-Historien durchsuchen. Besonders nützlich, wenn mehrere Personen am Projekt arbeiten und Änderungen nachvollziehbar sein sollen.

Filesystem: Erweiterter Dateizugriff

claude mcp add --transport stdio filesystem \
  -- npx -y @anthropic/filesystem-mcp-server \
  --root ~/Daten/access-export/

Damit hat Claude Zugriff auf Verzeichnisse außerhalb des Projektordners – zum Beispiel auf Access-Exportdateien, die importiert werden sollen.

MCP-Server verwalten

MCP-Server gibt es in drei Scopes:

ScopeKonfigurationSichtbar für
localNur lokalNur Sie, nur dieses Projekt
project.mcp.json im Projekt-RootAlle Teammitglieder
user~/.claude/Sie, in allen Projekten

Nützliche Befehle:

# Alle konfigurierten Server anzeigen
claude mcp list

# Server-Status im laufenden Betrieb
/mcp

# Server entfernen
claude mcp remove mysql-db

⚠ Kosten und Kontext: Jeder aktive MCP-Server verbraucht Kontext. Wenn Sie viele Server gleichzeitig laufen haben, prüfen Sie mit /context, wie viel Kontextfenster noch frei ist. Entfernen Sie Server, die Sie aktuell nicht brauchen.

Praxis-Beispiel: Datenbank-Analyse per Sprache

Ein typischer Arbeitsablauf mit dem MariaDB-MCP-Server:

Sie: „Wie viele Firmen haben keine Telefonnummer?“

Claude: Führt SELECT COUNT(*) FROM wp_crm_companies WHERE telefon IS NULL OR telefon = '' aus, gibt Ihnen das Ergebnis und schlägt vor, einen Batch-Job zu schreiben, der fehlende Nummern über die Google Places API nachschlägt – unter Berücksichtigung Ihres Rate-Limits von 300 pro Monat.

Das ist der Moment, in dem CLAUDE.md, Skills und MCP zusammenspielen: Claude kennt Ihre Konventionen (CLAUDE.md), weiß wie die Google-Places-Integration funktioniert (Skill), und kann die Datenbank direkt abfragen (MCP).

Agents und Sub-Agents: Aufgaben delegieren

Custom Agents: Spezialisierte Perspektiven

In .claude/agents/ können Sie spezialisierte Agenten definieren. Ein Agent ist im Grunde eine erweiterte CLAUDE.md mit einem festen Fokus und optional eingeschränktem Tool-Zugriff.

# .claude/agents/db-architect.md
---
name: db-architect
description: Prüft und optimiert Datenbankstrukturen
allowed-tools: [Read, Write, Bash]
---

Du bist ein Datenbank-Architekt für WordPress/MariaDB.
Dein Fokus:
- Schema-Design und Normalisierung
- Index-Optimierung
- Query-Performance
- ODBC-Kompatibilität mit Microsoft Access

Wenn du Änderungen vorschlägst, zeige immer:
1. Das aktuelle Schema
2. Die vorgeschlagene Änderung
3. Die Auswirkung auf bestehende Queries
4. Mögliche Probleme mit Access/ODBC

Starten Sie den Agent mit:

/agent db-architect

Weitere nützliche Agents für die Plugin-Entwicklung:

  • code-reviewer.md – Prüft Code auf WordPress-Standards und Sicherheitslücken
  • migration-planner.md – Plant Datenbank-Migrationen mit Rollback-Strategie
  • api-designer.md – Entwirft REST-Endpoints nach WordPress-Konventionen

Sub-Agents: Parallele Aufgaben

Claude Code kann Teilaufgaben an Sub-Agents delegieren, die parallel arbeiten. Das ist besonders bei größeren Refactoring-Aufgaben wertvoll:

Sie: „Spawne einen Agent, der alle 16 Tabellen auf ODBC-Kompatibilität prüft, und einen zweiten, der die PHPDoc-Blöcke in includes/ aktualisiert.“

Beide Agents arbeiten gleichzeitig. Claude fasst die Ergebnisse zusammen, sobald beide fertig sind.

Praxis-Tipp: Sub-Agents eignen sich hervorragend für Aufgaben, die unabhängig voneinander sind: Code-Review + Dokumentation, Schema-Prüfung + Test-Generierung, Frontend-Anpassung + API-Erweiterung.

Alles zusammen: So arbeiten die Features im Team

Die wahre Stärke von Claude Code zeigt sich, wenn alle Features zusammenspielen. Hier ein realistisches Szenario aus der Plugin-Entwicklung:

Aufgabe: „Füge eine LinkedIn-Profil-Verwaltung zum CRM hinzu.“

So arbeiten die Features zusammen:

  1. CLAUDE.md liefert die Grundregeln: Deutsche Feldnamen, Soft-Delete, INT-PKs, Access-Kompatibilität
  2. Skill /add-table generiert die Tabelle wp_crm_linkedin_profiles mit allen Konventionen
  3. Hook schema-guard.sh prüft automatisch, ob kein BIGINT oder UNSIGNED im SQL gelandet ist
  4. MCP MariaDB führt das CREATE TABLE direkt aus und verifiziert das Ergebnis
  5. Agent code-reviewer prüft die neue PHP-Klasse auf WordPress-Standards
  6. MCP GitHub erstellt einen Commit mit aussagekräftiger Nachricht

Was früher einen halben Tag dauerte, erledigt dieser Workflow in unter einer Stunde – und das Ergebnis ist konsistenter, weil jede Ebene ihre eigenen Qualitätschecks beisteuert.

Die Lern-Roadmap: Schritt für Schritt

Arbeiten Sie sich in dieser Reihenfolge vor. Jede Stufe baut auf der vorherigen auf:

WocheThemaZiel
1–2Skills erstellen2–3 Skills für Ihre häufigsten Workflows (/add-table, /add-admin-page)
3Hooks einrichtenPre-Commit-Schutz + PHP-Coding-Standard-Prüfung
4–5MCP: MariaDBClaude hat direkten Zugriff auf Ihre CRM-Datenbank
6MCP: GitHubVersionskontrolle automatisieren
7–8Custom AgentsDB-Architect + Code-Reviewer für Ihr Projekt
9+Sub-AgentsParallele Aufgaben bei größeren Features

Wichtig: Versuchen Sie nicht, alles auf einmal einzurichten. Beginnen Sie mit einem einzelnen Skill für Ihren häufigsten Workflow. Sobald der zuverlässig funktioniert, fügen Sie den nächsten Baustein hinzu.

Checkliste: Von Teil 1 zu Teil 2

Wenn Sie die Grundlagen aus Teil 1 umgesetzt haben, sind das Ihre nächsten Schritte:

  1. Identifizieren Sie Ihren häufigsten wiederholten Prompt → daraus wird Ihr erster Skill
  2. Erstellen Sie .claude/skills/ mit einem Ordner und einer SKILL.md
  3. Testen Sie den Skill mit /skill-name und durch natürliche Sprache
  4. Richten Sie einen Pre-Commit-Hook gegen sensible Dateien ein
  5. Installieren Sie den MariaDB-MCP-Server für Ihr LocalWP-Projekt
  6. Erstellen Sie einen ersten Custom Agent für Code-Review oder DB-Architektur

Fazit

Skills, Hooks, MCP und Agents verwandeln Claude Code von einem cleveren Assistenten in ein professionelles Entwicklungssystem. Jede Ebene fügt eine neue Dimension hinzu: Skills machen Workflows wiederholbar, Hooks garantieren Qualität, MCP verbindet Claude mit Ihren Systemen, und Agents ermöglichen paralleles Arbeiten mit verschiedenen Perspektiven.

Das Schöne daran: Alles ist Markdown und Shell-Skripte. Keine neuen Programmiersprachen, keine komplexen Konfigurationen. Wenn Sie PHP und SQL beherrschen, haben Sie alles, was Sie brauchen.

Fragen zu den fortgeschrittenen Features oder Hilfe bei der Einrichtung? Als Datenschäfer bringe ich Ordnung in Ihre Daten – und in Ihren Entwicklungs-Workflow.

© 2026 sesoft.de · Alle Rechte vorbehalten.

Ähnliche Beiträge

Nach oben scrollen