skills/image-upscale/SKILL.md
Upscales an image using AI super-resolution to increase resolution with detail generation. Use when you need to enlarge images, improve low-resolution photos, or prepare images for large-format display.
npx skillsauth add agntswrm/agent-media image-upscaleInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Upscales an image using AI super-resolution models, increasing resolution while generating realistic detail.
npx agent-media@latest image upscale --in <path> [options]
| Option | Required | Description |
|--------|----------|-------------|
| --in | Yes | Input file path or URL |
| --scale | No | Scale factor (2 or 4, default: 2) |
| --out | No | Output path, filename or directory (default: ./) |
| --provider | No | Provider to use (local, fal, replicate) |
| --model | No | Model to use (overrides provider default) |
Returns a JSON object with the upscaled image path:
{
"ok": true,
"media_type": "image",
"action": "upscale",
"provider": "local",
"output_path": "upscaled_123_abc.png",
"mime": "image/png",
"bytes": 456789
}
Upscale an image (default 2x):
npx agent-media@latest image upscale --in photo.jpg
Upscale 4x with specific provider:
npx agent-media@latest image upscale --in photo.jpg --scale 4 --provider fal
Upscale with custom output:
npx agent-media@latest image upscale --in photo.jpg --out ./upscaled
Runs locally on CPU using Transformers.js, no API key required.
Xenova/swin2SR-compressed-sr-x4-48 model (~1.3MB)--scale (model architecture limitation)mutex lock failed error — ignore it, the output is correct if "ok": truenpx agent-media@latest image upscale --in photo.jpg --provider local
FAL_API_KEYfal-ai/esrgan (Real-ESRGAN) modelREPLICATE_API_TOKENnightmareai/real-esrgan modeldata-ai
Generates video from text prompts or animates static images. Use when you need to create videos from descriptions, animate images, or produce video content using AI.
testing
Resizes an image to specified dimensions. Use when you need to change image size, create thumbnails, or prepare images for specific display requirements.
content-media
Removes the background from an image, leaving the foreground subject with transparency. Use when you need to isolate subjects, create cutouts, or prepare images for compositing.
data-ai
Generates an image from a text prompt using AI models. Use when you need to create images from descriptions, generate artwork, or produce visual content from text.