diff --git a/README.md b/README.md
index 8626ab6..432ec9d 100644
--- a/README.md
+++ b/README.md
@@ -116,6 +116,9 @@ svgsmith convert input.png \
| `--smooth` / `--no-smooth` | on | Curve-refit color contours into smooth, sparse Béziers (Schneider least-squares). |
| `--detail {high,normal,clean,poster}` | `normal` | Color detail dial. `high` = maximum detail; `clean` = edge-preserving cleanup (less noise/grain); `poster` = bold flat graphic with few colors. |
| `--solid-background` | off | Isolate the subject and repaint the background as one clean solid color — removes texture/grain/specks while keeping subject detail. |
+| `--background COLOR` | off | Like `--solid-background`, but repaint the detected background to a **specific** color (`#RRGGBB` or named, e.g. `white`). `auto` = the detected median. |
+| `--transparent-background` | off | **Remove** the background instead of repainting it — the edge-connected background is cut, leaving a **transparent** SVG. The subject is kept even where it shares the background color (color mode). |
+| `--flatten-shading` | off | Collapse soft/glossy shading before tracing (color mode) so smooth gradients (e.g. satin sheen) become clean flat regions instead of shattering into tiny "scratch" facets — a cleaner graphic look and smaller file. |
| `--uniform-outline` | off | Force an even-width outline band (outlined illustrations only; would add a wrong border on line art). |
| `--out PATH` | `.svg` | Output SVG path. |
| `--report {off,json}` | `off` | Print a JSON report to stdout (the only thing on stdout). |
@@ -134,8 +137,11 @@ language, and the agent translates that into flags. The flags **compose** — pi
| "keep every detail / texture / shading" | `--detail high` |
| "make it cleaner / tidier", "less noise" | `--detail clean` |
| "poster / flat / bold graphic", "minimalist" | `--detail poster` |
-| "put it on a clean / solid background", "remove the background", "just the subject" | `--solid-background` |
+| "put it on a clean / solid background", "just the subject on a flat background" | `--solid-background` |
+| "make the background white / ``", "change / swap the background color" | `--background white` |
+| "cut it out", "transparent background", "remove the background entirely", "just the subject, no background" | `--transparent-background` |
| "detailed character on a plain background" | `--detail high --solid-background` |
+| "it looks scratchy / shattered / broken", "glossy or shiny art isn't clean", "flatten the shading" | `--flatten-shading` |
| "even / consistent outline" (art that already has a dark outline) | `--uniform-outline` |
| "keep the rough / hand-drawn look", "don't smooth" | `--no-smooth` |
| "give it back as a PNG", "render / preview it" | `svgsmith rasterize out.svg` |
diff --git a/skills/vectorize/SKILL.md b/skills/vectorize/SKILL.md
index 1832498..0c341df 100644
--- a/skills/vectorize/SKILL.md
+++ b/skills/vectorize/SKILL.md
@@ -31,9 +31,12 @@ Then add **refinement flags** based on what the user wants out of it (these comp
| User wants | Add flag |
|---|---|
| "clean / flat / solid background", "remove the background texture", "just the subject on a plain color", "isolate the cat/logo/person" | `--solid-background` |
+| "make the background white / ``", "change / swap the background color" | `--background white` |
+| "cut it out", "transparent background", "remove the background entirely", "just the subject, no background" | `--transparent-background` |
| "maximum detail", "keep every detail / texture / shading" | `--detail high` |
| "cleaner / tidier", "less noise / grain", "smooth it out a bit" | `--detail clean` |
| "poster / flat / bold graphic", "simple flat colors", "minimalist" | `--detail poster` |
+| "it looks scratchy / shattered / broken", "glossy or shiny art isn't clean", "flatten the shading" | `--flatten-shading` |
| "even / consistent outline", "uniform line weight" (only for art that already has a dark outline) | `--uniform-outline` |
| "keep the raw / rough / hand-drawn look", "don't smooth it" | `--no-smooth` |
diff --git a/src/svgsmith/__init__.py b/src/svgsmith/__init__.py
index d92c456..937afe0 100644
--- a/src/svgsmith/__init__.py
+++ b/src/svgsmith/__init__.py
@@ -1,3 +1,3 @@
"""svgsmith — convert raster images into clean, editable SVG."""
-__version__ = "0.1.0"
+__version__ = "0.2.0"