Referenz

marketplace.json Schema

Das Marketplace-Manifest befindet sich unter .claude-plugin/marketplace.json im Repository-Stammverzeichnis.

Felder der obersten Ebene

Feld	Erforderlich	Beschreibung
$schema	Nein	JSON Schema URL zur Validierung
name	Ja	Eindeutiger Marktplatz-Bezeichner
version	Nein	Marktplatz-Schema-Version (semver)
metadata.description	Ja	Für Menschen lesbare Marktplatz-Beschreibung
owner.name	Ja	Organisation oder Benutzer, dem der Marktplatz gehört
owner.url	Nein	URL zum Profil oder zur Website des Eigentümers
owner.email	Nein	Kontakt-E-Mail
plugins	Ja	Array von Plugin-Einträgen

Felder eines Plugin-Eintrags

Feld	Erforderlich	Beschreibung
name	Ja	Plugin-Bezeichner (muss mit plugin.json übereinstimmen)
description	Ja	Kurzbeschreibung des Plugins
version	Ja	Semantischer Versions-String
author.name	Ja	Plugin-Autor
source	Ja	Pfad oder URL zum Plugin (siehe Quelltypen)
category	Ja	Plugin-Kategorie (z. B. productivity)
homepage	Nein	URL zur Plugin-Dokumentation oder Homepage
license	Nein	SPDX-Lizenz-Bezeichner
keywords	Nein	Array von Suchbegriffen
tags	Nein	Array von Tags zur Filterung
repository	Nein	Repository-URL

Plugin-Quelltypen

Das Feld source in marketplace.json unterstützt mehrere Formate:

Typ	Beispiel	Beschreibung
Relativer Pfad	./plugins/example-plugin	Plugin im selben Repository
GitHub-Kurzform	owner/repo	Plugin im Repository-Stammverzeichnis
GitHub mit Pfad	owner/repo/path/to/plugin	Plugin in einem Unterverzeichnis
Git-URL	https://github.com/owner/repo.git	Git-Repository
npm-Paket	npm:@scope/package	Veröffentlichtes npm-Paket

plugin.json Schema

Jedes Plugin hat ein Manifest unter .claude-plugin/plugin.json in seinem Verzeichnis.

Feld	Erforderlich	Beschreibung
name	Ja	Plugin-Bezeichner
description	Ja	Funktion des Plugins
version	Ja	Semantische Version
author.name	Ja	Plugin-Autor
author.url	Nein	URL zum Profil oder zur Website des Autors
homepage	Nein	Dokumentations-URL
keywords	Nein	Suchbegriffe
license	Nein	SPDX-Lizenz-Bezeichner
repository	Nein	Repository-URL

Plugin-Verzeichnisstruktur

plugins/example-plugin/
  .claude-plugin/
    plugin.json          # Plugin-Manifest (erforderlich)
  skills/
    skill-name/
      SKILL.md           # Skill-Definition (pro Skill erforderlich)
      references/        # Referenzdatendateien (optional)
  commands/
    command-name.md      # Befehlsdefinition (eine pro Befehl)
  agents/
    agent-name.md        # Agentendefinition (eine pro Agent)
  README.md              # Plugin-Dokumentation (empfohlen)

Umgebungsvariablen

Plugins können diese Variablen in ihren Skill- und Befehlsdateien verwenden:

Variable	Beschreibung
$\{CLAUDE_PLUGIN_ROOT\}	Absoluter Pfad zum Stammverzeichnis des Plugins

Validierung

Validieren Sie Ihre Marktplatz- und Plugin-Manifeste lokal:

claude plugin validate .

Dabei wird Folgendes geprüft:

• Konformität mit dem marketplace.json-Schema
• Alle referenzierten Plugin-Verzeichnisse sind vorhanden
• Jedes Plugin hat eine gültige plugin.json
• Skills haben korrekt formatiertes SKILL.md-Frontmatter
• Befehle haben die erforderlichen Frontmatter-Felder

Team-Konfiguration

Marktplätze vorab konfigurieren

Fügen Sie Folgendes zu .claude/settings.json in einem beliebigen Repository hinzu:

{
  "extraKnownMarketplaces": [
    "f5-sales-demo/marketplace"
  ]
}

Plugins vorab aktivieren

{
  "enabledPlugins": [
    "f5xc-docs-tools@f5-sales-demo-marketplace"
  ]
}

Tipp

Durch das Einchecken dieser Einstellungen in Ihr Repository wird sichergestellt, dass jedes Teammitglied automatisch dieselbe Marktplatz- und Plugin- Konfiguration erhält.

Fehlerbehebung

Marktplatz nicht gefunden

Überprüfen Sie, ob der Marktplatz hinzugefügt wurde:

/plugin marketplace list

Falls nicht vorhanden, fügen Sie ihn erneut hinzu:

/plugin marketplace add f5-sales-demo/marketplace

Plugin wird nicht aktiviert

• Bestätigen Sie, dass das Plugin installiert ist: /plugin list
• Stellen Sie sicher, dass Ihre Claude Code-Version Plugins unterstützt (v1.0.33+)
• Überprüfen Sie, ob die Auslösebedingungen des Skills zu Ihrem aktuellen Kontext passen

Skills werden nicht automatisch ausgelöst

Skills werden basierend auf ihrem Feld description im SKILL.md-Frontmatter aktiviert. Wenn ein Skill nicht wie erwartet ausgelöst wird:

• Prüfen Sie, ob die Beschreibung den Auslösekontext genau beschreibt
• Verwenden Sie den Befehl direkt (z. B. /f5xc-docs-tools:review-mdx) als Workaround

Build-Fehler nach der Überprüfung

Das Plugin meldet Probleme, behebt sie jedoch nicht automatisch. Wenden Sie die vorgeschlagenen Korrekturen manuell an und führen Sie die Überprüfung erneut aus, um die Behebung zu bestätigen.