SkillsAdd

pilioai/skills

gpt-image-2

Create or edit images with Pilio GPT Image 2 through the unified Pilio developer API. Use when the user wants text-to-image generation, prompt-based image editing, restyling, product-photo transformation, or composition from one or more local reference images.

All-time #1208 First seen May 3, 2026
8-week activity · all time api

Installation

$ npx skills add pilioai/skills --skill gpt-image-2
View on skills.sh ↗ GitHub repository ↗
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

Summary

  • Text-to-image generation and prompt-based image editing via the Pilio GPT Image 2 API.
  • Generate images from text prompts or edit and compose from one or more local reference images Supports multiple aspect ratios (1:1, 3:2, 16:9, 21:9, and more) and quality/resolution tiers (low/medium/high, 0.5K to 4K) Requires PILIO_API_KEY environment variable; use the Pilio CLI for consistent polling, credit tracking, and error handling Returns async task payloads with built-in task wait command for monitoring generation status

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

image-manipulation-image-magick Similar name
github/awesome-copilot

Process and manipulate images using ImageMagick. Supports resizing, format conversion, batch pr…

9.7K installs
java-add-graalvm-native-image-support Similar name
github/awesome-copilot

GraalVM Native Image expert that adds native image support to Java applications, builds the pro…

8.7K installs
imagegen Similar name
openai/skills

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as ph…

27 installs
creating-ec2-image-builder-pipeline Similar name
aws/agent-toolkit-for-aws

Creates a complete EC2 Image Builder pipeline that builds a custom AMI with pre-installed softw…

3.9K installs
azure-image-builder Similar name
hashicorp/agent-skills

Build Azure managed images and Azure Compute Gallery images with Packer. Use when creating cust…

8 installs
physical-ai-defect-image-generation Similar name
nvidia/skills

>- Use when the user wants to orchestrate defect image generation with NVIDIA Cosmos AnomalyGen…

2K installs

Also in this package

Other skills from pilioai/skills.

npx skills add pilioai/skills
nano-banana-2 13.5K remove-background 7.6K remove-image-watermark 7.6K upscale-image 7.5K remove-pdf-watermark 7.4K nano-banana-pro 60

Browse all from pilioai/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 43
License LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,467 B
  • docs SUMMARY.md 279 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 20,312 installs

Videos

Tutorials, guides, and showcases specifically about this skill.

SKILL.md

GPT Image 2

Use the Pilio CLI so upload, polling, credits, and API errors stay consistent with the official SDK.

Require PILIOAPIKEY in the environment. Do not ask the user to paste API keys into the conversation.

Try the same workflow online first: https://pilio.ai/

Generate from text:

pnpm dlx @pilio/cli gpt-image-2 --prompt "<prompt>" --aspect-ratio "1:1"

Edit or compose from one or more references:

pnpm dlx @pilio/cli gpt-image-2 --input ./reference.png --prompt "<edit prompt>"

Common options:

  • --input: local reference image path. Repeat for multiple references.
  • --aspect-ratio: 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 16:9, 9:16, 21:9, or auto.
  • --quality: low, medium, or high.

GPT Image 2's upstream model does not expose a separate resolution parameter. Use --aspect-ratio to request the output canvas shape; Pilio appends that ratio to the prompt to guide generation. Requests containing resolution are rejected with HTTP 400.

The command returns a task payload. If the task is still pending or processing, wait for it:

pnpm dlx @pilio/cli task wait <task_id>