Plugin Structure for Claude Code

Offizieller Anthropic-Skill für Verzeichnisstruktur, Manifest, Komponenten und automatische Erkennung von Claude-Code-Plugins.

Plugin Structure for Claude Code ist ein offizieller Skill aus dem Repository claude-plugins-official von Anthropic. Er richtet sich an Entwicklerinnen, Entwickler und Coding-Agenten, die ein Claude-Code-Plugin neu anlegen, ein bestehendes Plugin ordnen oder die automatische Erkennung seiner Bestandteile nachvollziehbar konfigurieren wollen. Der Skill ist kein ausführbares Plugin, kein eigenständiger Agent und kein Ersatz für Claude Code. Er liefert eine präzise, wiederverwendbare Wissensgrundlage für die Architekturentscheidung rund um ein Plugin.

Was der Skill erklärt

Im Zentrum steht die klare Trennung zwischen dem Plugin-Stammverzeichnis und dem Verzeichnis .claude-plugin. Die Datei plugin.json gehört in .claude-plugin und beschreibt die Identität des Plugins. Verzeichnisse für Skills, Agents, Commands und Hooks liegen dagegen direkt im Plugin-Stamm. Diese Unterscheidung ist wichtig, weil Claude Code die Komponenten nach Konventionen automatisch sucht. Ein Plugin kann außerdem eine MCP-Konfiguration, eine LSP-Konfiguration, Monitore, Skripte und Standardeinstellungen im Stammverzeichnis enthalten. Der Skill erklärt, welche dieser Bausteine optional sind und warum ein minimales Manifest oft wartbarer bleibt als eine unnötig umfangreiche Konfiguration.

Laut Anbieter sollte ein Plugin für neue Projekte den skills-Ordner mit einem Unterverzeichnis je Skill verwenden. In jedem Skill-Verzeichnis liegt eine Datei namens SKILL.md mit YAML-Frontmatter und einer Beschreibung, anhand derer Claude den Skill bei passenden Aufgaben aktivieren kann. Commands und Agents werden als Markdown-Dateien organisiert. Hooks werden in hooks.json definiert, während ein .mcp.json externe MCP-Server beschreiben kann. Die Anleitung zeigt auch, wie ein Plugin mit genau einem Skill direkt am Stamm beginnen kann und wann der Wechsel zu einem skills-Ordner sinnvoll ist.

Portable Pfade und Namensräume

Ein praktischer Schwerpunkt ist die Variable CLAUDE_PLUGIN_ROOT. Der Skill empfiehlt, sie in Hook-Befehlen, MCP-Argumenten, Skripten und Ressourcenpfaden einzusetzen, statt absolute Pfade, Arbeitsverzeichnisannahmen oder Home-Verzeichnis-Abkürzungen einzubauen. Dadurch bleibt ein Plugin nach Installation an unterschiedlichen Orten portierbar. Claude-Code-Plugins erhalten außerdem einen Namensraum für ihre Skills und Commands. Ein klarer kebab-case-Name in plugin.json verhindert Konflikte mit anderen Erweiterungen und macht Aufrufe im Hilfe-Menü verständlicher.

Grenzen und Sicherheitsfragen

Der Skill scaffoldet keine Anwendung und prüft nicht automatisch, ob ein Hook sicher ist. Ein Plugin kann Shell-Skripte starten, Dateien verändern, MCP-Server verbinden oder Hintergrundprozesse ausführen. Deshalb müssen Teams Berechtigungen, Geheimnisse, Netzwerkzugriffe und Änderungen an externem Zustand separat prüfen. Laut Anbieter ist die lokale Entwicklung mit dem Plugin-Verzeichnis-Parameter möglich; die tatsächliche Aktivierung, Vertrauensentscheidung und Ausführung hängt jedoch von der Claude-Code-Installation und der Umgebung ab. Der Skill ist damit besonders nützlich als Architektur- und Review-Checkliste, aber nicht als Sicherheitsfreigabe.

