Shilo/pixellab-pip

PixelLab Pip

Klassifiziere zuerst die Absicht des Benutzers bezüglich Assets, API oder Frage und wähle dann die unterstützte PixelLab-Oberfläche aus. Beantworte Fragen direkt, wenn die Anfrage eine Frage ist.

Arbeitsablauf

1. Klassifiziere die Anfrage: question | setup | create asset | edit/transform | animate | prompt_enhancement | integrate/code | check balance/status | troubleshoot docs/API | website/editor assistance. Behandle ein eigenständiges setup-Wort nach einem expliziten Skill-Aufruf, wie /pixellab-pip setup oder @pixellab-pip setup, als Setup-Absicht. Wenn eine App strukturierte Argumente bereitstellt, verwende sie nur als alternative Möglichkeit, dieselbe natürlichsprachliche Absicht zu lesen.
2. Klassifiziere das Ziel-Asset oder die Ziel-Oberfläche: general_image | background | character | object | effect_vfx | ui | whole_map | map_image | map_object | top_down_tileset | sidescroller_tileset | isometric_tile | tile_variants | animation | existing_image.
3. Wähle die Oberfläche: Verwende PixelLab MCP für verwaltete Coding-Agent-Assets, REST v2 für direkte API/Code/Batch-Primitive, Website/Aseprite/Pixelorama nur als menschliche/Editor-Oberflächen und REST v1 nur für Legacy-Kompatibilität. Für die Setup-Absicht lies references/setup.md und führe den Setup-Assistenten-Vertrag aus: Empfehle zuerst MCP + API, unterstütze reine MCP-/API-/manuelle Modi und ändere Einstellungen erst nach einer tokenfreien Vorschau und expliziter Zustimmung.
4. Verwende MCP nur, wenn PixelLab MCP-Tools verfügbar sind, entweder bare oder prefixed. Wenn MCP nicht verfügbar ist, leite zum passenden REST v2-Endpunkt weiter, wenn dieser dokumentiert ist. Wenn MCP und REST v2 beide nicht verfügbar sind oder fehlschlagen, erkläre den Grund, bevor du einen Nicht-PixelLab-Fallback verwendest. Wenn Tools prefixed sind, wie mcp__pixellab__create_character, gleiche per Suffix ab.
5. Aktualisiere die aktuellen Fakten, wenn ein benötigtes Tool/Endpunkt/Feld fehlt oder unklar ist, oder wenn Auth, SDK-Support, Preise, Modell/Modus-Verfügbarkeit oder die neuesten MCP-Tools von Bedeutung sind.
6. Für konsistenzsensible Arbeiten fasse die Identität, den Stil, die Palette, die Ansicht und die Referenzanker des Benutzers zusammen. Stelle vor einem kreditauslösenden Aufruf bis zu drei blockierende Fragen.
7. Für PixelLab-Natürlichsprachen-Anforderungsparameter wie description, action, *_description, item_descriptions, text oder color_palette verbessere vage Benutzerformulierungen in endpointreife englische Parameterwerte, es sei denn, der Benutzer lehnt dies ab. Verwende einen dokumentierten PixelLab-Verbesserungs-Endpunkt nur, wenn er zur gewählten Route passt; ansonsten verbessere direkt aus der Anfrage und den sichtbaren Eingaben. Bei nicht-englischen oder gemischtsprachigen Anfragen lies references/localization.md.
8. Bestätige vor der Live-Generierung, dass das PixelLab-Bearer-Token konfiguriert ist, ohne den Benutzer zu bitten, es in den Chat einzufügen.
9. Handle oder antworte. Stelle nur eine kurze Klärung bei bekannten Kollisionen.

Oberflächenregeln

