Claude Skills und Plugins: Eine technische Analyse von Inhalt vs. Container

Die Begriffe „Claude Skill“ und „Claude Plugin“ werden oft synonym verwendet, was zu Verwirrung bei Entwicklern führt, die Claude Code erweitern möchten. Tatsächlich sind sie jedoch nicht dasselbe. Diesen Unterschied zu verstehen, ist nicht nur eine akademische Frage; es ist fundamental, um benutzerdefinierte Verhalten effektiv zu erstellen, zu installieren und zu debuggen.

Bei SkillProof arbeiten wir täglich mit diesen Mechanismen. Wir lesen nicht nur die Dokumentation; wir installieren und führen Skills für reale Aufgaben aus, sowohl aus reinen Ordnern als auch aus Plugin-Bundles. Von den 1877 Skills, die wir bis heute getestet haben, haben nur 1159 (62 %) unsere Evaluierung bestanden. Weitere 624 erforderten eine Konfiguration, einen begleitenden Skill oder eine Integration, bevor sie Ergebnisse lieferten, und 94 schnitten unterhalb der Baseline ohne Skill ab – entweder konnten sie gar nicht ausgeführt werden, oder sie liefen und verschlechterten das Ergebnis im Vergleich zu keiner Installation. Diese Erfahrung gibt uns eine klare, auf Fakten basierende Perspektive auf den Unterschied zwischen einem Claude Skill und einem Plugin und wann welche Option zu verwenden ist.

Die einfachste Denkweise ist folgende: Ein Skill ist der Inhalt – der Satz von Anweisungen, der Claude ein neues Verhalten beibringt. Ein Plugin ist ein Container – ein Distributionspaket, das einen oder mehrere Skills zusammen mit anderen Arten von Erweiterungen bündeln kann.

Dieser Artikel trennt die beiden Konzepte und verwendet dabei die exakten Dateipfade und Befehle, die wir bei unseren täglichen Tests einsetzen. Wir werden behandeln, was ein Skill ist, was ein Plugin ist, wie sie installiert werden und wann man das eine oder das andere erstellen sollte.

Was ist ein Claude Code Skill? Die atomare Einheit des Verhaltens

Ein Claude Skill ist der fundamentalste Baustein. Er ist buchstäblich ein Ordner, der eine Datei namens SKILL.md enthält. Das ist alles. Der Ordnername wird zum Identifikator des Skills.

Die SKILL.md-Datei hat eine einfache, zweiteilige Struktur:

1. YAML Frontmatter: Ein Block am Anfang der Datei, umschlossen von ---, der die Metadaten des Skills definiert. Das relevante Feld ist description. name ist optional und standardmäßig der Verzeichnisname, und es gibt etwa ein Dutzend weiterer optionaler Felder (allowed-tools, when_to_use, model, paths und ähnliche), die die meisten Skills nie verwenden.
2. Markdown-Anweisungen: Unterhalb des Frontmatters schreiben Sie einfaches Markdown, das die Aufgabe für Claude erklärt. Dies ist Ihr Prompt, Ihr Satz von Anweisungen, wie das Verhalten ausgeführt werden soll.

Entscheidend ist, dass das SKILL.md-Format keine komplexe Syntax zur Definition von Tool-Funktionen, API-Schemata oder Parametertypen enthält. Es gibt keinen erforderlichen Block für Few-Shot-Beispiele. Das gesamte System basiert auf natürlicher Sprache.

Das wichtigste Feld im Frontmatter ist description. Dies ist nicht nur für menschliche Leser gedacht; es ist der primäre Auslöser für den Skill. Wenn Sie Claude eine Aufgabe geben, durchsucht es die description-Felder aller installierten Skills, um eine Übereinstimmung zu finden. Wenn Ihre Aufgabenbeschreibung mit der description eines Skills übereinstimmt, lädt Claude die Markdown-Anweisungen dieses Skills in seinen Kontext, um seine Antwort zu steuern. Wenn es fehlt, greift Claude auf den ersten Absatz des Hauptteils zurück, der selten als Auslöser formuliert ist.

Dies ist ein häufiger Fehlerpunkt, den wir in unseren Tests dokumentieren. Wir haben viele Skills mit brillanten Anweisungen im Markdown-Hauptteil gesehen, die Claude nie verwendet, weil die description im Frontmatter zu vage, zu spezifisch oder komplett fehlend war. Ein Skill mit einer Beschreibung wie "Hilft bei der Entwicklung" wird fast nie ausgelöst. Für einen tieferen Einblick, was einen guten Skill ausmacht, siehe unseren Leitfaden was Claude Skills sind.

