Skip to content
Skills Library
Design & UX · Building & coding

pro-image

/pro-image

Make image assets (backgrounds, characters, icons, illustrations, items) that fit the project's own style: you write the prompt from a per-repo harness, Codex or Antigravity draws it, the CLI fixes size and transparency. Use for 'make an image', 'draw', 'generate an icon'.

Repository
projectops ↗
Licence
MIT
Last repository change
13.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
30
Scripts
19
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 19 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/image_cli.py, scripts/pro_image/__init__.py, scripts/pro_image/background.py, scripts/pro_image/board.py, scripts/pro_image/codex_runner.py, scripts/pro_image/commands.py, scripts/pro_image/converter.py, scripts/pro_image/generation.py, scripts/pro_image/harness.py, scripts/pro_image/history.py, scripts/pro_image/image_facts.py, scripts/pro_image/png_codec.py, scripts/pro_image/postprocess

What it does and when to use it

Make image assets (backgrounds, characters, icons, illustrations, items) that fit the project's own style: you write the prompt from a per-repo harness, Codex or Antigravity draws it, the CLI fixes size and transparency. Use for 'make an image', 'draw', 'generate an icon'.

Triggers from the description

make an imagedrawgenerate an icon
Original author description

Make image assets (backgrounds, characters, icons, illustrations, items) that fit the project's own style: you write the prompt from a per-repo harness, Codex or Antigravity draws it, the CLI fixes size and transparency. Use for 'make an image', 'draw', 'generate an icon'.

How it works

  1. When to use
  2. What the user sees
  3. Goal → command
  4. Quick path
  5. Flow
  6. Codes
  7. Shared references
  8. Customize
  9. Never
Original SKILL.md headings · 114 lines, 1,243 words
SKILL.md preview
---
name: pro-image
description: "Make image assets (backgrounds, characters, icons, illustrations, items) that fit the project's own style: you write the prompt from a per-repo harness, Codex or Antigravity draws it, the CLI fixes size and transparency. Use for 'make an image', 'draw', 'generate an icon'."
---

# Image: assets that look like this project

## When to use

- "Make a background / character / icon / illustration / item for this screen", "draw it", "regenerate the art",
  "several expressions of this character", in any language
- "What style fits this project?", "show me a few styles"
- Use it on your own whenever a task needs a new raster image (an empty state, a store graphic, a game scene).
  Do not draw such images with SVG or code unless every provider failed.

| Situation | Skill |
|---|---|
| A new image asset | **this one** |
| Screen layout mockups to compare in the browser | `pro-ui-design` (it can place images made here) |
| Moving a Figma design into code | `pro-figma` |

Talk to the user in their language. Apply the absolute rules in `../references/common-rules.md`.

**You write the brief and the prompt and judge every result. The CLI only runs the image tool, collects the file,
fixes format, size and transparency, and records history.**

## What the user sees

The user should see a short line while it works ("making 2 background candidates, about 3 minutes") and then the
finished image. Do not narrate background removal, resizing, retries or prompt edits; do not show raw or failed
images. If something cannot be met (a tool is missing, the same requirement failed twice), say it in one line
with the best result.

## Goal → command

Every command is `PYTHONIOENCODING=utf-8 python3 ~/.projectops/bin/projectops_cli.py image <command>`
(Windows: `python`). Output is always JSON with `ok`, `code`, `summary`, `next`.

| Goal | Command | Details |
|---|---|---|
| Which tools are ready, in what order | `providers` | `references/providers.md` |
| This repo's art memory (style, characters, references) | `harness [--init] [--character <id> ...]` | `references/harness.md` |
| The guide for a kind of image + its approved prompts | `kind <background\|character-sheet\|sprite\|icon\|illustration\|item\|...>` | `references/kinds/` |
| Generate one image, finished to spec | `run --name <stem> --prompt <file> --size WxH [--alpha] [--ref <img> ...] [--provider <name>] [--kind <kind>]` | below |
| Several candidates side by side, numbered | `board <img> ... --out <png>` | `references/style-explore.md` |
| Remove a background from any image | `remove-bg <img> --out <png> [--key-color "#00FF00"] [--mode flood\|global]` | |
| Fit an image to a size | `fit <img> --out <png> --size WxH [--mode cover\|contain]` | |
| Check size and transparency | `check <img> [--size WxH] [--alpha]` | |
| Record the user's decision · read past ones | `record --name <stem> --status approved\|rejected [--placed-at <path>] [--note "..."]` · `history` | |

