Zum Hauptinhalt springen

Claude Skill installieren

Das nano-banana Claude Skill bringt Claude bei, das MCP fluent zu bedienen — wann erst architecten, wann One-Shotten, wie concept_id das Brand Styling weiterträgt, wie Progress sauber an den User zurückgespielt wird. Ohne das Skill ruft Claude die Tools zwar trotzdem auf, aber die Defaults sind oft suboptimal (z. B. One-Shot auf einen rohen Prompt ohne Concept Proposal, oder Progress-Updates werden nicht angezeigt).

Installation​

Lokal vendoren (Claude Code / Desktop)​

git clone git@git.cpl.cloud:Intern/ai/genkit/nano-banana.git /tmp/nano-banana
cp -r /tmp/nano-banana/skills/nano-banana ~/.claude/skills/

Claude Code neustarten. Das Skill wird automatisch erkannt, prüfen via /skills.

Antigravity CLI / agentskills.io​

Kommt noch: published Skill-Package auf agentskills.io.

MCP-Server registrieren​

Unabhängig vom Skill den Remote-MCP unter https://mcp.nano.cpl.ai im Client registrieren:

Claude Code:

claude mcp add --transport http nano-banana https://mcp.nano.cpl.ai/mcp

Danach /mcp auth nano-banana ausführen, um den OAuth-Flow abzuschließen. Mit dem @cloudpilots.com-Google-Account einloggen.

Claude Desktop / claude.ai: Settings → Connectors → "Add custom connector" → URL https://mcp.nano.cpl.ai/mcp.

Was das Skill macht​

Das Skill ist ein Ordner mit Markdown-Files:

skills/nano-banana/
├── SKILL.md              # Trigger-Phrasen, MCP-Registration-Check, Workflow
├── references/
│   ├── tools.md          # Tool-Contracts + Arg-Shapes (Spiegel dieser Site)
│   ├── workflows.md      # Decision Tree: wann architecten vs. one-shotten
│   └── styling.md        # Wie concept_id den brand-styled Prompt trägt
└── VERSION

Wenn Claude einen Request wie "generiere mir ein Marketing-Bild von X" oder "zeig mir mal ein paar Optionen für eine Hero-Illustration" sieht, springt das Skill an und führt Claude durch:

  1. Setup-Check — die vier MCP-Tools müssen da sein, sonst klare Fehlermeldung.
  2. Workflow-Entscheidung — erst Concepts vorschlagen oder direkt One-Shot, abhängig davon, wie konkret der Prompt schon ist.
  3. Generieren — das richtige Tool mit den richtigen Args aufrufen, und bei gewähltem Concept die concept_id durchreichen, damit das Brand Styling nicht verlorengeht.
  4. Progress zurückspielen — bei synchronen Calls die Per-Stage- Progress-Notifications an den User durchreichen; bei async ein Follow-up via get_image vorschlagen.

Den Warum-Teil hinter dem Workflow-Split findest du unter Brand Styling.