CommunityBildgithub.com

asset

Generiere finale In-Game-Bild-Assets (Icons, Items, Hintergründe, Charaktere, Store-Grafiken) mit OpenAIs neuestem GPT Image Model, Version 2 oder später, abgestimmt auf den vorhandenen Kunststil des Spiels.

Was ist asset?

Diese Fähigkeit generiert endgültige In-Game-Bild-Assets wie Icons, Items, Hintergründe, Charaktere und Store-Grafiken mithilfe von OpenAIs neuestem GPT Image Model (Version 2 oder neuer). Sie ist darauf ausgelegt, den vorhandenen Kunststil des Spiels zu treffen, indem sie Referenz-Assets (`--ref`) liest und den Stil in jedem Prompt einheitlich beschreibt. Die Fähigkeit unterstützt die Planung einer Liste von Assets, die Generierung mit automatischer Modellauswahl (das aktuellste GPT-Image-Modell, `--model auto`, oder ein benutzerdefiniertes Modell aus der Konfiguration), sowie die Überprüfung jedes Bildes auf Konsistenz mit dem Stil, Artefakte oder Textprobleme. Für Transparenz verwendet sie `--background transparent`, bei Ablehnung durch das Modell wird ein flacher Hintergrund hinzugefügt und später entfernt. Die Ergebnisse werden als PNGs im konfigurierten Asset-Pfad ausgegeben, mit einem Log der Prompts und Modelle. Bei der ersten Verwendung erklärt die Fähigkeit die Einrichtung eines OpenAI-API-Keys und bietet Optionen zum Aktivieren, Deaktivieren oder Überspringen für das Projekt. Die Generierung kann für eine Liste von Assets bestätigt werden, mit maximal 3 Wiederholungen pro fehlerhaftem Bild. Der Bericht listet jedes Asset mit Pfad, Größen, Modell und etwaigen Flags auf und weist auf KI-Generierung hin, um Offenlegungspflichten (z. B. in Store-Listings) zu erfüllen.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/robson-work/gd-toolkit/tree/HEAD/skills/asset

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

Finale Bild-Assets

<skill-dir> ist der Ordner, der diese SKILL.md enthält, und <plugin-root> liegt zwei Ebenen darüber. Ersetze sie in Befehlen mit den echten Pfaden. (In Claude Code sind sie ${CLAUDE_SKILL_DIR} und ${CLAUDE_PLUGIN_ROOT}.)

Eingabe: ein Asset oder eine Liste, z. B. „Streak-Freeze-Icon“ oder „die 6 Belohnungsicons im GDD der täglichen Quests“. Ausgabe: PNGs im Asset-Pfad des Spiels, jedes mit seinem Prompt und Modell protokolliert.

Lies zuerst <plugin-root>/shared/conventions.md und die Repository-Konfiguration (Art-Abschnitt).

GI="<skill-dir>/scripts/gen_image.py"   # Nur Python 3; gibt niemals den Key aus
python3 "$GI" check                              # Key + Modell, das verwendet würde, keine Kosten (aus dem Spiel-Repository ausführen)
python3 "$GI" generate --prompt "…" --out <datei.png> [--size BxH] [--background transparent] [--ref <kunst.png> …] [--log <log.jsonl>]

0. Ist die Bildgenerierung für dieses Projekt aktiviert?

Lies config: Image generation:

  • on: gehe zu Schritt 1.
  • off: nicht generieren. Verwende vorhandene Kunst oder das Platzhalter-Muster des Repositorys und liste die noch benötigten Assets (Name, Größe, Verwendung) im Bericht auf. Nicht erneut fragen.
  • not set oder fehlend: dies ist das erste Bild für dieses Projekt. Führe check aus, frage dann mit dem Frage-Tool:
    • Wenn kein Key gefunden wurde, teilt die Frage mit, dass finale Assets standardmäßig OpenAIs GPT Image (neueste Version, 2 oder später) verwenden und ein API-Key benötigt wird. Die Optionen sind:
      1. Jetzt einen Key einrichten (empfohlen): zeige die Einrichtungsschritte unten an und warte, bis der Benutzer sagt, dass es erledigt ist. Führe dann erneut check aus. Wenn es bereit ist, schreibe on.
      2. Nicht für dieses Projekt: schreibe off (opted out <YYYY-MM-DD>) und fahre ohne generierte Kunst fort.
      3. Nicht jetzt: überspringe Bilder dieses Mal, lasse das Feld not set und frage beim nächsten Mal erneut.
    • Wenn ein Key gefunden wurde (in der .env des Repositorys, in der Umgebung oder für ein anderes Projekt eingerichtet), nennt die Frage, wo er gefunden wurde und das Modell, das check ausgewählt hat. Wenn check sagt, dass die .env-Datei von Git getrackt wird, warne, dass der Key committed ist und rotiert werden sollte, und empfehle, ihn aus Git zu entfernen. Die Optionen sind: für dieses Projekt verwenden (empfohlen, dann schreibe on), nicht für dieses Projekt (off), und nicht jetzt.

