CommunityBildgithub.com

iithink88/cup-shop-illustration

Lade ein Foto eines Kaffees, Tees oder eines anderen Getränks hoch – erkenne automatisch Marke, Becherform, Farben und Zutaten und verwandle es mit Bild-zu-Bild-Generierung in eine 2D-isometrische Miniatur-Ladenillustration (dicke schwarze Konturen, flache Farben, Markentitel, Maskottchen, Treppen und Pflanzen). Anschließend wird das Originalfoto und die Illustration per Code nahtlos zu einem hochauflösenden Vergleichsbild zusammengesetzt. Ausgabe: zwei PNGs (eigenständige Illustration + Vergleichsbild).

Was ist cup-shop-illustration?

Dieses Skill verwandelt ein beliebiges Getränkefoto (Kaffee, Tee, Saft usw.) in eine bezaubernde isometrische Ladenillustration im 2D-Vektor-Stil, inspiriert von Grid Coffee. Es erkennt automatisch Marke, Becherform, Farben und Zutaten des Fotos und entwirft ein architektonisches Gebäude aus dem Becher – mit Fenstern, Treppen, Pflanzen, Maskottchen und einem Titel. Das Skill unterstützt die Arbeit mit Claude Code (oder anderen AI-Agenten) und besteht aus sechs automatischen Schritten: Vorbereitung des Fotos, visuelle Analyse und Erstellung einer „Erkennungskarte“, Zusammenstellung eines optimierten Prompts, Bildgenerierung (mit ImageGen), Qualitätskontrolle sowie Entfernung von Wasserzeichen und Zusammenfügen zum Vergleichsbild. Die finale Ausgabe besteht aus zwei PNG-Dateien: einer eigenständigen Illustration und einem hochauflösenden Vergleichsbild (Originalfoto vs. Illustration). Entwickler können Parameter wie Hintergrundfarbe, Titeltext, Anzahl der Maskottchen, Bildseitenverhältnis und Eingabetreue anpassen. Das Skill verwendet keine Code-basierte Kantenextraktion, sondern überlässt das visuelle Verständnis dem Bildmodell. Es werden nur 2D-Vektorillustrationen erzeugt, keine 3D-Renderings oder fotorealistischen Bilder.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iithink88/cup-shop-illustration/tree/HEAD/cup-shop-illustration

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Ein Getränk, ein kleiner Laden

Lade ein echtes Kaffee-/Teefoto hoch → erhalte eine hübsche, liebevoll gestaltete isometrische Marken-Ladenillustration sowie ein hochauflösendes Vergleichsbild (Originalfoto vs. Illustration).

Kernphilosophie (nur ein Satz) : Behalte die charakteristischen Merkmale des Originalgetränks bei und entwerfe seine architektonische Funktion neu. Es geht nicht darum, „einen ähnlichen Becher zu malen“, sondern darum, „dem Getränk auf dem Foto Fenster, Treppen und kleine Angestellte zu geben“.

So sieht das Endergebnis aus

Am Beispiel des grünen GridCoffee-Bechers: Der grüne Becherkörper wird zum zweistöckigen Ladenhauptgebäude, der cremefarbene Deckel zur Dachterrasse, das weiße Rechteck-Logo bleibt originalgetreu an der Wand; der Becherkörper bekommt Rundbogenfenster und gestreifte Markisen, auf der rechten Seite gibt es eine Holztreppe und Grünpflanzen, vor der Tür stehen ein Maskottchen, kleine Tische und Stühle und ein A-Schild; das gesamte Gebäude ruht auf einer diagonalen Steinplattform; oben steht der runde, fette Titel Grid Coffee / Americano / Yunnan · Giupo Estate vor einem minzgrünen Hintergrund mit weißen Wolken.

Der Stil ist eine 2D-Vektorillustration wie in Adobe Illustrator, keine mit Blender gerenderte 3D-Szene.

Workflow (wird automatisch ausgeführt, keine schrittweise Bestätigung)

Standardmäßig lädt der Benutzer ein Getränkefoto hoch, oft mit zusätzlichen Angaben wie Markenname, Getränkename, Kaffeebohnen-Herkunft oder Kooperationen. Führe die folgenden sechs Schritte in einem Durchgang aus.

Schritt 0 · Bildaufnahme und Vorverarbeitung

