upscale-image

Original：🇺🇸 English
Translated
1 scripts

This skill should be used when the user asks to "upscale an image", "increase image resolution", "make image bigger", "enlarge image", or "enhance image resolution". Requires Vertex AI credentials.

2installs
Sourceb-open-io/gemskills
Added on

NPX Install

npx skill4agent add b-open-io/gemskills upscale-image

Tags

Translated version includes tags in frontmatter
image-upscalingvertex-aiimagen-modelgcloud-setupai-image-processing

SKILL.md Content

View Translation Comparison →

Upscale Image

Upscale images using Imagen on Vertex AI.

Prerequisites

This skill requires Vertex AI credentials (not GEMINI_API_KEY).

Check Current Setup

bash
echo "Project: ${GOOGLE_CLOUD_PROJECT:-NOT SET}"
gcloud auth application-default print-access-token &>/dev/null && echo "Auth: OK" || echo "Auth: NOT CONFIGURED"

First-Time Setup

If credentials are not configured, guide the user through these steps:
  1. Get a Google Cloud Project
  2. Enable Vertex AI API
  3. Enable Billing
  4. Install gcloud CLI (if not installed)
  5. Authenticate
    bash
    gcloud auth application-default login
    This opens a browser for Google sign-in.
  6. Set Environment Variable
    bash
    echo 'export GOOGLE_CLOUD_PROJECT=your-project-id' >> ~/.zshenv

Usage

bash
bun run ${CLAUDE_PLUGIN_ROOT}/skills/upscale-image/scripts/upscale.ts <input-image> [options]

Options

  • --factor <x2|x4>
    - Upscale factor (default: x2)
  • --format <png|jpeg|webp>
    - Output format
  • --quality <n>
    - JPEG quality (1-100)
  • --output <path>
    - Output path
  • --project <id>
    - Google Cloud project (overrides env var)
  • --location <region>
    - Vertex AI location (default: us-central1)

Examples

bash
# 2x upscale
bun run ${CLAUDE_PLUGIN_ROOT}/skills/upscale-image/scripts/upscale.ts photo.jpg

# 4x upscale
bun run ${CLAUDE_PLUGIN_ROOT}/skills/upscale-image/scripts/upscale.ts photo.jpg --factor x4

# Upscale and save as PNG
bun run ${CLAUDE_PLUGIN_ROOT}/skills/upscale-image/scripts/upscale.ts photo.jpg --factor x4 --format png --output hires.png

# Specify project explicitly
bun run ${CLAUDE_PLUGIN_ROOT}/skills/upscale-image/scripts/upscale.ts photo.jpg --project my-gcp-project --factor x4

Context Discipline

Do not read generated images back into context. The script outputs only the file path. Ask the user to visually inspect the result. Upscaled images are especially large (2x/4x resolution) and will quickly exhaust the context window.

Model

Uses 
imagen-3.0-generate-002
via Vertex AI upscaleImage API.

Why Vertex AI?

The Imagen upscaling API is only available through Vertex AI, not the standard Gemini API. This is a Google limitation - the 
upscaleImage
method in the @google/genai SDK only works with Vertex AI backend.