Skills für Agenten

Ein Skill ist eine Arbeitsanleitung in einer Datei SKILL.md. Der Agent lädt sie, sobald Ihre Anfrage zur Beschreibung des Skills passt, und arbeitet die Schritte darin ab. Das Format ist ein offener Standard, mehrere Agenten lesen es. Die MCP-Verbindung liefert die Daten Ihrer Marke, der Skill legt fest, wie der Agent damit arbeitet.

Brandhub bringt zwei Skills mit. Beide brauchen eine MCP-Verbindung zu Ihrer Marke, siehe Agenten anbinden.

Skill	Zweck	Recht
`use-brand`	Texte nach der Corporate Language schreiben und prüfen, Bilder und Dateien finden, Regelfragen mit Quelle beantworten	`read`
`edit-guidelines`	eine Guidelines-Seite anlegen oder eine bestehende ergänzen	`read` + `write`

use-brand holt vor jedem Text die Corporate Language mit get_corporate_language, prüft den Entwurf mit check_terms und korrigiert die Funde. Bilder sucht der Skill mit search_media, Dateien mit search_downloads, Regeln mit search_pages und get_page. use-brand schreibt nichts ins Portal. edit-guidelines zeigt vor jedem Schreibzugriff die geplante Änderung und wartet auf Ihr Ja, denn Änderungen stehen sofort live im Portal.

Beide Skills liegen im öffentlichen Repository 31M-Agentur/brandhub-claude-plugin.

Einrichtung

Für Claude Code gibt es das Brandhub-Plugin. Es richtet die MCP-Verbindung und beide Skills in einem Schritt ein. Sie brauchen Claude Code ab Version 2.1.147, die Subdomain Ihrer Marke (der Teil vor .brandhub.31m.de) und einen API-Key.

Marketplace hinzufügen und Plugin installieren, in einer Claude-Code-Sitzung:

/plugin marketplace add 31M-Agentur/brandhub-claude-plugin
/plugin install brandhub@brandhub

Aus der Shell ohne Sitzung:

claude plugin marketplace add 31M-Agentur/brandhub-claude-plugin
claude plugin install brandhub@brandhub

Subdomain und Key eintragen. Nach einer Installation aus der Shell laden Sie die Plugins in der laufenden Sitzung zuerst neu:
```
/reload-plugins
```
Dann öffnen Sie die Konfiguration:
```
/plugin configure brandhub@brandhub
```
Claude Code fragt beide Werte in einem eigenen Dialog ab und legt den Key im sicheren Speicher des Systems ab, unter macOS im Schlüsselbund. Der Key erscheint nie im Chat.
Claude Code neu starten. /mcp zeigt danach den Server plugin:brandhub:brandhub. Die Skills rufen Sie auch direkt auf:
```
/brandhub:use-brand
/brandhub:edit-guidelines
```

Übergeben Sie den Key nicht per --config an claude plugin install. Er landet sonst im Klartext in Ihrer Shell-Historie.

Per Prompt einrichten

Diesen Prompt kopieren Sie in eine Claude-Code-Sitzung. Claude installiert das Plugin über die Shell. Den Key fragt der Prompt nicht ab, den tragen Sie selbst im Dialog ein.

Installiere das Brandhub-Plugin für Claude Code. Führe dazu in der Shell aus:

  claude plugin marketplace add 31M-Agentur/brandhub-claude-plugin
  claude plugin install brandhub@brandhub

Frag mich nicht nach dem API-Key, und gib ihn auch nicht mit --config oder auf
anderem Weg an einen Befehl weiter. Ich trage Subdomain und Key selbst im
Konfigurationsdialog ein. Sag mir nach der Installation, dass ich in dieser
Sitzung erst /reload-plugins, dann /plugin configure brandhub@brandhub aufrufen
und Claude Code danach neu starten soll. Prüf in der neuen Sitzung mit einem
Aufruf von get_brand, ob der Server antwortet.

claude.ai und Claude Desktop nehmen Skills als ZIP-Datei an.

Laden Sie den Ordner des Skills aus dem Repository und packen Sie ihn als ZIP. Die Datei SKILL.md liegt im ZIP in diesem Ordner.
Laden Sie das ZIP in den Einstellungen im Bereich Skills hoch.
Richten Sie die MCP-Verbindung separat als Custom Connector ein, wie unter Agenten anbinden beschrieben. Ohne Verbindung findet der Skill keine Daten.

Copilot Studio nimmt Skills nur in der neuen Agenten-Erfahrung an. Dort laden Sie die SKILL.md oder den Skill-Ordner als ZIP hoch, bis zu 100 Skills pro Agent. Microsoft führt die Funktion als Vorschau.

Bei klassischen Agenten kopieren Sie die Anleitung aus der SKILL.md in das Feld Instructions auf der Overview-Seite. Das Feld fasst höchstens 8.000 Zeichen, kürzen Sie die Anleitung bei Bedarf.

Die MCP-Verbindung und die Freigaben Ihrer IT beschreibt die Seite Microsoft Copilot.