PY="$HOME/.workbuddy/binaries/python/envs/default/Scripts/python.exe"
[ -x "$PY" ] || PY="$(command -v python || command -v python3)"
SK="$HOME/.workbuddy/skills/cup-shop-illustration/scripts/imgtool.py"
OUT="<aktuelles Arbeitsverzeichnis>/out/cup-shop-illustration"
mkdir -p "$OUT"

"$PY" "$SK" prepare "<vom Benutzer hochgeladener absoluter Pfad des Fotos>" --out "$OUT/photo_clean.jpg"
  • prepare vereinheitlicht die EXIF-Ausrichtung, konvertiert in sRGB, entfernt Alpha-Kanal, begrenzt die lange Seite auf ≤2048 und gibt eine Informationskarte aus (Breite, Höhe, Ausrichtung, Helligkeit, Hauptfarbe). Die Ausrichtung in der Karte bestimmt das spätere Seitenverhältnis der Leinwand und die Ausrichtung des Vergleichsbilds.
  • Es ändert nur das Dateiformat und die Größe, nicht den Bildinhalt. Verwende photo_clean.jpg für die Bildgenerierung; für die Zusammenstellung wird das Originalfoto des Benutzers verwendet.
  • Falls der Benutzer ein Format wie HEIC/webp hochlädt, das Pillow nicht lesen kann, konvertiere es zuerst mit Systemwerkzeugen in PNG, führe dann diesen Schritt aus und informiere den Benutzer ehrlich.

Schritt 1 · Foto betrachten, „Erkennungskarte“ ausfüllen

Verwende visuelle Fähigkeiten, um das Originalfoto direkt zu betrachten (keine Code-Kantenextraktion, keine vorherige Liniengenerierung). Lies die Felder der Erkennungskarte gemäß references/diagnose.md einzeln aus:

FeldInhalt
MarkennameLogo/Text auf dem Becher, möglichst englischer Name oder Pinyin
GetränkenameVom Etikett, Kassenbon oder Benutzerangaben
BecherformTo-Go-Pappbecher / durchsichtiger Plastikbecher / Dose / Glasflasche, sowie Breite-Höhe-Verhältnis
Obere StrukturFlachdeckel, Trinköffnung, Strohhalm, Milchschaum, Sahne, Deckelfolie
Hauptfarbe / NebenfarbenMit der Hauptfarben-Karte aus Schritt 0 kreuzvalidieren
Logo und TextForm, Position, Farbe (Beispiel: weißer, hohler, rechteckiger Rahmen + auf der unteren Hälfte des Bechers GridCoffee)
Zutaten / DekorationKaffeebohnen, Perlen, Früchte, Keksbrösel, Schichten, Eiswürfel
Herkunft / KooperationYunnan Estate, Kooperations-IP usw., können als Umgebungselemente integriert werden

Regel: Informationen, die der Benutzer explizit angibt, haben Vorrang; was auf dem Foto nicht lesbar ist, wird nicht erfunden; verwende stattdessen Beschreibungen wie „vorhandener Text/Grafik auf dem Becher“. Ändere nicht eigenmächtig die Marke, Farben oder Becherform.

Schritt 2 · Prompt zusammenstellen

Lies references/prompt-master.md und fülle die Hauptvorlage mit den 6 Slots aus (Marke / Getränk / Zusatzangaben / Seitenverhältnis der Leinwand abhängig von der Originalausrichtung / Hintergrundfarbe / Besondere Elemente), um einen vollständigen Prompt zu erhalten.

  • Die Stilklauseln, negativen Begriffe und Kompositionseinschränkungen der Vorlage bleiben originalgetreu erhalten und werden nicht gekürzt.
  • Der endgültige Prompt ist ein zentrales Asset und wird bei der Auslieferung im Originaltext mitgeliefert (Benutzer möchten ihn oft wiederverwenden).
  • Falls chinesische Schriftzeichen benötigt werden, bleibt der Haupttitel auf Englisch; Chinesisch wird nur als dekoratives Element in kleinen Mengen verwendet; KI-generiertes Chinesisch neigt zu Zeichensalat – siehe die Behandlung in diagnose.md.

Schritt 3 · Bildgenerierung (ImageGen Bild-zu-Bild)

