# Image Processing

> Validate SVG inputs and convert svg/png/jpg/jpeg/webp inputs to png/webp/jpg

- **Type:** Skill
- **Install:** `agentstack add skill-graysurf-agent-kit-image-processing`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [graysurf](https://agentstack.voostack.com/s/graysurf)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [graysurf](https://github.com/graysurf)
- **Source:** https://github.com/graysurf/agent-kit/tree/main/skills/tools/media/image-processing

## Install

```sh
agentstack add skill-graysurf-agent-kit-image-processing
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Image Processing

Translate a user’s natural-language request into a safe invocation of the `image-processing` CLI.

## Contract

Prereqs:

- Run inside a git work tree (recommended; enables stable `out/` paths).
- `image-processing` available on `PATH` (install via `brew install nils-cli`).
- No external image binaries required for standard use.

Inputs:

- Natural-language user intent (assistant translates into a command).
- Exactly one operation:
  - `convert`: `--in ` + `--to png|webp|jpg` + `--out `; accepts `svg|png|jpg|jpeg|webp` inputs
  - `svg-validate`: exactly one `--in ` + `--out `
- Optional sizing for raster convert output: `--width` / `--height`.
- Optional output controls: `--overwrite`, `--dry-run`, `--json`, `--report`.

Outputs:

- One requested output file per successful non-dry-run invocation.
- Optional artifacts under `out/image-processing/runs//`:
  - `summary.json` (when `--json` or `--report` is used)
  - `report.md` (when `--report` is used)
- Assistant response (outside the script) must include:
  - Output file/folder paths as clickable markdown file links
  - A suggested “next time” prompt to repeat the same task

Exit codes:

- `0`: success
- `1`: failure
- `2`: usage error

Failure modes:

- Missing required tool (`image-processing` binary).
- Invalid or ambiguous flags (missing required params, unsupported combinations).
- Output already exists without `--overwrite`.
- Invalid convert contract:
  - missing `--in` / `--to` / `--out`
  - repeated `--in`
  - `--out` extension mismatch vs `--to` (`.jpeg` is valid for `--to jpg`)
  - unsupported target format
  - unsupported input format
  - invalid `--width` / `--height` values
- Invalid `svg-validate` contract:
  - missing or repeated `--in`
  - missing `--out`
  - convert-only flags like `--to`/`--width`/`--height`

## Guidance

### Preferences (optional; honor when provided)

- Operation: `convert` or `svg-validate`.
- Target format (for `convert`): `png` / `webp` / `jpg`.
- Raster sizing (for `convert`): `--width`, `--height`.
- Reproducibility/audit flags: `--dry-run`, `--json`, `--report`, `--overwrite`.
- Output extension detail (for `--to jpg`): `.jpg` or `.jpeg`.
- JPG background behavior: transparent pixels are flattened onto white.

### Policies (must-follow per request)

1. If underspecified enough to block a valid `image-processing` command: ask must-have questions first
   - Follow the blocking-question format in `skills/workflows/conversation/requirements-gap-scan/SKILL.md`.
   - Ask 1-5 "Need to know" questions with explicit defaults.
   - Do not run commands until the user answers or explicitly approves assumptions.

2. Single entrypoint (do not bypass)
   - Only run: `image-processing` (from `PATH`; install via `brew install nils-cli`)
   - Do not call ImageMagick binaries directly unless debugging the `image-processing` CLI itself.

3. Contract gate (exactly one operation path)
   - `convert`: require exactly one `--in`, plus `--to` and `--out`.
   - `convert`: accept `svg|png|jpg|jpeg|webp` inputs; require `--out` extension to match `--to` (`.jpeg` allowed for `--to jpg`).
   - `svg-validate`: require exactly one `--in` and `--out`; forbid `--to`/`--width`/`--height`.

4. Completion response (fixed)
   - After a successful run, respond using:
     - `skills/tools/media/image-processing/references/ASSISTANT_RESPONSE_TEMPLATE.md`
   - Include clickable markdown file links and a one-sentence “next prompt” that repeats the same task with concrete paths/options.

## References

- `skills/tools/media/image-processing/references/IMAGE_PROCESSING_GUIDE.md`
- `skills/tools/media/image-processing/references/ASSISTANT_RESPONSE_TEMPLATE.md`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [graysurf](https://github.com/graysurf)
- **Source:** [graysurf/agent-kit](https://github.com/graysurf/agent-kit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-graysurf-agent-kit-image-processing
- Seller: https://agentstack.voostack.com/s/graysurf
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.