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 #958 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 ↗

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

Stronger alternatives

Audit results are mixed — compare nearby options before installing.

nano-banana-2 Same source
pilioai/skills 13.5K installs
remove-background Same source
pilioai/skills

Remove an image background with the Pilio developer API. Use when the user wants transparent-ba…

7.6K installs
remove-image-watermark Same source
pilioai/skills

Remove visible watermarks from an image with the Pilio developer API. Use when the user wants t…

7.5K installs
upscale-image Same source
pilioai/skills

Upscale or enhance an image with the Pilio developer API. Use when the user wants higher-resolu…

7.5K installs

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.6K 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…

4.3K 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…

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

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

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

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

1.9K installs

Security audits

Partner security reviews for this skill.

agent-trust-hub SAFE

Analyzed May 5, 2026

This skill is safe. It uses the official Pilio CLI tool to provide image generation and editing capabilities through the vendor's API. No malicious patterns were detected.

snyk MEDIUM

Analyzed May 5, 2026

[MEDIUM] W012: Unverifiable external dependency detected (runtime URL that controls agent).

socket Score 0.9000 · 1 alerts

Analyzed May 5, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

1 alert

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.5K 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>