⚠️ Vor dem Aufruf muss in der Antwort deutlich gemacht werden: Ein einzelner ImageGen-Durchlauf verbraucht etwa 5–10 Credits. Erst deklarieren, dann aufrufen.

ParameterWert
promptDer vollständige Prompt aus Schritt 2
image1Absoluter Pfad von photo_clean.jpg aus Schritt 0 (echtes Foto, keine reine Text-zu-Bild-Generierung)
sizeBei Hochformat: 1024x1365 (3:4, am 2026-11-08 getestet und funktioniert, tatsächliche Rückgabe 1024x1360; falls abgelehnt, Downgrade auf 1024x1280); Querformat: 1536x1024; Quadratisch: 1024x1024
qualityhigh
input_fidelitymedium (Standard, siehe Parameteranpassung unten)
output_dir$OUT
footnote"" (Wasserzeichen auf Werkzeugseite kann entfernt werden; die Plattform fügt jedoch weiterhin „AI-generiert WORKBUDDY“ ein, entfernt in Schritt 5 mit cleanwm)
styleNicht ausfüllen, der Stil wird durch den Prompt festgelegt

Anpassung input_fidelity: medium erhält sowohl Becherform/Logo/Farben als auch eine Neukomposition. Wenn das Ergebnis zu sehr wie „ein anderer Becher“ aussieht → auf high erhöhen; wenn das Bild wie eine Foto-Nachahmung wirkt und die Perspektive nicht 45° beträgt → auf low reduzieren.

Generiert wird eine eigenständige, vollständige Illustration. Die KI darf niemals direkt ein Links-Rechts-Vergleichsbild zeichnen, und die Illustration darf nicht aus einem Vergleichsbild ausgeschnitten werden.

Schritt 4 · Selbstprüfung

Vergleiche die Ergebnisse nacheinander mit den neun Prüfpunkten aus references/diagnose.md. Drei Pflichtprüfungen:

  1. Kann man auf den ersten Blick das Getränk auf dem Foto erkennen? (Becherform, Hauptfarbe, Logo-Position)
  2. Ist es reine 2D mit dicken schwarzen Konturen + flachen Farben? (Auftreten von Plastik-Optik / Farbverläufen / weichen Schatten = Fehlschlag)
  3. Sind das Gebäude, die Treppen, die Figuren, die Plattform und der Titel vollständig im Bild? (Abschneiden = Fehlschlag)

Bei Nichtbestehen → nur den entsprechenden Teil des Prompts ändern, maximal einmal wiederholen; falls immer noch nicht bestanden, ehrlich ausliefern und mögliche Anpassungsrichtungen erläutern, nicht so tun, als wäre es erfolgreich gewesen.

Schritt 5 · Wasserzeichen entfernen + Code-Zusammenfügen

Die Plattform fügt am rechten unteren Rand der Illustration den weißen Text „AI-generiert WORKBUDDY“ ein, der nicht durch footnote: "" entfernt werden kann. Entferne ihn zuerst rückstandslos, dann füge zusammen:

"$PY" "$SK" cleanwm "$OUT/<Illustrationsdateiname>.png" --out "$OUT/<Originalname>_illustration.png"

"$PY" "$SK" compose \
  --photo "<absoluter Pfad zum Originalfoto des Benutzers>" \
  --art "$OUT/<Originalname>_illustration.png" \
  --out "$OUT/<Originalname>_compare.png"
  • cleanwm verwendet standardmäßig den selective-Modus, der nur die weißlichen Wasserzeichenpixel in Richtung der Hintergrundfarbe zieht. Er schneidet nicht die Plattform ab und beschädigt nicht grüne Blätter. Getestet: keine Rückstände, keine Nähte. Standard --threshold 160; falls sich am rechten unteren Rand helle Dekorationen wie weiße Wolken oder cremefarbene Steinplatten befinden, auf 190–210 erhöhen, um Fehler zu vermeiden. Bei ungewöhnlicher Wasserzeichenposition kann --box "x0,y0,x1,y1" angepasst werden, oder auf --mode fill wechseln (löscht Dekorationen im Bereich, mit Vorsicht verwenden).
  • compose wählt automatisch basierend auf der Originalausrichtung: Hochformat/Quadratisch → Originalfoto links, Illustration rechts; Querformat → Originalfoto oben, Illustration unten. Kann auch mit --layout side|stack erzwungen werden.
  • Die Pixel der Illustration dienen als Basis, die Illustration wird nicht skaliert, das Originalfoto wird proportional angepasst, um ausgerichtet zu werden; weißer Abstand 24px, Außenabstand 24px; Größenunterschiede werden durch Leerraum ausgeglichen.
  • Es wird nicht zugeschnitten, gestreckt oder der Inhalt des Originalfotos verändert. Ausgabe als hochauflösendes PNG.
  • Falls cleanwm fehlschlägt, als Backup: trim <Illustration> --bottom 0.06 --mode pad; dies schneidet jedoch den unteren Bildbereich ab und könnte die Plattform abschneiden, daher nur im äußersten Notfall verwenden.

