Plugin Structure for Claude Code

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.