## Quick path

A one-off picture ("just make me a cat image", a throwaway test, no app placement): skip the harness and style
explore. Write a short English prompt with size and background, `run`, Read the result, show it. Ask nothing unless
the size or the background is truly unknown. Use the full flow below when the image goes into an app.

## Flow

1. **Tools.** `providers`. On `ask_priority`, ask the user once which ready tools to use and in what order, and save
   `image.priority` (`references/providers.md`). Default order: codex > antigravity > claude-vector.
2. **Harness.** `harness`. On `no_style`: if the app already has art, `--init` and fill `STYLE.md` from it; if not,
   or the user wants to see options, run the style explore (`references/style-explore.md`) and let them pick.
3. **Brief.** Read the screen that will use the image, then write the numbered brief: purpose and placement, final
   size, background (opaque or `--alpha`), style anchor, subject, composition and empty zones, light, consistency
   anchors, must-nots (`references/prompting.md` §1). Ask the user only what the code cannot tell you.
4. **Prompt.** `kind <kind>`, then write the prompt in English in the order of `references/prompting.md` §2, reusing
   what worked in `approved_examples`. Save it to a file in your scratch folder.
5. **Run.** `run ...` in the background (each run takes 1-5 minutes; run several one after another, not at once).
   The CLI appends the output rules, converts to PNG, removes a fake or keyed background, fits the size and checks it.
6. **Judge.** Open `image.path` (the `.final.png`) with Read and check every brief line. `problems` lists spec
   failures. A transparent image can look like it has a dark glow when read directly; judge it on
   `board <img> --out <png>` (gray backdrop) instead. Retry a failed content line once with that line stronger; on provider failures follow `next`.
7. **Show.** Show only the finished image (or one `board` for several). Ask for approval with your agent's choice prompt (AskUserQuestion in Claude Code; a numbered list elsewhere) when
   there is a choice. If a `pro-ui-design` session is open, place the candidates there instead.
