vectorize
/vectorize
Use when the user wants to trace a raster image (PNG/JPEG) into an SVG vector — useful for logos, line art, diagrams, and stylized illustrations. Wraps `vtracer` (Rust-backed, via Python wheel in the plugin venv). Companion to `svg-to-raster` (other direction).
- Author
- danielrosehill ↗
- Repository
- claude-image-production-plugin ↗
- Licence
- MIT
- Last repository change
- 24.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 24.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Use when the user wants to trace a raster image (PNG/JPEG) into an SVG vector — useful for logos, line art, diagrams, and stylized illustrations. Wraps `vtracer` (Rust-backed, via Python wheel in the plugin venv). Companion to `svg-to-raster` (other direction).
Original author description
Use when the user wants to trace a raster image (PNG/JPEG) into an SVG vector — useful for logos, line art, diagrams, and stylized illustrations. Wraps `vtracer` (Rust-backed, via Python wheel in the plugin venv). Companion to `svg-to-raster` (other direction).
How it works
- When to use
- Inputs
- Procedure
- Output
- Notes
SKILL.md preview
---
name: vectorize
description: Use when the user wants to trace a raster image (PNG/JPEG) into an SVG vector — useful for logos, line art, diagrams, and stylized illustrations. Wraps `vtracer` (Rust-backed, via Python wheel in the plugin venv). Companion to `svg-to-raster` (other direction).
---
# Vectorize
Convert raster images to SVG via [vtracer](https://github.com/visioncortex/vtracer). vtracer is a colour-clustering tracer — much better than `potrace` for full-colour images, comparable for B/W line art. Installed as a Python wheel in the plugin venv (bundled Rust binary, no `cargo` needed at install time).
## When to use
- Recover an editable vector logo from a raster (PNG/JPEG).
- Convert a flat illustration / icon / diagram into SVG for crisp scaling.
- Stylize a photo into a flat-colour vector (large `--filter-speckle` + low `--color-precision`).
- Pre-step before `svg-to-raster` if you want to upscale a small raster losslessly.
Do **not** use this skill when:
- Source is a complex photograph and you want photo-realism — vector tracing always loses gradients/texture; use `upscale-image` for raster upscaling instead.
- You need OCR'd text inside the SVG — vtracer traces strokes, not text. Use a separate OCR step.
- Input is already SVG — no-op.
## Inputs
1. **Input** — image file or directory. Required.
2. **Output dir** — default: `<input-dir>/svg/`. Never overwrites originals.
3. **Mode** — `color` (default, multi-colour with clustering) or `binary` (B/W line art, faster, smaller output).
4. **Color precision** — `1..8`, default `6`. Lower = fewer colours = smaller / more abstract SVG.
5. **Layer difference** — `0..255`, default `16`. Larger = fewer layers, simpler output.
6. **Filter speckle** — pixels, default `4`. Discards regions smaller than N pixels — raise to denoise.
7. **Path simplification** — `corner threshold` (default `60` deg), `length threshold` (default `4.0`), `splice threshold` (default `45` deg). Most users won't tune these; expose only if asked.
8. **Recursive** — `--recursive` for directory descent.
## Procedure
1. Resolve venv: `VENV_DIR="${CLAUDE_USER_DATA:-${XDG_DATA_HOME:-$HOME/.local/share}/claude-plugins}/image-production/venv"`.
2. Verify `vtracer` is importable:
```bash
"$VENV_DIR/bin/python" -c "import vtracer" 2>&1
```
If missing → point at `install-deps`.
3. Enumerate inputs (`*.png`, `*.jpg`, `*.jpeg`, `*.bmp`, `*.tiff`). Skip already-SVG with note.
4. For each file, call vtracer via Python:
```bash
"$VENV_DIR/bin/python" -c "
import vtracer, sys
vtracer.convert_image_to_svg_py(
sys.argv[1], # input
sys.argv[2], # output
colormode='<color|binary>',
color_precision=<int>,
layer_difference=<int>,
filter_speckle=<int>,
corner_threshold=<int>,
length_threshold=<float>,
splice_threshold=<int>,
path_precision=8,
)
" "<input>" "<output.svg>"
```
5. Track size deltas and a quick "vector quality" sniff: file size ratio (SVG / PNG), and visually-noticeable degradation flags (very large filter_speckle on a detailed source = likely loss).
## Output
- SVG files at `<output-dir>/`.
- Summary:
- Files processed / failed.
- Per-file: input pixels × → SVG path count (heuristic: `grep -c '<path' <file>`), file size delta.
- Tuning suggestions if path count is suspiciously high (likely too noisy — raise `filter_speckle`) or low (likely over-simplified — drop `layer_difference`).
## Notes
- vtracer is MIT — free to bundle and use.
- For B/W technical drawings / scanned line art, `binary` mode is dramatically faster and produces cleaner output than `color`.
- Common preset suggestions:
- **Logo / icon (clean source):** `color, color_precision=6, filter_speckle=4, layer_difference=16`. Defaults are tuned for this.
- **Photo → flat illustration:** `color, color_precision=3, filter_speckle=20, layer_difference=32`. Aggressive simplification, painterly look.
- **Line drawing / scan:** `binary, filter_speckle=10`. Smallest output.
- If vtracer's quality isn't enough for a specific case, fall back to Inkscape's bitmap trace or `potrace` (B/W only). vtracer is the right default for everything else.
- vtracer ships a CLI binary too (`vtracer-cli`) — the Python wheel is preferred here so the venv is self-contained.
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · danielrosehill/claude-image-production-plugin | 100 | MIT |
| poly-gents/syncolab-skills | 100 | Apache-2.0 |
Database snapshot: 13.11.2026 · package version 96dff8c02b8d (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
- 100svg-to-raster
Use when the user wants to rasterize SVG files — convert SVG to PNG, PDF, or PostScript at a chosen resolution. Wraps CairoSVG (Python, in the plugin venv). Single file or batch. Companion to `vectorize` (other direction). - 95lov-png2svg
Convert PNG images to high-quality SVG with optional white-background removal, vtracer spline vectorization, and svgo compression. Use when the user asks for "PNG to SVG", "png2svg", "转 SVG", "矢量化", "去白底", logo tracing, or converting raster icons into editable vector assets. - 100vectorize-logo
Vectorize a flat-colour raster logo (PNG/JPEG, often AI-generated) into exact SVG geometry and prove it against the source by rendering and diffing. Use to trace, redraw or reverse-engineer a logo, icon or mark as SVG; to make mono, inverted or app-tile variants of one; or to… - 100trace-image-to-svg
Traces a raster image, such as a logo, wordmark, icon or glyph art, into a pixel-faithful SVG of smooth Bezier paths with a transparent background, no embedded raster and no font dependency, scored against the source. Use when asked to trace, vectorize or convert an image to SVG… - 100image-to-svg
Convert raster images (photos, paintings, illustrations, line art) into SVG vector reproductions. Use when the user uploads an image and asks to reproduce, vectorize, trace, or convert it to SVG. Also use when asked to decompose an image into shapes, create an SVG version of a… - 95generate-svg
Generate true SVG vector graphics from a text prompt (Recraft V4.1) or convert an existing raster image to SVG (Recraft vectorize) via fal.ai — logos, icons, flat illustrations, brand marks, favicons, spot art that must stay sharp at any size. Use whenever the user asks for an…