API-Key-Einrichtung (dem Benutzer anzeigen)

  1. Gehe zu platform.openai.com → API keys → Create new secret key. Ein projektspezifischer Key ist am besten.
  2. Stelle sicher, dass Billing Guthaben hat. GPT-Image-Modelle können dich auffordern, deine Organisation zu verifizieren (Settings → Organization → General). Der Zugriff kann nach der Verifizierung einige Minuten dauern.
  3. Speichere den Key auf diesem Rechner. Füge ihn niemals in den Chat ein.
    • macOS (empfohlen): führe dies im Terminal aus. Es fragt nach dem Key, ohne ihn anzuzeigen, und speichert ihn im Schlüsselbund: security add-generic-password -U -a "$USER" -s gd-toolkit-openai -w
    • Nur dieses Projekt: füge OPENAI_API_KEY=… zur .env oder .env.local des Repositorys hinzu. Überprüfe zuerst, dass die Datei in .gitignore ist.
    • Überall: füge export OPENAI_API_KEY=… zu deinem Shell-Profil hinzu, z. B. ~/.zshrc, und öffne dann ein neues Terminal.
    • Oder verwende eine nur für dich lesbare Datei: ~/.config/gd-toolkit/openai_api_key (chmod 600).
  4. Sag mir, wenn es erledigt ist, und ich überprüfe es. Diese Überprüfung kostet nichts.

Ein Key im Schlüsselbund, in der Shell oder in der Konfigurationsdatei funktioniert für jedes Projekt; ein .env-Key funktioniert für sein Repository und überschreibt den Schlüsselbund. Die Ein-/Aus-Wahl wird pro Projekt getroffen.

1. Plane die Assets

  • Stil: lies config: Art style und betrachte die darin aufgeführten Referenzkunstwerke. Übergib 1–4 der ähnlichsten vorhandenen Assets als --ref, damit neue Kunst zum Spiel passt. Beschreibe den Stil in jedem Prompt mit denselben Worten: Palette, Linienstärke, Schattierung, Kamerawinkel und Material.
  • Spezifikationen: für jedes Asset: seine endgültige Größe, sein Format, ob es Transparenz benötigt, sein Dateiname und sein Pfad (config: Assets dir, plus das Namensmuster des Repositorys).
  • Zeige die Liste mit der Gesamtzahl und dem Modell an und generiere, sobald der Benutzer zustimmt. Eine Bestätigung deckt den gesamten Batch ab.

2. Generiere

  • Modell: --model auto (Standard) verwendet das neueste gpt-image-Modell, Version 2 oder später, das der Key verwenden kann, und bevorzugt die detaillierte Variante für finale Kunst. --fast (übergeben als --prefer fast) ist nur für Entwürfe. Wenn config: Image model ein Modell nennt, übergib es mit --model.
  • Größe: generiere mit dem größten Quadrat oder dem nächstgelegenen Seitenverhältnis des Modells und skaliere dann auf die endgültigen Größen herunter (sips -Z <px> auf macOS). Niemals hochskalieren.
  • Transparenz: Icons, Items und Sprites benötigen --background transparent. Wenn die Ausgabe anmerkt, dass das Modell es abgelehnt hat, wurde das Bild deckend gemacht: generiere erneut mit einer flachen, einfarbigen Hintergrundfarbe, die im Prompt genannt wird, entferne diese Farbe und erwähne dies im Bericht.
  • Prompt: beschreibe das Subjekt, dann den Stilblock, dann die Komposition (zentriert, Abstand, kein Text, wenn nicht gewünscht). Bitte um keine Wörter, Logos oder Wasserzeichen, es sei denn, das Asset benötigt Text.
  • Protokolliere jede Generierung in config: Art log (--log). Platziere niemals Metadatendateien neben den ausgelieferten Assets.

3. Überprüfe jedes Bild

Betrachte jedes Bild, bevor du es behältst, und verwende eine kleine Kopie, um Kontext zu sparen. Generiere es erneut, maximal 3 Mal, wenn es nicht zu den Stilreferenzen passt, ungewollten Text oder Artefakte aufweist, falsch beschnitten ist oder in seiner kleinsten In-Game-Größe unlesbar ist. Wenn es immer noch fehlschlägt, behalte das beste und markiere es.

4. Bericht

Liste jedes Asset mit seinem Pfad, Größen, Modell und etwaigen Flags auf. Gib auch die noch benötigten Assets an (wenn die Generierung off oder übersprungen wurde) sowie den Log-Pfad. Sage, dass die Bilder KI-generiert sind, damit der Eigentümer entscheiden kann, wo dies offengelegt werden muss, z. B. in Store-Listings.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills