Prompt engineering image
Skill event4u-app/agent-config/dist/agent-src/skills/prompt-engineering-image
Universal AI Agent OS — audited skills, governance rules, replayable state. One contract, every host agent.
npx -y skills add event4u-app/agent-config --skill prompt-engineering-imageAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 7 stars7 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Translate an image brief into provider-specific prompt grammar per model. Use when writing or refining an image-generation prompt for Ideogram, Flux, Gemini, GPT Image 2, or Recraft.
SKILL.md
5.7 KB, as published. Nobody here has run it
prompt-engineering-image
Translate an image brief into a provider-specific prompt string. Each model has distinct prompt grammar — this skill applies the right structure per adapter.
When to use
- Writing or refining a prompt for any
pack-ai-imageprovider. - After
image-provider-routinghas selected the target provider. - When a prompt is underperforming and needs provider-specific tuning.
Per-provider prompt grammar
Ideogram (text-in-image: logos, banners, typographic art)
- Lead with the text literal in quotes:
"BAKERY NAME" in bold serif on a cream background. - Follow with visual context: background, color palette, style (flat, vintage, art-deco).
- Avoid long scene descriptions — Ideogram renders text best with a focused layout brief.
- Key params:
model: V_2,aspect_ratio: ASPECT_1_1(square logo) orASPECT_16_9(banner),magic_prompt_option: AUTO(let Ideogram enrich).
Flux (photoreal: product shots, portraits, scenes)
- Descriptive noun phrase first: subject → lighting → environment → camera.
- Example:
"Close-up product shot of a ceramic coffee mug, soft studio lighting, clean white background, 50 mm lens bokeh, ultra sharp". - Style descriptors: cinematic, hyperrealistic, 8K, golden hour, DSLR.
- Negative prompts accepted:
--no cartoon, illustration, text. - Routes through fal/Replicate — model slug:
fal-ai/flux-proorblack-forest-labs/flux-pro.
Recraft (vector / SVG logos and icons)
- Style param is mandatory:
style: vector_illustration(SVG output),style: icon(for simplified marks),style: realistic_image(raster fallback). - Keep prompt minimal — recraft interprets shape semantics:
"minimalist leaf icon, single color". - Avoid photographic language (lighting, bokeh, grain) — it has no effect on vector output.
- Key params:
model: recraftv3,response_format: url.
Gemini-image / GPT Image 2 (general art, edits, multimodal)
- Natural language works well — no special syntax required.
- Be explicit about style:
"watercolor illustration","flat design","oil painting". - For GPT Image 2 image editing: include the edit instruction after describing the target:
"Remove the background and replace with a solid pastel blue". - Gemini: submit via
generateContent(Nano Banana family) orimagen-4.0:predict(Imagen 4).
Procedure
- Receive the brief — extract: subject, style, output format (raster/vector/banner),
target provider (from
image-provider-routingor explicitly stated). - Structure the prompt blocks — subject · style · composition · technical params.
- Apply provider grammar from the section above for the target model.
- Tune for the job shape — text-literal first for Ideogram; noun-phrase first for Flux;
minimal +
style:param for Recraft; natural language for Gemini/GPT. - Inspect the adapter header — open
src/scripts/ai-image/adapters/<provider>.shand confirm the param enums (aspect/style/model) the prompt relies on still match. - Emit the prompt in the Output format below.
Output format
- Target provider — name + adapter file reference.
- Prompt string — the exact string to pass to the adapter, ready to copy.
- Key params — any model-specific fields (aspect ratio, style, negative prompts).
- Variant (optional) — one alternative phrasing when the brief is ambiguous.
Gotcha
- Per-provider param enums drift —
aspect_ratio,style, andmodelenum values are ASSUMED from the adapter header comments. Verify against live API docs before promotion; never hardcode these in production without a smoke trace. - Adapters are scaffold-tier — prompts authored here are not live-validated.
Actual rendering requires adapter promotion to
stableperprovider-lifecycle-discipline. - Recraft: photographic descriptors (
bokeh,lighting,grain) silently have no effect on vector output — strip them to avoid prompt budget waste.
Good example: Ideogram brief for a bakery logo — lead with the text literal:
'"Le Four" in warm serif, vintage French patisserie style, cream and terracotta'.
Bad example: Sending a photorealism-heavy Flux prompt to Recraft — the style descriptors will be ignored and the vector output will be wrong.
Do NOT
- Do NOT send photographic descriptors (
bokeh,lighting,grain) to Recraft — they have no effect on vector output and waste the prompt budget. - Do NOT hardcode ASSUMED param enums into a live run without a smoke trace — verify against the adapter header / provider docs first.
- Do NOT embed a real person's likeness, a trademarked brand mark, or a named living
artist's style in a prompt without the rights check (
image-likeness-and-rights). - Do NOT write a prompt before the provider is chosen — route via
image-provider-routingfirst.
See also
image-provider-routing— select the provider before writing the prompt.provider-lifecycle-discipline— lifecycle tier gates live runs.src/scripts/ai-image/adapters/— adapter header comments for param enums.image-likeness-and-rights— rights check before generating real-person likenesses or brand marks.