Schritt 6 · Auslieferung

Verwende present_files, um zuerst das Vergleichsbild und dann die eigenständige Illustration zu präsentieren (beide müssen gezeigt werden). Füge in der Antwort drei Schlussfolgerungen hinzu: die erkannte Marke/das erkannte Getränk, das Seitenverhältnis der Leinwand und den input_fidelity-Wert, die Pfade der beiden Dateien; füge außerdem den vollständigen Prompt im Originaltext bei.

Harte Regeln (Verstoß = Fehlschlag)

  1. Das echte Foto muss als image1 für Bild-zu-Bild-Generierung verwendet werden; es darf nicht nur aufgrund von Text ein Becher neu gezeichnet werden.
  2. Die Zusammenstellung muss mit dem vom Benutzer hochgeladenen Originalfoto erfolgen; es darf nicht ein von der KI neu gezeichnetes „Foto“ als Original ausgegeben werden.
  3. Die ursprüngliche Becherform, Hauptfarbe, Logo und Verpackungsmerkmale müssen erhalten bleiben; neu gestaltet wird die architektonische Funktion, nicht die Verpackung.
  4. Der Aufnahmewinkel des Originalfotos darf nicht mechanisch kopiert werden; es muss eine sinnvolle räumliche Ableitung (45° Schrägsicht isometrisch) vorgenommen werden.
  5. Zuerst die eigenständige vollständige Illustration generieren, dann zusammenfügen; es ist verboten, die Illustration aus einem Vergleichsbild auszuschneiden.
  6. Nur 2D-Vektorillustrationen; 3D-Rendering / fotorealistisch / Aquarell / Farbverläufe / komplexe Lichteffekte sind streng verboten.
  7. Keine Code-Kantenextraktion oder Liniengenerierung; das Bildmodell sollte das Originalbild direkt verstehen.
  8. Vor der Bildgenerierung muss der Kreditverbrauch angekündigt werden; keine schrittweise Bestätigung einholen, alles in einem Durchlauf erledigen.

Anpassbare Optionen

Was geändert werden sollWo ändern
HintergrundfarbePrompt: „Helles, weiches Mintgrün“ → durch eine markenabgestimmte Farbe ersetzen
TiteltextSlot für Haupt-/Untertitel; bei Unsicherheit nur den Markennamen verwenden
Herkunfts-/KooperationselementeSlot „Besondere Elemente“, z. B. Kaffeezweige, Estate A-Schild, Kooperationsfigur
Anzahl Maskottchen / Treppe RutscheAbschnitt „Architekturdesign“ im Prompt – Liste der Einrichtungen
Seitenverhältnis der Leinwandsize in Schritt 3, sowie die Seitenverhältnis-Klausel im Prompt anpassen
Eingabetreueinput_fidelity auf low / medium / high setzen
Abstand und Hintergrundfarbe beim Zusammenfügencompose --gap --pad --bg

Ressourcen

DateiVerwendung
references/prompt-master.mdHauptdatei: Vollständige, wiederverwendbare Prompt-Vorlage, Slot-Tabelle, drei ausgefüllte Beispiele, Liste negativer Begriffe
references/diagnose.mdFoto-Erkennungskarte, neun Selbstprüfpunkte, Tabelle zur Fehlerbehebung, Behandlung chinesischer Schriftzeichen
scripts/imgtool.pyFünf lokale Unterbefehle: prepare / cleanwm / compose / trim / sheet
README.mdChinesische Installations- und Nutzungsanleitung

Verwandte Skills