Agent Skill Integrationsanleitung

Diese Anleitung richtet sich an AI Agents, Skill-Autor:innen und Builder von Automatisierungsworkflows. Es geht nicht primär darum, einem Menschen einen manuellen REST-Aufruf zu zeigen. Ziel ist, Mew.Design als wiederverwendbare Designfähigkeit in einem Agent zu kapseln.

Nutze /open/api/design/generate, wenn du einen Skill, ein Tool, Plugin oder einen Workflow entwirfst, der im Namen des Users visuelle Designs erstellen soll.

Was der Skill tun sollte

Ein Mew.Design Skill sollte einen Agent befähigen, die Designanfrage des Users in einen strukturierten Designgenerierungs-Aufruf zu übersetzen. Er sollte:

• erkennen, wenn der User ein visuelles Design möchte, etwa Poster, Flyer, Infografik, Karte, Social Post, Visitenkarte oder Menü,
• fehlende Pflicht-Assets wie Logos, QR-Codes, Produktfotos, Screenshots oder Referenzen abfragen,
• die Anfrage in ein vollständiges userQuery mit exaktem Text, Zweck, Zielgruppe, Layout und Stil übersetzen,
• Mew.Design über die Open API aufrufen,
• die generierte designUrl zurückgeben, kurz erklären, was erstellt wurde, und Fehler klar benennen,
• den API-Schlüssel schützen und niemals in Antworten, Logs, Screenshots oder generierten Dateien offenlegen.

Empfohlener Integrationspfad

Situation	Verwenden
Du schreibst einen Agent Skill oder Tool Wrapper	/open/api/design/generate
Dein Client unterstützt bereits Remote MCP Server	https://api.mew.design/mcp
Ein Mensch möchte manuell gestalten	Mew.Design Workspace

Standard für Skills

Für wiederverwendbare Skills ist die Open API die beste Voreinstellung. Der Skill kann dann selbst entscheiden, wann er Rückfragen stellt, Assets prüft, den Endpunkt aufruft und Ergebnisse präsentiert.

Skill-Installationsbrief für Agents

Wenn deine Umgebung installierbare Skills unterstützt, erstelle einen Skill namens mew-design mit einer Triggerbeschreibung wie:

name: mew-design
description: Use when the user asks to create, redesign, generate, or refine visual designs such as posters, flyers, infographics, social posts, cards, menus, business cards, banners, invitations, or marketing graphics with Mew.Design.

Der Skill-Body sollte diesen Ablauf enthalten:

1. Designbrief sammeln: Format, Zielgruppe, Zweck, exakter Text, Layout, Stil, Grösse und benötigte Assets.
2. Wenn der User Logo, QR-Code, Produktbild, Screenshot oder Stilreferenz erwähnt, aber keine erreichbare Bild-URL liefert, zuerst danach fragen.
3. userQuery als vollständiges Designbriefing schreiben und exakte User-Texte erhalten.
4. assetImages für Elemente verwenden, die im finalen Design erscheinen müssen.
5. referenceImage nur für Stil-Inspiration verwenden.
6. POST https://api.mew.design/open/api/design/generate aufrufen.
7. Generierte Design-URL und kurze Zusammenfassung zurückgeben.
8. Bei Fehlern erklären, ob es um Auth, Credits, Asset-URL, Timeout oder Validierung geht.

Skill-Konfiguration

Der Skill benötigt einen Mew.Design API-Schlüssel.

1. Bitte den User, in den Account Settings einen API-Schlüssel zu erstellen.
2. Speichere ihn als Secret, zum Beispiel MEW_DESIGN_API_KEY.
3. Lies ihn zur Laufzeit aus der Umgebung.
4. Schreibe den Schlüssel nie direkt in Skill-Anweisungen oder Quellcode.

Umgang mit Secrets

Der API-Schlüssel verbraucht Credits des Users. Ein Skill muss ihn wie ein Passwort behandeln: nicht ausgeben, nicht committen, nicht in Artefakte schreiben.

Open-API-Vertrag für den Skill

• Endpoint: POST https://api.mew.design/open/api/design/generate
• Auth: X-Api-Key: $MEW_DESIGN_API_KEY oder Authorization: Bearer $MEW_DESIGN_API_KEY
• Content-Type: application/json
• Timeout-Empfehlung: bei komplexen Designs bis zu 120 Sekunden einplanen

Request-Parameter

Parameter	Typ	Verwendung im Skill
userQuery	string	Erforderlich. Vollständiges Designbriefing mit exaktem Text, Inhaltsstruktur, Zweck, Zielgruppe, Layoutanforderungen und Einschränkungen.
designConcept	string	Optional. Kurze visuelle Richtung: Farben, Typografie, Stil, Stimmung, Layoutansatz.
referenceImage	object	Optional. Nur Stilreferenz. Enthält direkte Bild-url und optionales tag.
width	number	Optional. 1 bis 5000 Pixel, Standard 1080.
height	number	Optional. -1 für automatische Höhe oder 100 bis 5000 für feste Höhe.
assetImages	array	Optional. Bilder, die in das finale Design integriert werden müssen, etwa Logos, QR-Codes, Produktfotos oder Screenshots.

