Marco Patzelt
Back to Overview
12. Februar 2026

Claude Cowork Plugins bauen: Kompletter Guide

Claude Cowork Plugins von Grund auf bauen — Commands, Auto-Loading Skills, Agents, Hooks und drei Wege zur Verteilung vom ZIP-Upload bis zum Verzeichnis.

Anthropic hat Plugins für Claude Cowork und Claude Code veröffentlicht. 11 offizielle Plugins zum Start, ein offenes Plugin-Format basierend auf Markdown-Dateien und ein Marketplace-System zur Verteilung.

Ich habe am Wochenende eins gebaut — eine SEO Content Engine mit 8 Slash-Commands und 5 Auto-Loading Skills. Hier ist alles, was ich über das Plugin-System gelernt habe.

Was Plugins wirklich sind

Ein Plugin ist ein Ordner. Darin: Markdown-Dateien, die Claude sagen, wie es sich verhalten soll. Kein kompilierter Code. Keine API-Keys. Keine Docker-Container.

Die Ordnerstruktur:

VerzeichnisZweck
.claude-plugin/plugin.jsonIdentität: Name, Version, Beschreibung
commands/Slash-Commands, die User manuell aufrufen
skills/Wissen, das automatisch basierend auf Kontext geladen wird
agents/Eigene Sub-Agents mit spezifischem Tool-Zugang
hooks/Event-Trigger (Code nach Datei-Edits ausführen, etc.)
.mcp.jsonExterne Tool-Verbindungen (APIs, Datenbanken)

Das war's. Fünf Konzepte. Alles dateibasiert. Alles versionierbar mit Git.

Schritt 1: Das Manifest

Jedes Plugin beginnt mit .claude-plugin/plugin.json:

{
  "name": "my-plugin",
  "description": "Was es in einem Satz macht",
  "version": "1.0.0",
  "author": {
    "name": "Dein Name"
  }
}

Das name-Feld wird dein Namespace. Wenn du es seo-tools nennst, werden deine Commands zu /seo-tools:draft, /seo-tools:keywords, etc. Wähle einen kurzen, beschreibenden Namen.

Schritt 2: Commands (Slash-Commands)

Erstelle commands/hello.md:

---
description: Den User begrüßen und erklären, was das Plugin macht
disable-model-invocation: true
---

# Hello

Begrüße den User. Erkläre, dass dieses Plugin
SEO-Tools für Blog-Content bereitstellt.

Der Dateiname wird der Command-Name. hello.md/my-plugin:hello. Das description-Feld erscheint im Command-Menü.

Der $ARGUMENTS-Platzhalter erfasst User-Input:

---
description: SEO-Keywords für ein Thema generieren
---

Generiere Keywords für: $ARGUMENTS

Jetzt übergibt /my-plugin:keywords kubernetes vs docker das Thema an Claude.

Schritt 3: Skills (Auto-Loading Wissen)

Skills sind die Magie. Sie sind Kontext, den Claude automatisch lädt — kein Slash-Command nötig. Speichere sie in skills/topic-name/SKILL.md:

---
name: writing-rules
description: Schreibqualitäts-Regeln. Lädt automatisch beim Verfassen von Content.
---

# Schreibregeln

- Maximal 3 Sätze pro Absatz
- Zahlen statt Adjektive ("15 Tokens/Sek" nicht "sehr schnell")
- Aktive Sprache, direkte Ansprache
- Jeder Artikel braucht einen Verdict-Abschnitt

Wenn Claude erkennt, dass du Content schreibst, zieht es diese Regeln automatisch heran. Du rufst Skills nicht auf — sie aktivieren sich selbst.

Wichtiger Unterschied: Commands sind explizit (/mach-das). Skills sind implizit (Claude entscheidet, wann sie relevant sind).

Schritt 4: Agents (Optional)

Eigene Agents bekommen spezifischen Tool-Zugang. Erstelle agents/researcher.md:

---
name: researcher
description: Research-Agent mit nur Web-Zugang
tools:
  - WebSearch
  - WebFetch
  - Read
---

Du bist ein Research-Agent. Durchsuche das Web nach aktuellen
Informationen zum gegebenen Thema. Liefere Fakten, keine Meinungen.

Das erstellt einen Sub-Agent, der nur suchen und lesen kann — kein Datei-Editing, keine Code-Ausführung. Nützlich für Aufgabentrennung.

Schritt 5: Hooks (Event-Automatisierung)

Hooks führen Shell-Commands aus, wenn Claude etwas tut. Erstelle hooks/hooks.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{
          "type": "command",
          "command": "echo 'Datei geändert' >> plugin.log"
        }]
      }
    ]
  }
}

Das loggt jeden Dateischreibvorgang. Du könntest Code linten, Tests ausführen, Benachrichtigungen senden — jeder Shell-Command funktioniert.

Die komplette Struktur

So sieht ein echtes Plugin aus:

seo-blog-engine/
├── .claude-plugin/
│   ├── plugin.json          # Identität
│   └── marketplace.json     # Verteilungskatalog
├── commands/
│   ├── draft.md             # /seo-blog:draft
│   ├── keywords.md          # /seo-blog:keywords
│   ├── titles.md            # /seo-blog:titles
│   └── setup.md             # /seo-blog:setup
├── skills/
│   ├── seo-fundamentals/
│   │   └── SKILL.md         # Lädt automatisch für Keyword-Arbeit
│   ├── writing-engine/
│   │   ├── SKILL.md         # Lädt automatisch beim Schreiben
│   │   ├── good-examples.md # Referenzmaterial
│   │   └── bad-examples.md  # Anti-Patterns
│   └── voice-defaults/
│       ├── SKILL.md         # Ton-Regeln
│       └── forbidden-phrases.md
└── README.md
Newsletter

Wöchentliche Insights zu AI-Architektur. Kein Spam.

8 Commands, 5 Skills, null kompilierter Code. Der komplette Quellcode ist auf GitHub.

Verteilung: Drei Wege

Weg 1: In Cowork hochladen (Einfachste)

  1. Plugin-Ordner als ZIP packen
  2. Claude Desktop öffnen → Cowork Tab
  3. Plugins → Plugin hochladen klicken
  4. ZIP auswählen

Fertig. Deine Commands erscheinen sofort.

Weg 2: GitHub Marketplace (Mit allen teilen)

Füge eine marketplace.json in deinen .claude-plugin/-Ordner ein:

{
  "name": "seo-blog-engine",
  "owner": { "name": "Dein Name" },
  "plugins": [{
    "name": "seo-blog-engine",
    "source": ".",
    "description": "SEO Content Engine"
  }]
}

Auf GitHub pushen. Jeder installiert mit:

/plugin marketplace add dein-username/repo-name
/plugin install plugin-name@marketplace-name

Weg 3: Offizielles Anthropic-Verzeichnis

Einreichen unter clau.de/plugin-directory-submission. Anthropic prüft Qualität und Sicherheit, dann wird es im offiziellen Plugin-Verzeichnis gelistet.

Das bringt dir das Verifiziert-Badge und maximale Sichtbarkeit.

Was ein gutes Plugin ausmacht

Nachdem ich eins gebaut und die offiziellen Plugins studiert habe, hier was funktioniert:

Mach eine Sache gut. Die besten Plugins sind fokussiert. "SEO Content Engine" schlägt "Alles-Content-Tool." User installieren spezifische Lösungen, keine Schweizer Taschenmesser.

Skills vor Commands. Commands erfordern, dass der User sich Syntax merkt. Skills laden automatisch, wenn relevant. Ein gutes Plugin ist 80% Skills, 20% Commands.

