Installation & Nutzung

Die vollständige Anleitung, um den Miragon-Marketplace in Claude einzubinden, das Plugin zu installieren und die Skills zu nutzen. Funktioniert interaktiv (in einer Claude-Session) und über die CLI.

Voraussetzungen

• Claude Code installiert und eingeloggt.
• Zugriff auf das Repository Miragon/corporate-identity.

1. Marketplace hinzufügen

Interaktiv, in einer Claude-Session:

/plugin marketplace add Miragon/corporate-identity

Über die CLI (für Skripte oder CI):

claude plugin marketplace add Miragon/corporate-identity

Optional auf einen Branch oder Tag pinnen (Tags entstehen mit jedem Release, siehe CHANGELOG):

/plugin marketplace add Miragon/corporate-identity@v1.9.0

Wie das funktioniert

Claude liest die Datei .claude-plugin/marketplace.json aus dem Wurzelverzeichnis des Repos. Darin ist der Marketplace miragon definiert und das Plugin miragon-brand als relativer Pfad (./plugins/miragon-brand) verlinkt.

2. Plugin installieren

Format ist immer <plugin-name>@<marketplace-name>:

/plugin install miragon-brand@miragon

Über die CLI, optional mit Scope:

# Standard: nur für dich (user-Scope)
claude plugin install miragon-brand@miragon

# Im Projekt geteilt (via .claude/settings.json, fürs Team)
claude plugin install miragon-brand@miragon --scope project

Für Miragon-Repos ist der Projekt-Scope die bessere Wahl: Dann ist das Plugin genau dort aktiv, wo Miragon-Material entsteht. Installierst du es für deinen Account, greifen die Skills nur bei Miragon-Themen, und der Hook bleibt ohne .miragon/brand.json stumm.

3. Skills nutzen

Plugin-Skills sind mit dem Plugin-Namen namespaced:

/miragon-brand:brand-tone
/miragon-brand:corporate-design
/miragon-brand:brand-review
/miragon-brand:agent-voice
/miragon-brand:modeler-tool-design
/miragon-brand:icon-design
/miragon-brand:social-post

Alle Skills triggern auch automatisch, sobald Claude einen passenden Miragon-Kontext erkennt: einen Text schreiben (brand-tone), etwas gestalten (corporate-design), ein fertiges Stück prüfen (brand-review), einen Miragon-Bot aufsetzen (agent-voice), eine Oberfläche in einem Miragon-Produkt bauen (modeler-tool-design), ein Icon in einen Modeler einbauen oder entwerfen (icon-design) oder einen LinkedIn-Post schreiben (social-post).

4. Marken-Prüfung beim Schreiben einschalten

Leg im Repo eine Datei .miragon/brand.json an. Ab dann prüft der brand-lint-Hook jede Datei, die Claude schreibt oder ändert, und meldet Verstöße sofort zurück:

{
  "ignorieren": ["docs/archiv/"],
  "aus": []
}

Voraussetzung ist Node.js auf dem Rechner. Ohne Node oder ohne die Datei tut der Hook nichts. Details und Ausnahmen stehen unter brand-review.

Updates

Wenn neue Plugin-Versionen gepusht werden:

# Marketplace neu einlesen
/plugin marketplace update

# Installierte Plugins aktualisieren
/plugin update

Wie neue Versionen entstehen und was sich ändern darf, steht unter Pflege & Versionen.

Fürs ganze Team bereitstellen

Damit alle im Team den Marketplace und das Plugin automatisch bekommen, in die .claude/settings.json des Projekts:

{
  "extraKnownMarketplaces": {
    "miragon": {
      "source": {
        "source": "github",
        "repo": "Miragon/corporate-identity"
      }
    }
  },
  "enabledPlugins": {
    "miragon-brand@miragon": true
  }
}

Verwaltung

claude plugin list                       # installierte Plugins anzeigen
claude plugin disable miragon-brand      # vorübergehend deaktivieren
claude plugin enable miragon-brand       # wieder aktivieren
claude plugin uninstall miragon-brand    # entfernen

Lokal testen (für Maintainer)

Wer am Plugin selbst arbeitet, testet vor dem Push lokal aus dem Repo-Verzeichnis:

# Marketplace aus lokalem Pfad einbinden
/plugin marketplace add ./

# Manifeste und Skill-Frontmatter prüfen
claude plugin validate .