8. **Place and remember.** Convert to the app's format and put it where the brief said; `record --status approved
   --placed-at <path>`. Turn any lasting feedback into a line in `STYLE.md` or `characters/<id>.md`.

## Codes

| `code` | Meaning | Do |
|---|---|---|
| `ok` | Finished and matches size and transparency | Judge the content yourself |
| `spec_mismatch` | Finished but `problems` lists a size or alpha miss | Fix with `fit` / `remove-bg`, or run again |
| `ask_priority` | No saved tool order | Ask once, save `image.priority` |
| `no_style` | No `STYLE.md` in this repo | Fill it or run the style explore |
| `not_subscription` | Codex is signed in with an API key | Ask the user to `codex login` with ChatGPT, or use the next tool |
| `provider_missing` · `image_unavailable` · `timeout` · `no_image` | The tool could not deliver | Next provider in priority (`references/providers.md`) |
| `quota_exhausted` | The tool's image quota is used up (`quota.reset_in`) | Follow `next`: short wait → retry once, long → next provider now, and tell the user when it resets |
| `agent_draws` | The chosen provider is claude-vector | Draw SVG yourself, render it, `check` |
| `postprocess_failed` | Conversion or resizing failed | `raw_image` is kept; install Pillow (`pip install pillow`) or ImageMagick |

## Shared references

| Document | Read when |
|---|---|
| `../references/common-rules.md` | Always, at start: absolute rules, confirmation gates, issue state, push |
| `../references/agent-conduct.md` | When a tool is missing or you are about to say it cannot be done |
| `../references/config-rules.md` | When reading or writing `~/.projectops/config/config.json` |

## Customize

Your own language, tone and rules apply: see `../references/preferences.md`. Read them once at the start with `SKILL_ID=pro-image`.
Keys for this skill: the common `language`, `tone`, `rules` only. Behavior is under `config` (`image` section: priority, providers,
harness_dir, require_subscription); project art memory is the repo harness (`references/harness.md`).
Preferences change presentation only; approval gates and secret protection stay in force.

## Never

- Never use an API-key login for Codex unless the user set `image.require_subscription: false`.
- Never commit candidates. They stay in `~/.projectops/image/<owner__repo>/runs/`; only the approved, converted
  file goes into the app, and only small approved references go into `docs/image-harness/refs/`.
- Never put text, logos or brand marks of real companies into generated images.
- Never use art the project does not own as a reference (another game's characters, a stock photo). References
  shape the output; use the app's own approved art.
- Generated images follow the drawing tool's terms (OpenAI for Codex, Google for Antigravity). When the asset is for
  a commercial release, tell the user once which tool made it so they can check those terms.
- Never replace an approved asset without showing the new one first.
Files in this package (30)
  • SKILL.md 8 KB
  • references/harness.md 2 KB
  • references/prompting.md 5 KB
  • references/providers.md 4 KB
  • references/style-explore.md 2 KB
  • references/kinds/background.md 1 KB
  • references/kinds/character-sheet.md 1 KB
  • references/kinds/icon.md 1 KB
  • references/kinds/illustration.md 1 KB
  • references/kinds/item.md 1 KB
  • references/kinds/sprite.md 2 KB
  • scripts/image_cli.py 6 KB
  • scripts/pro_image/__init__.py 1 KB
  • scripts/pro_image/background.py 8 KB
  • scripts/pro_image/board.py 4 KB
  • scripts/pro_image/codex_runner.py 3 KB
  • scripts/pro_image/commands.py 9 KB
  • scripts/pro_image/converter.py 4 KB
  • scripts/pro_image/generation.py 11 KB
  • scripts/pro_image/harness.py 4 KB
  • scripts/pro_image/history.py 1 KB
  • scripts/pro_image/image_facts.py 4 KB
  • scripts/pro_image/png_codec.py 4 KB
  • scripts/pro_image/postprocess.py 4 KB
  • scripts/pro_image/provider_runner.py 3 KB
  • scripts/pro_image/providers.py 5 KB
  • scripts/pro_image/quota.py 2 KB
  • scripts/pro_image/resample.py 4 KB
  • scripts/pro_image/settings.py 3 KB
  • scripts/pro_image/svg_render.py 3 KB

Versions

The database has no other skills named pro-image.

Database snapshot: 13.11.2026 · package version e052a5ceb602 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100assets
    Make images for a Godot game with an image model (UI parts, characters, backgrounds, icons, key art) and add sound effects and music with their sources recorded. Use for "make an image", "make an icon", "I need a background", "generate sprites", "add sound effects", "find…
  • 84asset-set
    Generate a complete, style-consistent set of image assets for a web or app project in one pass — favicons, app icons, OG/social cards, hero images, empty-state illustrations, or a matching icon family. Use when the user asks for "icons for", "assets for", "favicon", "og image",…
  • 100codex-imagegen
    Generates images and polished raster art (logos, mascots, hero images, icons, characters, sprite sheets, illustrations, product mockups) by driving Codex CLI's $imagegen skill. This is the default image generator, use it for any request to generate or create an image or visual…
  • 100gemini-imagegen
    Use when the user asks to generate, create, draw, edit, or restyle an image, or when a task needs image assets — logos, icons, illustrations, hero images, textures, photos, placeholder art, social/OG cards. Claude cannot produce raster images; a Gemini session via the agy…
  • 84generate-image
    Generate images (icons, logos, banners, illustrations, mockups, photos, textures, diagrams-as-art) with OpenAI gpt-image-2 through the locally installed Codex CLI, using the user's existing ChatGPT login — no API key. Use whenever the user asks to generate, create, draw, or mock…
  • 100transparent-icons
    Use this skill when the user asks to "make an icon", "generate an icon", "create a scientific icon", "make a transparent icon", "make a minimal icon", "icon for a figure", "icon for a paper", "generate an icon set", "batch icons", or wants flat scientific icons (brain, neuron,…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.