upscale-image — Claude Code skill: what it does, how to install
Upscales images and improves clarity through the Pilio API. Use it when an agent needs to process an image file and wait for the completed task.
npx skills add pilioai/skills --skill upscale-image -a claude-codeWhat upscale-image does
The skill uses the Pilio CLI to upload an image, create an enhancement task, and check its status. Its main command takes an image path through --input, such as ./small.png.
The CLI returns a task payload after submission. When the task remains pending or processing, the skill waits with pnpm dlx @pilio/cli task wait <task_id>.
PILIO_API_KEY must be available in the environment. Set it up before using the skill, because API keys should not be pasted into an agent conversation.
What it helps with
- upscale an image file
- improve image clarity with Pilio
- create an enhancement task from the CLI
- wait for a Pilio task to finish
Example prompts for the agent
- Upscale
./small.pngthrough Pilio. - Improve
./small.pngand wait for the result. - Process
./small.pngwith@pilio/cli.
How to install upscale-image
1Skills CLI (Vercel)
npx skills add pilioai/skills --skill upscale-image -a claude-code2Manually: put the files in place
~/.claude/skills/upscale-image/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/upscale-image/
1Skills CLI (Vercel)
npx skills add pilioai/skills --skill upscale-image -a codex2Manually: put the files in place
.agents/skills/upscale-image/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pilioai/skills --skill upscale-image -a cursor2Manually: put the files in place
.cursor/skills/upscale-image/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pilioai/skills upscale-image2Manually: put the files in place
.github/skills/upscale-image/SKILL.md1Skills CLI (Vercel)
npx skills add pilioai/skills --skill upscale-image -a gemini-cli2Platform CLI
gemini skills install https://github.com/pilioai/skills --path skills/upscale-imageManually: put the files in place
.devin/skills/upscale-image/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pilioai/skills --skill upscale-image -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about upscale-image
How do I install upscale-image in Claude Code?
Run npx skills add pilioai/skills --skill upscale-image -a claude-code, then run npx skills add pilioai/skills --skill upscale-image -a claude-code again. The skill file is at ~/.claude/skills/upscale-image/SKILL.md.
What does upscale-image do?
It sends an image to the Pilio API through the CLI for upscaling or enhancement. It creates a task and can wait until that task completes.
What does upscale-image require?
It requires PILIO_API_KEY in the environment. Do not paste the API key into the agent conversation.
Source text
SKILL.md · MIT
--- name: upscale-image description: Upscale or enhance an image with the Pilio developer API. Use when the user wants higher-resolution images, AI super-resolution, image clarity improvement, or automated image enhancement through Pilio. --- # 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> ```
© pilioai · MIT · pilioai/skills