Oberfläche	Verwende für	Vermeide
Gehostetes MCP	Workflows, die verwaltete PixelLab-Assets mit IDs, Polling, Download-, Listen-/Get-/Delete-Helpern und Projekt-/Sandbox-/Agent-Helpern benötigen.	Rohe Bild-/Bearbeitungs-/UI-Primitive, die MCP nicht bereitstellt, oder jeden MCP-Aufruf, wenn PixelLab MCP-Tools nicht verfügbar sind.
REST v2	Skripte, Batch-Jobs, Server-Integrationen, genaue Endpunktsteuerung, generische Bilder, Hintergründe, UI, Inpaint/Bearbeitung, Prompt-Verbesserung, rohe Animation, Drehen, Größe ändern, Hintergrund entfernen und API-Paritätsprüfungen.	SDK-Methoden zu erraten, ohne das installierte SDK oder die aktuellen Dokumente zu überprüfen.
Website / Map Workshop	Menschliche Produktoberfläche, manuelle Vollkartenarbeit, umfangreiche Bibliotheken, sichtbare Browserunterstützung und reine Website-Workflows.	Programmatische Verwendung von kopierten Browser-Sitzungstoken oder undokumentierten Root-Endpunkten.
Aseprite	Lokale In-Editor-Plugin-Workflows, wenn der Benutzer aktiv innerhalb von Aseprite arbeitet.	Lokale Plugin-Routen als öffentliche REST/MCP-Verträge zu behandeln.
Pixelorama / Editor	Sichtbare Browserunterstützung für Website-Editor-Workflows, einschließlich vorhandener Assets, Save-Back-Workflows und reiner Website-Workflows nach expliziter Genehmigung.	Versteckte Automatisierung, undokumentierte Endpunktaufrufe, öffentliche API-Annahmen oder Generierungs-/Speicher-/Download-/Bearbeitungs-/Löschaktionen ohne zweite Bestätigung.
REST v1	Vorhandener Legacy-Code und alte SDK-Kompatibilität.	Neue Arbeit, es sei denn, der Benutzer benötigt explizit v1.

Gehostete MCP-Toolnamen sind keine REST-Endpunkte. Führe keine curl-Aufrufe gegen MCP-Toolnamen als /v2/...-Pfade durch.

Absichtsrouter

