| name | ai-create-image-set |
| description | Erzeugt einen konsistenten Satz Bilder (Slide-Hintergruende, Bildserien) via OpenAI gpt-image-1. Trigger bei 'Slide-Hintergrund', 'deck background', 'Folien-Bilder generieren', 'praesentations-Hintergruende', 'Hero-Bilder fuer Folien', 'Bildserie'. Nimmt eine Slot-Liste + gemeinsamen Stil-Anker, ruft parallel auf, schreibt PNGs. |
| argument-hint | --slots <FILE.json> [--style PRESET] [--size 1536x1024] [--quality medium|high] [--out-dir DIR] |
/ai-create-image-set -- konsistente Bildserie via gpt-image-1
Zweck: Eine ganze Folien-Serie (oder allgemeine Bildreihe) braucht einheitliche Bildsprache. Statt jedes Bild einzeln zu prompten, definierst du einmal einen Stil-Anker, listest alle Slots mit Motiv-Prompts auf, und das Skill ruft gpt-image-1 parallel auf. Jeder Slot bekommt den gleichen Stil-Anker an den Prompt gehaengt.
Wann nutzen
- Mehrere Slide-Hintergruende fuer ein Deck
- Bildserie fuer Blog/Website mit konsistenter Optik
- Variationen eines Themas mit einheitlicher Bildsprache
Fuer Einzelbilder: siehe /ai-create-image.
Voraussetzungen
- Node.js >= 18 (built-in
fetch)
- OPENAI_API_KEY
Preflight prueft beides plus Live-Validierung gegen /v1/models.
($SKILL = Pfad zum Skill-Ordner, typisch ~/.claude/skills/ai-create-image-set)
Install-Gate (vor jedem Aufruf!)
if [ -f "$SKILL/SKILL_INSTALLED.md" ]; then :
elif [ -f "$SKILL/SKILL_INSTALL_FAILED.md" ]; then cat "$SKILL/SKILL_INSTALL_FAILED.md"; exit 1
else bash "$SKILL/scripts/preflight.sh"
fi
# Windows:
if (Test-Path "$SKILL\SKILL_INSTALLED.md") { }
elseif (Test-Path "$SKILL\SKILL_INSTALL_FAILED.md") { Get-Content "$SKILL\SKILL_INSTALL_FAILED.md"; exit 1 }
else { powershell -ExecutionPolicy Bypass -File "$SKILL\scripts\preflight.ps1" }
Der Wrapper prueft den Gate selbst. Bei fehlendem Marker: Refusal mit klarer Anleitung.
Slot-Datei
JSON-Datei mit Liste der zu erzeugenden Slots:
{
"style": "editorial-photo",
"size": "1536x1024",
"quality": "medium",
"out_dir": "img/backgrounds/ai",
"slots": [
{ "name": "bg-cover", "prompt": "..." },
{ "name": "bg-closing", "prompt": "..." }
]
}
Mitgeliefertes Beispiel: $SKILL/resources/slots.example.json.
Felder:
| Feld | Pflicht | Beschreibung |
|---|
slots | ja | Array von {name, prompt}. name wird Dateiname (<name>.png). |
style | nein | Preset-Name (siehe --list-styles) |
style_text | nein | Freitext-Stilanker -- ueberschreibt style |
size | nein | wie unten |
quality | nein | wie unten |
out_dir | nein | wie unten |
Command-line-Flags ueberschreiben jeweils das JSON.
Ausfuehrung
node "$SKILL/bin/create-image-set.mjs" --slots slots.json
Output:
<out_dir>/<slot>.png
<out_dir>/<slot>.prompt.txt
out_dir ist relativ zu --cwd (Default: aktuelles Verzeichnis).
Idempotent: existierende PNGs werden uebersprungen (--force ueberschreibt).
Bei Erfolg: JSON-Summary auf stdout mit total, ok, fail, elapsed_s, results[].
Optionen
| Flag | Beschreibung | Default |
|---|
--slots FILE | Slot-JSON | (Pflicht) |
--style NAME | Style-Preset (siehe --list-styles) | aus JSON |
--style-text "..." | Freitext-Stilanker | aus JSON |
--size SIZE | 1024x1024 / 1024x1536 / 1536x1024 / auto | 1536x1024 |
--quality LEVEL | low / medium / high / auto | medium |
--out-dir DIR | Ausgabeordner (relativ zu --cwd) | img/backgrounds/ai |
--cwd DIR | Basisverzeichnis | process.cwd() |
--concurrency N | Parallele Requests | 4 |
--model NAME | Modell-Override | gpt-image-1 |
--force | bestehende PNGs ueberschreiben | aus |
--dry-run | Plan zeigen, keine API-Calls | aus |
--list-styles | Style-Presets listen | – |
--show-style NAME | Preset-Text drucken | – |
-h, --help | Hilfe | – |
Stil-Presets (mitgeliefert)
| Preset | Charakter |
|---|
editorial-photo (Default) | Documentary-Consulting-Vibe, gedaempft, Negativraum oben |
dark-cinematic | moody, deep shadows, golden hour |
swiss-minimal | high-key clean, lots of negative space |
hand-drawn-warmth | soft pastel illustration, warm paper |
tech-noir | deep blue/teal + ein Neon-Highlight |
node "$SKILL/bin/create-image-set.mjs" --show-style dark-cinematic druckt den vollen Text.
Slot-Namens-Konvention ()
Beispiele aus Strategie-Decks:
bg-cover # Hero / Eroeffnungsfolie
bg-closing # Abschluss-Folie
bg-{section}-{thema} # z.B. bg-historie-lean, bg-zukunft-buch
Erlaubte Zeichen im Slot-Namen: A-Za-z0-9._-.
Kosten / Geschwindigkeit
Faustregel (gpt-image-1):
| Quality | Size | $/Bild |
|---|
| medium | 1024x1024 | ~$0.02 |
| medium | 1536x1024 | ~$0.03 |
| high | 1536x1024 | ~$0.08 |
Bei --concurrency 4 und 16 Bildern à medium/1536x1024 ungefaehr 0.50 USD und 2 Minuten.
Prompt-Tipps fuer Hintergruende
- "no faces clearly visible" -- sonst zieht das Gesicht Aufmerksamkeit vom Headline-Text
- "negative space in upper third" -- Platz fuer Headlines (oder via CSS-Gradient-Overlay)
- "no text, no logos, no watermarks" -- gpt-image-1 schreibt sonst gerne unsinnigen Text rein
- Single Motiv pro Slide funktioniert besser als komplexe Szenen
- Vermeide "professional businessman" -- generisch; lieber konkretes Setting
Stil aendern (Reset)
- Slot-JSON:
style (oder style_text) anpassen
- Alte PNGs entfernen:
trash <out_dir>/*.png (oder --force)
- Skill erneut laufen lassen
Fehlerfaelle
Erste Anlaufstelle: SKILL_INSTALL_FAILED.md im Skill-Ordner (falls vorhanden).
| Symptom | Ursache | Loesung |
|---|
ERROR: Skill noch nicht installiert | Preflight nicht gelaufen | bash "$SKILL/scripts/preflight.sh" |
HTTP 401 | Key ungueltig/abgelaufen | ~/.claude/.env/ai-create-image-set.env aktualisieren |
HTTP 429 | Rate-Limit | --concurrency 2, Pause, retry |
content_policy_violation | Prompt mit verbotenem Motiv | Slot umformulieren |
HTTP 500 (vereinzelt) | OpenAI-seitig | Skill erneut starten -- skipt was schon da ist, generiert nur die Failed-Slots |
| Bilder uneinheitlich | Stil-Anker zu generisch | style_text schaerfen (Lichtbeschreibung, Palette praezisieren) |
| Text in Bildern | "no text, no watermarks, no signage" explizit in style_text | |
Healthcheck (read-only):
node "$SKILL/scripts/doctor.mjs"
Architektur
~/.claude/.env/ai-create-image-set.env # API-Key Override (pro Nutzer)
$SKILL/config/secrets.default.env # shipped default
$SKILL/resources/style-presets.json # eingebaute Stil-Anker
$SKILL/resources/slots.example.json # Beispiel-Slot-Datei
<cwd>/<out_dir>/<slot>.png # Output
<cwd>/<out_dir>/<slot>.prompt.txt # vollstaendiger Prompt + Stil
