agntswrm/image-edit
skills/image-edit/SKILL.md
Edits an existing image using a text prompt. Use when you need to modify, enhance, or transform an image based on text instructions.
$ install --global
skillsauthnpx skillsauth add agntswrm/agent-media image-editInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 30, 2026, 8:30 PM56.1s1 file scanned
SKILL.md
- name:
- image-edit
- description:
- Edits an existing image using a text prompt. Use when you need to modify, enhance, or transform an image based on text instructions.
- compatibility:
- Requires Node.js 18+. Run via npx agent-media@latest or npm install -g agent-media.
Image Edit
Edits one or more images using a text prompt (image-to-image transformation). Supports multiple input images for combining styles, subjects, or scenes.
Command
npx agent-media@latest image edit --in <paths...> --prompt <text> [options]
Inputs
| Option | Required | Description |
|--------|----------|-------------|
| --in | Yes | One or more input file paths or URLs |
| --prompt | Yes | Text description of the desired edit |
| --aspect-ratio | No | Aspect ratio for output (e.g., 1:1, 16:9, auto) |
| --resolution | No | Output resolution (e.g., 1K, 2K, 4K) |
| --out | No | Output path, filename or directory (default: ./) |
| --provider | No | Provider to use (default: auto-detect) |
| --model | No | Model override (e.g., fal-ai/flux-2/edit) |
Output
Returns a JSON object with the edited image path:
{
"ok": true,
"media_type": "image",
"action": "edit",
"provider": "fal",
"output_path": "edited_123_abc.png",
"mime": "image/png",
"bytes": 567890
}
Examples
Edit a single image:
npx agent-media@latest image edit --in photo.jpg --prompt "make the sky more vibrant"
Add elements to an image:
npx agent-media@latest image edit --in portrait.png --prompt "add sunglasses"
Combine multiple images (pass multiple paths after --in, separated by spaces):
npx agent-media@latest image edit --in person.png landscape.jpg --prompt "place the person from the first image into the landscape from the second image"
Multi-image edit with aspect ratio and resolution:
npx agent-media@latest image edit --in template.png person.jpg --prompt "Use image one as the template and reframe the person from image two to match" --aspect-ratio 1:1 --resolution 2K --model fal-ai/nano-banana-pro/edit
Edit with specific provider:
npx agent-media@latest image edit --in scene.jpg --prompt "change to night time" --provider replicate
Providers
This action requires an external provider:
- fal - Requires
FAL_API_KEY - replicate - Requires
REPLICATE_API_TOKEN - runpod - Requires
RUNPOD_API_KEY - ai-gateway - Requires
AI_GATEWAY_API_KEY
The local provider does not support image editing.
Related Skills
agntswrm/video-generate
data-ai
VerifiedTrustedCommunity
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.
3SKILL.mdUpdated Mar 28, 2026
agntswrm/image-upscale
development
VerifiedTrustedCommunity
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.
3SKILL.mdUpdated Mar 28, 2026
agntswrm/image-resize
testing
VerifiedTrustedCommunity
Resizes an image to specified dimensions. Use when you need to change image size, create thumbnails, or prepare images for specific display requirements.
3SKILL.mdUpdated Mar 28, 2026
agntswrm/image-remove-background
content-media
VerifiedTrustedCommunity
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.
3SKILL.mdUpdated Mar 28, 2026