Benutzerabsicht	Standardroute nach Oberflächenregeln	REST v2-Route, wenn Kodierung/genaue Steuerung erforderlich ist
Figur, Spieler, NPC, Gegner, Kreatur	MCP create_character, dann create_character_state, animate_character, get_character, Listen-/Lösch-Helper und delete_animation, wenn explizit angefordert. Für eine Folgeanimation einer vorhandenen mehrrichtungsspezifischen Figur standardmäßig die Süd-/Abwärtsrichtung für den ersten Kandidaten, wenn der Benutzer keine Richtung angibt; frage nach oder hole eine Bestätigung, bevor du alle Richtungen animierst.	Figuren-Endpunkte wie create-character-v3, create-character-with-4-directions, create-character-with-8-directions, create-character-pro, Zustand, Animation, Tags, ZIP/Listen-/Get-/Delete-Endpunkte.
Objekt, Requisite, Gegenstand, Pickup, Waffe, Möbel	MCP create_1_direction_object, create_8_direction_object, create_map_object, Objekt-Zustands-/Animations-/Überprüfungs-/Tag-Tools.	Objekt-Endpunkte wie create-1-direction-object, create-8-direction-object, map-objects, Objekt-Zustands-/Animations-/Tags-/Listen-/Get-/Delete-Endpunkte.
Top-Down-Terrain-Kachelsatz, Wang/Autotile/RPG-Kachelsatz	MCP create_topdown_tileset.	create-tileset, tilesets.
Seitenroller/Plattformer-Kachelsatz	MCP create_sidescroller_tileset.	create-tileset-sidescroller, Seitenroller-Kachelsatz-Endpunkte.
Isometrische Kachel/Block/Boden	MCP create_isometric_tile.	create-isometric-tile.
Kachelvarianten / Tiles Pro	MCP create_tiles_pro für einzelne Kachelvarianten wie Hex, Achteck, quadratisch top-down und isometrische Kacheln.	create-tiles-pro, tiles-pro/{tile_id}.
Allgemeines Bild, Sprite, symbolartiges eigenständiges Asset	REST v2.	create-image-pixen, generate-image-v2, create-image-pixflux, create-image-bitforge, generate-with-style-v2.
Hintergrund, Szene, Umgebung, Hintergrundbild	REST v2-Bildgenerierung; kein direktes gehostetes MCP-Hintergrundtool wurde dokumentiert.	Verwende normale Bildgenerierung mit einem Szenen-/Hintergrund-Prompt. Nimm nicht an, dass create-image-pixflux-background einen Szenen-Hintergrund-Generator bedeutet, ohne die aktuellen Dokumente zu überprüfen.
UI, HUD, Button, Panel, Gesundheitsbalken, Menü	REST v2.	generate-ui-v2. Die Website-UI-Bibliothek ist eine menschliche/Editor-Oberfläche, es sei denn, es gibt öffentliche Lebenszyklus-Endpunkte.
Bildbearbeitung, Inpaint, Maske, Konvertieren, Größe ändern, Hintergrund entfernen	REST v2.	inpaint, inpaint-v3, edit-image, edit-images-v2, image-to-pixelart, image-to-pixelart-pro, resize, remove-background.
Farben reduzieren / Palette quantisieren	Website/Editor/lokales Bild-Tooling.	Es wurde kein öffentlicher REST v2/MCP reduce-colors-Endpunkt dokumentiert; verwende Website-Dokumente oder lokales Tooling, anstatt eine Route zu erfinden.
Pixelkunst entzoomen / Upscaling entfernen	Aseprite- oder Pixelorama-Erweiterung.	Website-Dokumente listen dies als reine Editor-Erweiterung auf; leite nicht an REST/MCP weiter, es sei denn, offizielle Dokumente fügen einen Endpunkt hinzu.
Kleidungsstück/Gegenstand an Figur anprobieren	Website Try on für einfache experimentelle Bildausgabe; REST transfer-outfit-v2 nur für Animationsrahmen-Kleidungsübertragung.	Try on gibt ein zusammengesetztes Bild zurück, keine isolierten Paperdoll-Layer.
Mehrere Bilder als Referenzen kombinieren	Website experimenteller Workflow oder nächste dokumentierte REST-Bild-/Bearbeitungsroute nach Überprüfung der Dokumente.	Es wurde keine direkte öffentliche REST v2/MCP "Multi Image"-Route dokumentiert.
Figurenproportionen umformen	Website Reshape oder nächste dokumentierte Bearbeitungs-/Figurenroute nach Überprüfung der Dokumente.	Website-Dokumente erfordern eine exakte 64x64-Leinwand; es wurde kein öffentlicher REST v2/MCP reshape-Endpunkt dokumentiert.
Prompt-Verbesserung, Generierungsprompt verbessern	Standardmäßig agentenseitige Neuschreibung für nicht zugeordnete Routen; REST v2 nur für dokumentierte passende Verbesserungs-Endpunkte.	enhance-pixen-prompt, enhance-character-v3-prompt oder enhance-animation-v3-prompt. Verwende keinen nicht passenden Verbesserungs-Endpunkt als generischen Optimierer, es sei denn, der Benutzer fragt explizit danach.
Rohe Animation, Skelett, Interpolation, Kleidungsübertragung, Drehen	REST v2, es sei denn, du animierst eine verwaltete MCP-Figur/ein verwaltetes MCP-Objekt.	animate-with-text*, animate-with-skeleton, estimate-skeleton, edit-animation-v2, interpolation-v2, transfer-outfit-v2, rotate, generate-8-rotations-v2/v3.
Kartenbild, generiertes Levelbild, visuelles Kartenkonzept	REST v2-Bild-/Hintergrund-Route; Website für Kartenerweiterungs-/Textur-Workflows.	Es wurden keine vollständigen öffentlichen REST/MCP-Karten-CRUD-, -Erweiterungs- oder -Texturoberflächen dokumentiert.
Kartenobjekt	MCP create_map_object plus standardmäßig get_map_object.	POST /map-objects; MCP-Kartenobjekte werden nach 8 Stunden automatisch gelöscht. Überprüfe das aktuelle REST-Ergebnis und das Polling-Verhalten anhand der OpenAPI, bevor du Code schreibst.
Gesamte Karte, Map Workshop, Karten-CRUD/Export	Website manuell oder generiere Komponenten mit MCP/REST.	Es wurde in der Recherche keine vollständige öffentliche REST/MCP-Karten-CRUD-Oberfläche dokumentiert.
Statischer Effekt oder VFX-Sprite	REST v2-Bild-/Bearbeitungs-Route. Wenn ein Ziel-Sprite/-Bild bereitgestellt wird und der Benutzer bittet, einen Effekt/Trail/Aura/Impact hinzuzufügen, zu zeichnen, zu überlagern oder anzuwenden, behandle das bereitgestellte Bild als Bearbeitungsziel und verwende REST-Bildbearbeitung. Verwende Objekt-/Bildgenerierung nur, wenn der Benutzer nach einem separaten wiederverwendbaren Effekt-Asset/-Layer fragt oder kein Zielbild bereitgestellt wird.	Es wurde kein eigenständiger öffentlicher VFX-Endpunkt dokumentiert. PixelLab-Bearbeitungsrouten geben ein vollständiges bearbeitetes Bild zurück, keine isolierte Effektebene.
Animierter Effekt oder VFX	REST v2-Rohe Animation oder MCP-Objekttanimation, wenn es ein verwaltetes Objekt werden soll.	animate-with-text-v3, animate-with-skeleton oder Objekttanimations-Endpunkte; behandle VFX als Beschreibung, nicht als separaten Endpunkt.
Guthaben, Credits, Kontoprüfung	MCP get_balance, falls verfügbar.	GET /balance.
REST-Async-Job-Status	REST v2.	GET /background-jobs/{job_id}. MCP-verwaltete Assets verwenden stattdessen ressourcenspezifische get_*-Tools.
PixelLab-Projekte, Sandbox, bereitgestellte Agenten-Workflows, Chat, MCP-Hilfe/Feedback	MCP list_projects, sandbox_*, chat_*, agent_help, agent_feedback, agent_list, agent_inspect und agent_talk-Tools, falls verfügbar.	Es wurde kein öffentliches REST v2-Äquivalent dokumentiert.