Wie man einen reinen Skill installiert

Wenn ein Skill nur ein Ordner ist, ist die Installation so einfach wie das Kopieren dieses Ordners an die richtige Stelle. Claude Code sucht nach Skills an zwei Orten:

1. Global: ~/.claude/skills/
2. Projektspezifisch: <your-project-directory>/.claude/skills/

Skills im globalen Verzeichnis sind in jedem Projekt verfügbar, das Sie mit Claude Code öffnen. Skills in einem projektspezifischen Verzeichnis werden nur geladen, wenn Sie innerhalb dieses Projekts arbeiten. Dies ist nützlich für Aufgaben, die spezifisch für eine einzelne Codebasis sind.

Um einen Skill zu installieren, den Sie aus einem Git-Repository heruntergeladen haben, ist der Prozess eine direkte Dateioperation. Zum Beispiel, nachdem Sie ein Repository mit einem Skill geklont haben, würden Sie ausführen:

# Example: Installing a skill into the global directory
cp -r path/to/cloned-repo/the-skill-folder ~/.claude/skills/

Claude Code überwacht diese Skill-Verzeichnisse, sodass ein Skill, den Sie hinzufügen, bearbeiten oder entfernen, innerhalb der aktuellen Sitzung ohne Neustart erkannt wird. Die Ausnahme ist ein Skill-Verzeichnis, das beim Start der Sitzung noch nicht existierte; wenn Sie ein solches erstellen, ist ein Neustart erforderlich, damit Claude Code mit der Überwachung beginnt.

Es gibt keine spezielle Befehlszeilenschnittstelle für die Installation eines reinen Skills und keine --skill-Option, die Claude für eine einmalige Ausführung auf eine SKILL.md-Datei verweist. Das Kopieren des Ordners ist die Installation.

Dieser direkte, dateibasierte Ansatz ist die Methode, mit der wir die Mehrheit der in unserem Katalog aufgeführten Skills installieren. Er ist einfach, transparent und leicht zu debuggen. Detailliertere Installationsbeispiele finden Sie in unserem Leitfaden zur Installation von Claude Skills.

Was ist ein Claude Plugin? Ein Distributionspaket

Wenn ein Skill der Inhalt ist, ist ein Plugin die Transportkiste. Ein Plugin ist ein eigenständiges Verzeichnis von Komponenten, das normalerweise ein .claude-plugin/plugin.json-Manifest enthält, das seine Identitätsmetadaten (Name, Beschreibung, Version, Autor) speichert und auf den Speicherort seiner Komponenten verweisen kann.

Dies ist der Kernunterschied zwischen einem Claude Skill und einem Plugin: Ein Plugin ist als Bündel konzipiert. Obwohl es einen einzelnen Skill enthalten kann, liegt seine wahre Stärke in der Fähigkeit, mehrere zusammengehörige Erweiterungen zu bündeln. Ein Plugin kann Folgendes enthalten:

• Skills: Ein oder mehrere SKILL.md-Ordner.
• Agents: Spezialisierte Sub-Agenten, an die der Haupt-Claude-Agent Arbeit übergeben kann.
• Slash-Befehle: Benutzerdefinierte /-Befehle, die Sie direkt in der Claude Code Chat-Oberfläche ausführen können.
• Hooks: Skripte, die automatisch an bestimmten Punkten im Lebenszyklus der Sitzung ausgeführt werden.
• MCP-Server: Verbindungen zu einem Model Context Protocol Server, sodass ein Plugin eine externe Integration als Teil seiner Installation einrichten kann, anstatt dass Sie die Konfiguration manuell vornehmen müssen. Mehr dazu in unserer Analyse von Skills vs. MCP.
• LSP-Server: Sprachserver-Verbindungen, die Claude Typfehler und Codenavigation ermöglichen.

Ein Plugin ist nicht nur ein Wrapper für einen einzelnen Skill. Es ist ein komplettes Toolkit. Beispielsweise könnte ein Plugin für ein bestimmtes Test-Framework einen Skill zum Schreiben neuer Tests, einen Slash-Befehl zum Ausführen dieser Tests und einen Hook bündeln, der Tests vor jedem Commit ausführt. Der Skill ist nur ein Teil des Puzzles.

Wie Plugins und Marktplätze funktionieren

Da Plugins komplexere Pakete sind, ist ihr Installationsprozess anders. Man kopiert Plugin-Ordner nicht manuell. Man verwendet Marktplätze: Ein Marktplatz ist ein Git-Repository, das eine .claude-plugin/marketplace.json-Datei enthält, die die angebotenen Plugins auflistet.