Keine Fake-URLs

Wenn der User keine Bild-URL bereitstellt, keine Platzhalter erfinden. Frage nach dem Asset oder fahre nur dann ohne Asset fort, wenn das Design trotzdem sinnvoll erstellt werden kann.

Beispiel Skill Call

curl -X POST https://api.mew.design/open/api/design/generate \
  -H "X-Api-Key: $MEW_DESIGN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "Erstelle einen Instagram-Post für Maple Street Cafe. Füge diesen exakten Text ein: \"Fall in Love with Every Sip\", \"20% Off All Week\" und \"Available at Maple Street Cafe\". Verwende warme Herbstfarben, einen hochwertigen Cafe-Stil und lasse oben links Platz für das Logo.",
    "designConcept": "Warme Herbstkampagne für Cafe, hochwertige Typografie, gemütliche Produktpromotion, klares Social-Media-Layout",
    "width": 1080,
    "height": 1080
  }'

Erfolgreiche Antwort

{
  "flag": true,
  "statusCode": "B000000",
  "message": "success",
  "data": {
    "success": true,
    "designUrl": "https://...",
    "message": "Visual design generated successfully."
  }
}

Der Skill sollte data.designUrl an den User zurückgeben und das Ergebnis kurz zusammenfassen.

Prompting-Regeln für Agents

Beim Verwenden des Skills sollte der Agent wie bei einem Designbrief schreiben, nicht wie bei einem Einzeilen-Bildprompt.

Gutes userQuery enthält:

• Ausgabeformat und Kanal
• Zielgruppe und Zweck
• exakten einzufügenden Text
• visuelle Hierarchie und Layoutprioritäten
• Markenfarben, Stimmung oder Typografie
• Assets, die erscheinen müssen
• Einschränkungen wie “Logo nicht verändern” oder “QR-Code lesbar halten”

Schlechtes userQuery:

Mach ein cooles Poster.

Besseres userQuery:

Erstelle ein vertikales Eventposter für eine studentische Jazz Night. Enthält den exakten Titel "Midnight Brass", Datum "June 18", Uhrzeit "8 PM", Ort "Blue Hall" und CTA "Reserve your seat". Verwende eine dunkle Navy-Gold-Palette, grosse elegante Typografie, Blechblasinstrument-Akzente und ein klares Layout, bei dem Datum und Ort aus der Entfernung lesbar bleiben.

Fehlerbehandlung für Skills

Der Skill sollte Fehler in konkrete nächste Schritte übersetzen:

• Fehlender oder ungültiger Schlüssel: User bitten, MEW_DESIGN_API_KEY zu konfigurieren.
• Zu wenige Credits: Erklären, dass der Account mehr Credits benötigt.
• Ungültige Asset-URL: Nach einer direkten öffentlichen Bild-URL fragen.
• Timeout: Weniger Komplexität, weniger Assets oder kleinere feste Abmessungen vorschlagen.
• Validierungsfehler: Benennen, welches Feld korrigiert werden muss.

Optionale MCP-Konfiguration

Wenn die Agent-Plattform bereits Remote MCP Server unterstützt, kann der User Mew.Design direkt konfigurieren:

• Server URL: https://api.mew.design/mcp
• Tool name: generateDesign
• Bevorzugter Auth-Header: X-Api-Key: your-api-key
• Kompatibler Bearer-Header: Authorization: Bearer your-api-key

{
  "mcpServers": {
    "mew-design": {
      "url": "https://api.mew.design/mcp",
      "headers": {
        "X-Api-Key": "your-api-key"
      }
    }
  }
}

MCP ist kein normaler REST-Endpunkt

https://api.mew.design/mcp ist für MCP-kompatible Clients. Ein Skill, der normales JSON über HTTP senden will, sollte /open/api/design/generate verwenden.

Credit-Hinweise

Designgenerierung folgt den aktuellen Mew.Design-Credit-Regeln:

• Neues Design generieren: 10 Credits
• Designänderung im Workspace: 5 Credits
• Premium-Bildmodelle: 2-60 Credits, abhängig von Modell und Einstellungen
• Download: keine zusätzlichen Credits

Prüfe die Pricing-Seite, bevor du feste Kosten in einer öffentlichen Skill-Beschreibung hinterlegst.

Bereit, den Skill zu installieren?

Erstelle einen API-Schlüssel, speichere ihn als MEW_DESIGN_API_KEY und füge den oben beschriebenen mew-design Skill-Workflow zu deiner Agent-Umgebung hinzu.