Nur bei Kollisionen klären

• "Kacheln": Frage, ob der Benutzer einen Terrain-/Autotile-Kachelsatz, einen Plattformer-/Seitenroller-Kachelsatz oder einzelne Kachelvarianten möchte.
• "Karte": Frage, ob sie eine ganze Karte, ein Kartenobjekt, ein Kartenbild, einen Kachelsatz, eine isometrische Kachel oder Kachelvarianten möchten.
• "Objekt/Figur": Schließe bei Personen, NPCs, Kreaturen, Körpervorlagen oder Identitäts-/Zustandsanimation auf Figur; schließe bei Requisiten/Gegenständen/Möbeln/Waffen auf Objekt. Frage nur, wenn es unklar ist.
• "Figurenanimationsrichtung": Wenn der Benutzer bittet, eine Animation zu einer vorhandenen mehrrichtungsspezifischen Figur hinzuzufügen und keine Richtung nennt, standardmäßig south/abwärts für einen Vorschaumkandidaten. Animiere standardmäßig nicht nach Nordwesten, diagonal oder alle Richtungen. Frage nach der Richtung nur, wenn south nicht verfügbar ist, die Richtungen des Assets unbekannt sind oder der Benutzer eine andere spielausgerichtete Richtung benötigt. Animiere alle Richtungen nur, wenn der Benutzer explizit nach allen/8 Richtungen, einem vollständigen Richtungssatz fragt oder den größeren Batch genehmigt.
• "Effekt": Frage nach statischem Sprite oder animiertem Effekt, wenn nicht offensichtlich. Wenn ein Ziel-Sprite/-Bild bereitgestellt wird und der Benutzer bittet, einen Effekt hinzuzufügen, schließe auf eine einmalige Bildbearbeitung. Frage nach wiederverwendbarem Objekt/Layer vs. einmaligem Sprite nur, wenn es kein klares Bearbeitungsziel gibt oder der Benutzer nach einem separaten Asset fragt.
• "Isometrischer Kachelsatz": Frage, ob sie eine isometrische Kachel oder einen vollständigen Kachelsatz benötigen, da die öffentlichen Dokumente eine einzelne isometrische Kachelroute bereitstellen.
• "Paperdoll": Sammle Basis, Layer, Richtungen, Animationen und isolierte vs. zusammengesetzte Ausgabe; siehe references/paperdolling.md.
• Bereitgestellte Bilder sind optional, es sei denn, die gewählte Route erfordert Bildfelder. Wenn Bilder bereitgestellt werden, schließe die endpointspezifische Rolle jeder Datei aus der Anfrage; frage nur, wenn eine Datei vernünftigerweise Identität, Stil, Konzept, Bearbeitungsziel, Maske, Palette, Init/Quelle, erster Rahmen oder letzter Rahmen sein könnte.
• Wenn die Prompt-Verbesserung aus Bildern oder Benutzer-Kurzschrift abgeleitete Materialdetails hinzufügt, zeige die vorgeschlagene Beschreibung an und hole eine Bestätigung, bevor eine kreditauslösende Generierung oder Bearbeitung durchgeführt wird.