Anthropic betreibt einen offiziellen Marktplatz, claude-plugins-official, den Claude Code beim Start automatisch für Sie hinzufügt, sowie einen Community-Marktplatz unter anthropics/claude-plugins-community, den Sie selbst hinzufügen und dessen Plugins eine automatisierte Validierung und Sicherheitsprüfung durchlaufen haben. Das System ist jedoch nicht geschlossen: Jeder kann einen Marktplatz veröffentlichen, indem er eine marketplace.json in einem Repo platziert, und nichts hindert Sie daran, ihn hinzuzufügen. Die Aufnahme in den offiziellen Katalog liegt im Ermessen von Anthropic; alles außerhalb davon hat die Qualität, die der jeweilige Maintainer ihm gegeben hat.

Um ein Plugin zu installieren, fügen Sie dessen Marktplatz hinzu und installieren dann das Plugin anhand seines Namens:

1. Den Marktplatz hinzufügen:

   /plugin marketplace add anthropics/claude-code
   

2. Das Plugin installieren:

   /plugin install commit-commands@claude-code-plugins
   

Führen Sie dann /reload-plugins aus, um es in der aktuellen Sitzung zu aktivieren.

Die Plugin-Verwaltung ist jedoch nicht auf die interaktive Oberfläche beschränkt. Es gibt eine claude plugin-Shell-Befehlsgruppe (mit dem Alias claude plugins), die install, uninstall, enable, disable, update, list, details, init und validate abdeckt – der dokumentierte Weg zur Installation ohne den interaktiven Schritt und die Option, die man für das Skripten einer Team-Einrichtung verwendet:

claude plugin install commit-commands@claude-code-plugins --scope project

Es gibt auch die Flags --plugin-dir und --plugin-url, um ein Plugin nur für eine Sitzung zu laden, was die Methode ist, um etwas auszuprobieren, bevor man sich darauf festlegt.

Der Unterschied zwischen einem Marktplatz und einem kuratierten Verzeichnis ist hier von Bedeutung und es ist nicht dieselbe Achse wie Skill versus Plugin. Ein Marktplatz ist ein Vertriebskanal: Er teilt Ihnen mit, dass ein Plugin existiert, und installiert es. Eine Überprüfung, sofern sie überhaupt stattfindet, ist automatisiert. Nichts davon sagt Ihnen, ob das Plugin für Ihre Aufgabe funktioniert.

Claude Code Skills vs. Plugins: Ein direkter Vergleich

Um den Unterschied ganz klar zu machen, hier ein direkter Vergleich der wichtigsten Merkmale:

Merkmal	Reiner Skill	Plugin
Definition	Ein Ordner mit einer SKILL.md-Datei, die ein einzelnes Verhalten definiert.	Ein eigenständiges Verzeichnis von Komponenten, das als Paket fungiert.
Kerndatei	SKILL.md	.claude-plugin/plugin.json
Umfang	Ein einzelner Satz von Anweisungen für eine Aufgabe.	Ein Bündel aus Skills, Agents, Befehlen, Hooks, MCP- und LSP-Servern.
Installation	Manuelles Kopieren: cp -r ... ~/.claude/skills/	/plugin install <name>@<market> oder claude plugin install
Distribution	Direkte Ordnerfreigabe, Git-Repository.	Über einen Marktplatz (ein Git-Repo mit einem Manifest).
Anwendungsfall	Persönlicher Gebrauch, Werkzeuge für einen einzigen Zweck, schnelles Prototyping.	Verteilung im Team, komplexe Toolkits, mehrteilige Verhalten.

Wie SkillProof beides testet

Unsere Testmethodik ist agnostisch gegenüber der Installationsmethode. Ob ein Skill als reiner Ordner oder innerhalb eines Plugin-Bundles ankommt, unser Prozess ist derselbe. Wir installieren ihn und bewerten dann die Leistung der zugrunde liegenden SKILL.md-Anweisungen anhand eines standardisierten Satzes von Aufgaben.

Die Distributionsmethode ändert das Verhalten des Skills nicht. Eine schlecht geschriebene SKILL.md-Datei wird genauso schlecht funktionieren, egal ob Sie sie manuell kopieren oder mit /plugin install installieren.