Einordnung für Teams

Die Dokumentation eignet sich für persönliche Experimente ebenso wie für versionierte Plugins, die mit Teams geteilt werden. Sie unterstützt den Übergang von einer schnellen .claude-Konfiguration zu einer eigenständigen Erweiterung mit reproduzierbarem Layout. Anthropic veröffentlicht den Skill im offiziellen Repository unter Apache-2.0. Skill Road führt ihn als externen Anthropic-Skill und nennt keine konkreten Preise; Kosten oder Nutzungsbedingungen von Claude Code, Modellen, Hosting und verbundenen Diensten sind davon getrennt zu bewerten.

Installationsanleitung

Dieser Ratgeber überträgt die offizielle Anthropic-Anleitung zur Plugin-Struktur in einen nachvollziehbaren Prüfablauf. Er eignet sich für ein neues Plugin und für die Übernahme einer vorhandenen .claude-Konfiguration.

Plugin-Stamm und Manifest anlegen

Legen Sie zunächst einen eigenen Plugin-Stamm an. Er enthält das Verzeichnis .claude-plugin. Die Datei plugin.json gehört ausschließlich dort hinein. Beginnen Sie mit einem eindeutigen Namen in kebab-case und ergänzen Sie Beschreibung, Version, Autor, Repository und Lizenz nur dann, wenn diese Angaben gepflegt werden können.

Komponenten am richtigen Ort ablegen

Legen Sie skills, agents, commands und hooks nicht unter .claude-plugin ab. Diese Verzeichnisse liegen direkt im Plugin-Stamm. Ein Skill erhält ein eigenes Unterverzeichnis mit SKILL.md. Für ein kleines Plugin genügt zunächst ein einzelner Skill. Bei mehreren Fähigkeiten ist die skills-Struktur übersichtlicher und unterstützt einen stabilen Namensraum. Erzeugen Sie nur Komponenten, die das Plugin tatsächlich benötigt.

Pfade portabel halten

Prüfen Sie jeden Pfad in Hooks, MCP-Konfigurationen und Skripten. Verwenden Sie CLAUDE_PLUGIN_ROOT, damit die Erweiterung unabhängig vom Installationsort auf ihre eigenen Dateien zugreift. Absolute Pfade und Annahmen über das aktuelle Arbeitsverzeichnis brechen häufig, sobald ein Plugin aus einem Marketplace, einem lokalen Ordner oder einer Teamfreigabe geladen wird.

Schritt 1: Lokal testen und Änderungen prüfen

Starten Sie Claude Code für einen lokalen Test mit dem Plugin-Verzeichnis-Parameter und prüfen Sie danach den namespaced Skill-Aufruf. Kontrollieren Sie auch die Hilfeansicht, die geladenen Komponenten und mögliche Fehlermeldungen. Wenn eine Installation eine erneute Plugin-Aktivierung verlangt, laden Sie die Plugins neu. Ein erfolgreicher Ladevorgang beweist noch nicht, dass ein Hook, MCP-Server oder Skript sicher und fachlich korrekt arbeitet.

Sicherheitsreview vor der Weitergabe

Lesen Sie jeden Hook und jedes Skript vor der Freigabe. Prüfen Sie Schreibzugriffe, Netzwerkverbindungen, Umgebungsvariablen, Geheimnisse und mögliche Änderungen an externen Systemen. Begrenzen Sie Berechtigungen nach dem Least-Privilege-Prinzip und verlangen Sie menschliche Bestätigung für riskante Aktionen. Dokumentieren Sie erforderliche Laufzeitprogramme und Versionsannahmen. So bleibt die Plugin-Struktur reproduzierbar, ohne die Architekturprüfung mit einer automatischen Sicherheitsgarantie zu verwechseln.

Kostenlos
Anbieter
Anthropic
Lizenz
Apache-2.0
Zuletzt geprüft
09.09.2026

Repository und Dokumentation

Kategorien

Kompatibel mit

Claude Code