Lies nur die relevante Referenz:

• Bearer-Token-Einrichtung, PixelLab UI-Benennung und MCP-Auth-Wiederverwendung: references/credentials.md.
• Natürlichsprachlicher Setup-Modus für MCP/API/Auth nach der Installation: references/setup.md.
• Browser-Fallback und Website-Automatisierungsgrenzen: references/browser-fallback.md.
• Paperdolling und Workflows mit geschichteten Figuren: references/paperdolling.md.
• Details zu Kachelsätzen und Kachelvarianten: references/tilesets.md.
• Anhänge, Dateipfade, Rollen bereitgestellter Bilder, Endpunktfelder oder Bild-zu-Pixelkunst mit fester Größe: references/image-inputs.md.
• Nicht-englische oder gemischtsprachige Benutzeranfragen und Handhabung der Antwortsprache: references/localization.md.
• Offizielle PixelLab-Dokumente, MCP-Dokumente, REST-Dokumente und Web-Refresh-Routing: references/official-docs.md.
• Nutzung, Guthaben, Jobs und Ergebnisberichterstattung: references/usage-reporting.md.
• Lokale Animationsvorschau-GIFs, Spritesheets oder ImageMagick/magick-Zusammenstellung aus generierten Rahmen: references/local-asset-assembly.md.

Optionale umfassendere Dokumente: Bei vollständigen Plugin-/Repo-Installationen lösen sich diese Pfade relativ zu dieser SKILL.md auf; reine Skill-Installationen können sie weglassen. Wenn die Laufzeit-references/ nicht ausreichen, lies höchstens eine passende Datei, falls sie existiert. Wenn nicht vorhanden, fahre mit references/official-docs.md und den aktuellen offiziellen PixelLab-Dokumenten fort; suche oder lade die Menge nicht.

• Oberflächengrenzen und Dienstauswahl: ../../docs/pixellab/surfaces-and-services.md.
• Asset-Routing in einfacher Sprache: ../../docs/pixellab/asset-routing.md.
• Produkt-/Modell-/Modus-Terminologie: ../../docs/pixellab/terminology.md.
• S

…

[gekürzt für die Übersetzung]