Tatsächlich ist ein wiederkehrender Fehler, auf den wir stoßen, ein Paket, das sich perfekt installieren lässt, aber einen Skill enthält, der nie ausgelöst wird. Die Installation wird fehlerfrei abgeschlossen, der Skill erscheint in der Liste, und dann greift Claude nie darauf zu, weil die description in seiner SKILL.md zu dürftig ist, um mit dem übereinzustimmen, was ein Benutzer tatsächlich eingeben würde. Nichts an der Installation meldet dies. Man findet es nur heraus, indem man Claude die Aufgabe gibt, die der Skill erledigen sollte, und beobachtet, wie es antwortet, als ob der Skill nicht vorhanden wäre – was genau der Test ist, den wir durchführen.

Dies ist einer der Gründe, warum 624 der 1877 von uns getesteten Skills das Urteil "Funktioniert mit Konfiguration" anstelle von "Bestanden" erhalten: Sie liefern Ergebnisse, aber nicht sofort, und die Verpackung neigt dazu, den Grund dafür zu verbergen.

Sollte ich einen Skill oder ein Plugin erstellen?

Das bringt uns zu der praktischen Frage: Wenn Sie ein neues Verhalten für Claude haben, sollten Sie einen Skill oder ein Plugin erstellen?

Die Antwort ist einfach: Beginnen Sie immer mit der Erstellung eines Skills.

1. Erstellen Sie Ihre your-skill-name/SKILL.md-Datei. Konzentrieren Sie sich darauf, klare, effektive Anweisungen und eine präzise, auslöserfreundliche description zu schreiben. Testen Sie sie lokal, indem Sie sie in ~/.claude/skills/ kopieren.

2. Iterieren Sie an der SKILL.md, bis sie zuverlässig funktioniert. Das sind 99 % der Arbeit. Der Inhalt dieser Datei ist das, was den Wert liefert.

Erst nachdem Sie einen bewährten, funktionierenden Skill haben, sollten Sie erwägen, ihn als Plugin zu verpacken. Die Entscheidung, ein Plugin zu erstellen, sollte von den Distributionsanforderungen bestimmt werden, nicht von der Komplexität des Skills selbst.

Verpacken Sie es als Plugin, wenn:

• Sie mehr als eine Komponente ausliefern. Zum Beispiel einen Skill zur Generierung von API-Dokumentation und einen Slash-Befehl /generate-docs, um ihn für das gesamte Projekt auszulösen.
• Sie einen Satz von Skills an ein Team mit einem einzigen, einfachen Installationsbefehl verteilen müssen.
• Sie eine fortgeschrittenere Erweiterung erstellen, die auf Hooks, Sub-Agenten oder anderen nur in Plugins verfügbaren Funktionen basiert.

Wenn Sie einen einzelnen Skill für Ihren persönlichen Gebrauch haben, ist die Erstellung eines Plugins unnötiger Mehraufwand. Ein reiner Skill-Ordner in ~/.claude/skills/ ist einfacher und direkter.

Fazit: Konzentrieren Sie sich auf den Skill, nicht auf die Hülle

Die zentrale Erkenntnis ist, dass die Leistung von der Qualität der SKILL.md-Datei abhängt, nicht von ihrer Verpackung. Ein Plugin ist ein Verteilungsmechanismus, keine Qualitätsgarantie. Wie unsere Daten zeigen, scheitern sogar sauber verpackte Skills: 94 der von uns getesteten schnitten schlechter ab als Claude ohne jeglichen installierten Skill.

Der Unterschied zwischen Claude Skills und Plugins ist keine Frage von gut gegen schlecht, sondern von Umfang und Zweck. Das eine ist die Anweisung; das andere ist die Kiste, in der sie geliefert wird.

Weiterführende Lektüre: Für eine detaillierte Betrachtung der Verpackungsseite – Manifeste, Marktplatzstruktur und was Sie prüfen sollten, bevor Sie das Repo von jemandem hinzufügen – siehe unseren Leitfaden zu Claude Code Plugins. Für die Inhaltsseite behandelt was Claude Skills sind, wie das Format funktioniert, bevor Sie Ihren ersten Skill schreiben.

Die 1159 Skills zu finden, die unsere Tests tatsächlich bestehen, ist der Grund, warum wir SkillProof entwickelt haben. Wenn Sie das Ausprobieren überspringen möchten, ist unser Katalog getesteter Coding-Skills ein guter Ausgangspunkt. Wenn Sie lieber ein Set installieren möchten, das bereits zusammen getestet wurde, verkaufen wir rollenbasierte Pakete mit zehn Skills – Developer Toolkit, Writer Pack, Security & Code Review und fünf weitere – für je 10 $ unter /bundles.