godot-fungodot-fun/godot-agent/.agents/skills/image-remove-white-background/SKILL.md

image-remove-white-background

Skill202 starsChanged 14 days agoMITView on GitHub

Removes solid-color backgrounds (white, green #00FF00, magenta #FF00FF) from a single AI-generated image using color key and border flood fill — not AI matting. Use when rembg over-removes foreground, for flat white/green/magenta backgrounds, color key cutout, white-background cutout, green screen, or chroma key before Godot sprite import.

Installs packages

1 other project uses a version of this.

Adopted by

Most recently taken up by

godot-fun/gaiword for word, first seen Nov 1, 2026

Other versions1 project uses a version of this.
Word for word · 1
godot-fun/gai★ 202100% same
Edited · 0
None found.
Wrote their own version · 0
None found.
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository37 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .agents/skills/AGENTS.mdAGENTS.md
- ai-text-to-speechSkill
- audio-denoiseSkill
- audio-fadeSkill
- audio-loudness-normalizationSkill
- audio-sample-rate-standardizeSkill
- audio-splitSkill
- audio-to-oggSkill
- audio-to-textSkill
- audio-to-wavSkill
- audio-trimSkill
- audio-volume-adjustSkill
- file-naming-normalizationSkill
- git-commit-messageSkill
- image-inpaint-regionSkill
- image-region-remove-key-color-appSkill
- image-remove-backgroundSkill
- image-resizeSkill
- image-sprite-sheet-splitSkill
- image-to-pngSkill
- image-to-textSkill
- image-trimSkill
- storyboard-av-mixSkill
- storyboard-shot-to-htmlSkill
- storyboardSkill
- storyboard-ttsSkill
- video-4k-normalizationSkill
- video-compress-to-sizeSkill
- video-merge-gpuSkill
- video-mergeSkill
- video-publishSkill
- video-remove-audioSkill
- video-to-4kSkill
- video-to-60fpsSkill
- video-to-ogvSkill
- video-to-wavSkill

The file

We split this skill into the rules it gives an agent

6 rules. About 0 are common, 1 is distinctive, and 5 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Distinctive:
Remove flat solid-color backgrounds with color key + flood fill.
line 12
Very specific:
When this skill applies, read and follow dependency-manager — run scripts as documented, install missing tools into .dependency/.
line 20
Very specific:
Run remove_white_bg.py through the image-remove-white-background manifest entry (.dependency/image-remove-white-background/.venv/).
line 22
Very specific:
Do not hand-write FFmpeg colorkey / ImageMagick commands — use the bundled script.
line 23
Very specific:
Use bin/python on Unix.
line 46
Very specific:
Both --image is required: Default output: <image-dir>/image-remove-white-background/<image-name>.png
line 50

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

Image Remove White / Chroma Background

Remove flat solid-color backgrounds with color key + flood fill. Output is RGBA PNG with transparency — ready for Godot sprites and UI.

Unlike image-remove-background (rembg AI matting), this skill only removes pixels that match the key color. It does not guess what is "subject" vs "background", so white clothing, props, and effects are preserved unless they touch the outer background through matching pixels.

Single file only. Pass one image with --image; directories are not supported.

Rules

When this skill applies, read and follow dependency-manager — run scripts as documented, install missing tools into .dependency/.

Run remove_white_bg.py through the image-remove-white-background manifest entry (.dependency/image-remove-white-background/.venv/). Never use host python, py, python3, or any interpreter outside .dependency/.
Do not hand-write FFmpeg colorkey / ImageMagick commands — use the bundled script.
Single file only. Pass one image with --image; directories are not supported.
populated: false for image-remove-white-background is not a reason to skip. Install first, set populated: true, retry the same command.
Pass the input path as-is (chat attachment path, Downloads/foo.png, project folder, etc.). Output goes to <image-dir>/image-remove-white-background/ by default — no path rewriting; never overwrite sources.

Setup (first run)

From project root:

.dependency/python/python -m venv .dependency/image-remove-white-background/.venv
.dependency/image-remove-white-background/.venv/Scripts/python.exe -m pip install Pillow

"image-remove-white-background": {
  "populated": true,
  "bin": ".dependency/image-remove-white-background/.venv/Scripts/python.exe"
}

Use bin/python on Unix.

Quick Start

Both --image is required. Default output: <image-dir>/image-remove-white-background/<image-name>.png

# White AI background (default preset)
.dependency/image-remove-white-background/.venv/Scripts/python.exe .ai/image-remove-white-background/remove_white_bg.py --image image/sprites/hero.png

# Green screen (#00FF00) — recommended for future AI generation
.dependency/image-remove-white-background/.venv/Scripts/python.exe .ai/image-remove-white-background/remove_white_bg.py --image image/sprites/hero.png --preset green

# Magenta screen (#FF00FF)
.dependency/image-remove-white-background/.venv/Scripts/python.exe .ai/image-remove-white-background/remove_white_bg.py --image image/sprites/hero.png --preset magenta

Custom output path:

.dependency/image-remove-white-background/.venv/Scripts/python.exe .ai/image-remove-white-background/remove_white_bg.py --image image/sprites/hero.png -o image/sprites_cutout/

Presets

Preset	Key color	Default tolerance	Best for
`white` (default)	`#FFFFFF`	25	AI images with pure/near-white backgrounds
`green`	`#00FF00`	40	Green-screen AI prompts (recommended)
`magenta`	`#FF00FF`	40	Magenta-screen AI prompts

Custom key color:

.dependency/image-remove-white-background/.venv/Scripts/python.exe .ai/image-remove-white-background/remove_white_bg.py --image image/foo.png --color F0F0F0 --tolerance 20

Modes

Mode	Behavior
`global` (default)	Removes all pixels matching the key color. Best when the subject has no same-color interior details to preserve.
`both`	Union of `border` and `center` — removes background connected to edges or to the center.
`border`	Flood fill from image edges only — keeps isolated white areas not reachable from edges or center (e.g. white shirt interior).
`center`	Flood fill from the image center outward — removes key-color regions reachable from the middle.

# Center-out flood (interior white holes)
.dependency/image-remove-white-background/.venv/Scripts/python.exe .ai/image-remove-white-background/remove_white_bg.py --image image/foo.png --mode center

# Edge + center without removing every white pixel
.dependency/image-remove-white-background/.venv/Scripts/python.exe .ai/image-remove-white-background/remove_white_bg.py --image image/foo.png --mode both

Defaults

Option	Default	Notes
`--image`	Required	Single supported image file
Output	`<image-dir>/image-remove-white-background/<name>.png`	Use `-o` / `--output` for custom file or directory
`--preset`	`white`	`green` / `magenta` for chroma-screen AI art
`--mode`	`global`	Use `border` or `both` when same-color interior details must be preserved
`--tolerance`	preset-specific	Raise if background remnants remain; lower if foreground edges erode
`--feather`	2	Gaussian soft edge on alpha; `0` for hard edges
`--crop`	off	Trim transparent borders after keying

Supported inputs: .png, .jpg, .jpeg, .webp, .bmp, .gif, .tif, .tiff, .avif, .ico.

Agent Workflow

Pick skill — flat solid background → this skill; complex/photo backgrounds → image-remove-background.
Paths — Pass whatever path the user gives or the chat <image_files> path directly with --image. Output lands in image-remove-white-background/ next to that input.
One file per run — process one image, verify the result, then repeat for additional files if needed.
Preset — white for existing white-bg AI art; tell user to switch AI prompts to --preset green or --preset magenta going forward.
Tolerance — if halos remain, increase --tolerance by 5–10; if subject edges eat away, decrease it.
Revert — delete output file or git restore; sources are never modified.

Troubleshooting

Issue	Fix
`image-remove-white-background` missing	Follow Setup; update manifest
Missing `--image`	Both `--image` and a file path are required
Directory passed to `--image`	Run once per file; this skill accepts image files only
Output already exists	Delete the existing output or choose a different `-o` path
Background remnants (gray fringe)	Increase `--tolerance`; try `--feather 3`
Subject edges eroded	Decrease `--tolerance`; ensure `--mode border`
White clothing removed	Switch to `--mode border` or `--mode both`; avoid `global` for characters with white details
Green spill on subject edges	Lower `--tolerance`; increase `--feather` slightly
Interior holes stay opaque	Try `--mode center` if the hole matches the key color at the image center; try `--mode both` for edge + center; otherwise `--mode global` only if safe, or fix in an editor
Center mode does nothing	Center pixel is not key color (subject sits in the middle) — use `border`, `both`, or split sprite sheets per frame
Wrong colors in JPEG	Prefer PNG from AI export; raise tolerance slightly for compression artifacts
Wrong interpreter	Must use `.dependency/image-remove-white-background/.venv/Scripts/python.exe`

CLI

Copy-paste commands: cli/image-remove-white-background.md

AI matting (complex backgrounds): image-remove-background
Enclosed white islands after edge keying: image-region-remove-key-color-app

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free