Upscale Image
Run Pilio super-resolution on local images from the terminal without hand-rolling upload and task polling.
Overview
Upscale Image is an agent skill for the Build phase that runs Pilio AI super-resolution on a local image through the official CLI and async task API.
Install
npx skills add https://github.com/pilioai/skills --skill upscale-imageWhat is this skill?
- Official Pilio CLI via pnpm dlx @pilio/cli upscale-image
- Async task flow with task wait polling until processing completes
- --input flag for local PNG or image path workflow
- Requires PILIO_API_KEY in environment—no keys pasted in chat
- Links to pilio.ai/image-upscaler for parity with the hosted UI
- Async task flow with dedicated task wait command
Adoption & trust: 7.4k installs on skills.sh; 41 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You have low-resolution or blurry images but no scripted way to upscale them with Pilio while keeping API keys out of the chat.
Who is it for?
Solo builders automating hero images, thumbnails, or catalog photos through Pilio with pnpm and an API key in env.
Skip if: Workflows that need local-only processing, batch governance without a Pilio account, or editing unrelated to resolution.
When should I use this skill?
User wants higher-resolution images, AI super-resolution, image clarity improvement, or automated image enhancement through Pilio.
What do I get? / Deliverables
You get a completed Pilio upscale task and downloadable higher-resolution output after CLI upload and task wait polling.
- Pilio task payload
- Upscaled image available via Pilio task result
Recommended Skills
Journey fit
Canonical shelf is Build → frontend because upscaling produces higher-resolution visual assets for sites, stores, and marketing surfaces. Image clarity and resolution work happens while preparing UI imagery, thumbnails, and hero assets—not after deploy monitoring.
How it compares
Skill package for Pilio’s hosted upscale API—not a self-hosted open-source upscaler or an MCP media server.
Common Questions / FAQ
Who is upscale-image for?
Upscale Image is for solo builders and small teams who use agent-driven terminals and want Pilio super-resolution without building custom HTTP clients.
When should I use upscale-image?
Use when the user wants higher-resolution images, AI super-resolution, image clarity improvement, or automated enhancement through Pilio—typically while preparing Build-phase marketing or UI assets.
Is upscale-image safe to install?
The skill uses a server-side API key and outbound calls to Pilio; review the Security Audits panel on this Prism page and never commit PILIO_API_KEY to git.
SKILL.md
READMESKILL.md - Upscale Image
# Upscale Image Use the Pilio CLI so upload, task creation, and polling stay aligned with the official SDK. Require `PILIO_API_KEY` in the environment. Do not ask the user to paste API keys into the conversation. Try the same workflow online first: https://pilio.ai/image-upscaler Run: ```bash pnpm dlx @pilio/cli upscale-image --input ./small.png ``` The command returns a task payload. If the task is still pending or processing, wait for it: ```bash pnpm dlx @pilio/cli task wait <task_id> ```