Image Processing

Outputs:

• One output file per invocation.
• Optional artifacts under out/image-processing/runs/<run_id>/:
  • 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: ask must-have questions first

   • Use: skills/workflows/conversation/ask-questions-if-underspecified/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