image-crop

Crops an image to specified dimensions around a focal point. Use when you need to extract a portion of an image, create thumbnails with custom positioning, or prepare images for specific aspect ratios.

agntswrm 6 2 Updated 4d ago

GitHub

Install

npx skillscat add agntswrm/agent-media/image-crop

Install via the SkillsCat registry.

About this skill

The image-crop skill crops an image to specified pixel dimensions, with an optional configurable focal point to control which region is kept when the aspect ratio doesn't match. It solves the problem of extracting a subregion of an image or fitting images into custom aspect ratios for thumbnails or other uses. Use it when an agent needs to programmatically crop local or remote images via the command line.

SKILL.md

Image Crop

Crops an image to specified dimensions centered on a configurable focal point. The crop region is calculated to center on the focal point while staying within image bounds.

Command

agent-media image crop --in <path> --width <px> --height <px> [options]

Inputs

Option	Required	Description
`--in`	Yes	Input file path or URL
`--width`	Yes	Width of crop area in pixels
`--height`	Yes	Height of crop area in pixels
`--focus-x`	No	Focal point X position 0-100 (default: 50 = center)
`--focus-y`	No	Focal point Y position 0-100 (default: 50 = center)
`--dpi`	No	DPI/density for output (default: 300)
`--out`	No	Output path, filename or directory (default: ./)
`--provider`	No	Provider to use (default: local)

Output

Returns a JSON object with the cropped image path:

{
  "ok": true,
  "media_type": "image",
  "action": "crop",
  "provider": "local",
  "output_path": "cropped_123_abc.png",
  "mime": "image/png",
  "bytes": 45678
}

Examples

Crop to 800x600 centered (default focal point):

agent-media image crop --in photo.jpg --width 800 --height 600

Crop with focal point at top-left area (20% from left, 30% from top):

agent-media image crop --in photo.jpg --width 800 --height 600 --focus-x 20 --focus-y 30

Crop from URL with custom output:

agent-media image crop --in https://example.com/image.jpg --width 1024 --height 768 --out ./output

Providers

local (default) - Uses Sharp library, no API key required