Beispiele einbauen. Skills mit good-examples.md und bad-examples.md Dateien produzieren dramatisch besseren Output als abstrakte Regeln allein.

Setup-Command mitliefern. Wenn dein Plugin Konfiguration braucht (Blog-Nische, Stimme, Sprache), baue einen /setup-Command, der Fragen im Dialog stellt. Der erste Eindruck zählt.

Was ich gebaut habe

Die SEO Blog Engine generiert komplette Artikel-Pakete aus jedem Thema:

  • /seo-blog:draft "Thema" → Kompletter Artikel mit Keywords, FAQ-Schema, Social Copy
  • /seo-blog:keywords "Thema" → SEO-Keyword-Vorhersagen
  • /seo-blog:faq "Thema" → FAQ mit JSON-LD Schema-Markup
  • /seo-blog:optimize → Bestehende Artikel auditieren und verbessern

Ich nutze eine Version dieses Systems, um jeden Artikel auf diesem Blog zu schreiben. Das Plugin ist die Open-Source, portable Version — installieren, für deine Nische konfigurieren, loslegen.

Das Fazit

Claudes Plugin-System sind Markdown-Dateien in Ordnern. Das ist die gesamte Architektur. Kein SDK, kein Build-Step, keine API-Keys.

Wenn du eine Markdown-Datei schreiben kannst, kannst du ein Plugin bauen. Wenn du auf GitHub pushen kannst, kannst du es verteilen.

Das System ist neu — Cowork-Plugins starteten als Research Preview. Der Marketplace ist dünn besetzt. Wenn du jetzt etwas Nützliches baust, bist du Erster. Das ist das gleiche First-Mover-Playbook, das für SEO-Content funktioniert — nur jetzt für Plugin-Distribution.

Starte mit einem einzelnen Command, der ein echtes Problem löst. Ship it. Iteriere.

Newsletter

Wöchentliche Insights zu AI-Architektur

Kein Spam. Jederzeit abbestellbar.

Häufig gestellte Fragen

Plugins sind Ordner mit Markdown-Dateien, die Claudes Fähigkeiten erweitern. Sie bündeln Skills, Commands, Agents und Hooks in teilbare Pakete. Kein kompilierter Code oder API-Keys nötig.

In Cowork: ZIP von GitHub herunterladen, Plugins in der Seitenleiste öffnen, Plugin hochladen klicken. In Claude Code: /plugin marketplace add username/repo, dann /plugin install.

Commands werden explizit vom User mit Slash-Syntax aufgerufen wie /plugin:command. Skills laden automatisch basierend auf Kontext — Claude entscheidet, wann sie relevant sind.

Drei Optionen: ZIP direkt in Cowork hochladen, auf GitHub mit marketplace.json veröffentlichen, oder bei Anthropics offiziellem Plugin-Verzeichnis einreichen für maximale Sichtbarkeit.

Ja. Plugins sind Markdown-Dateien in Ordnern. Wenn du strukturierten Text schreiben und GitHub nutzen kannst, kannst du ein Plugin bauen. Kein SDK, Build-Tools oder Programmierung nötig.

Hooks lösen Shell-Commands bei Claude-Events aus wie PostToolUse. Definiere sie in hooks/hooks.json mit Matchern für bestimmte Tools. Nutze sie für Linting, Tests, Logging oder Benachrichtigungen.

Anthropic startete mit 11 offiziellen Plugins für Produktivität, Enterprise-Suche, Marketing und Sales. Der Community-Marketplace wächst mit entwicklerbeigetragenen Plugins.

Standard-JSON mit name, description, version und optionalen author-Feldern. Das name-Feld wird zum Command-Namespace — wähle etwas Kurzes und Beschreibendes, maximal 20 Zeichen.

Lass uns
vernetzen.

Ich bin immer offen für spannende Diskussionen über Frontend-Architektur, Performance und moderne Web-Stacks.

Schreib mir
Schreib mir