b-open-io/gemskills/generate-icon

Name: generate-icon
Author: b-open-io

Claude Code and agent skill by b-open-io/gemskills

Trust tier 2

community

Source check pending

Checking that the SKILL.md file is still in the repository.

This skill should be used when the user asks to "generate an icon", "create a favicon", "make an app icon", "create iOS icon", "create Android icon", "generate PWA icons", "make desktop app icon", "create Windows icon", "create macOS icon", "app store icon", "Play Store icon", "App Store icon", or needs AI-generated icons with platform-specific sizing.

Install

npx vskill@latest install b-open-io/gemskills/generate-icon

SKILL.md

Generate Icon Skill

Generate professional icons for any platform using OpenAI GPT Image 2.6 or Gemini (auto-picked by available key) with automatic background removal, cropping, and multi-size export.

Quick Start

bash

# Favicon for website
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "modern tech startup logo letter S" --preset favicon --output ./icons/favicon
 
# iOS App Store icons
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "meditation app lotus flower" --preset apple-app-icon --output ./icons/ios
 
# Android Play Store + adaptive icons
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "fitness tracker flame icon" --preset android-app-icon --output ./icons/android
 
# PWA manifest icons
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "productivity app checkmark" --preset pwa --output ./icons/pwa
 
# macOS desktop app
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "code editor brackets symbol" --preset macos-icns --output ./icons/macos
 
# Windows desktop app
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "music player note icon" --preset windows-ico --output ./icons/windows
 
# General UI icons
bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "settings gear" --preset ui-icons --output ./icons/ui

Presets

Preset	Description	Sizes	Bundle
`apple-app-icon`	iOS/iPadOS App Store	18 sizes (1024-20px)	No
`android-app-icon`	Google Play + adaptive layers	11 sizes + foreground	No
`favicon`	Browser tab icons	8 sizes + ICO	Yes (.ico)
`pwa`	Progressive Web App	11 sizes + maskable	No
`macos-icns`	macOS desktop	10 sizes	Yes (.icns)
`windows-ico`	Windows desktop	7 sizes	Yes (.ico)
`ui-icons`	In-app icons	9 sizes (512-16px)	No

Pipeline

Generate - Creates master icon at high resolution via Gemini
Remove Background - Uses Replicate rembg for clean edges
Crop & Center - Trims whitespace, centers on square canvas with 5% padding
Resize - Exports all preset sizes with lanczos3 interpolation
Bundle - Creates ICO/ICNS bundles where needed

Options

bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "prompt" --preset <name> --output <dir> [options]
 
Required:
  --preset <name>       Platform preset (see table above)
  --output <dir>        Output directory
 
Optional:
  --input <image>       Reference image for style guidance
  --master-image <path> Use existing master instead of generating
  --skip-generate       Skip AI generation (requires --master-image)
  --skip-remove-bg      Skip background removal
  --bg-color <hex>      Background color for non-transparent presets

Examples

Using a reference image

bash

bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "clean app icon version" --preset pwa --input ./existing-logo.png --output ./icons

Using an existing master

bash

bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "" --preset ui-icons --master-image ./my-icon.png --skip-generate --output ./icons

iOS with custom background color

bash

bun run --cwd ${CLAUDE_PLUGIN_ROOT} ${CLAUDE_PLUGIN_ROOT}/skills/generate-icon/scripts/generate.ts "weather app sun" --preset apple-app-icon --bg-color "#0066CC" --output ./icons/ios

Icon Design Tips

DO:

Simple, bold, recognizable silhouette
Single focal point
High contrast
Clean edges
Works at 16x16px

DON'T:

Fine details that disappear at small sizes
Text (unreadable at icon sizes)
Complex gradients (banding issues)
Multiple competing elements
Photos or realistic images

Environment Variables

Variable	Required	Description
`GEMINI_API_KEY`	Yes	Google AI Studio API key
`REPLICATE_API_TOKEN`	Yes	Replicate API token for background removal

Output Structure

output/
├── master-raw.png        # Original generated image
├── master-nobg.png       # Background removed
├── master-cropped.png    # Cropped and centered
├── master-final.png      # With background (iOS only)
├── favicon.ico           # ICO bundle (favicon preset)
├── AppIcon.icns          # ICNS bundle (macos preset)
├── icon-512.png          # Size variants...
├── icon-256.png
└── ...

Context Discipline

Do not read generated icon images back into context. The script outputs file paths for all generated sizes. Ask the user to visually inspect the results. Icon sets produce many files across multiple sizes - reading them back would quickly exhaust the context window.

Troubleshooting

Issue	Solution
"GEMINI_API_KEY not set"	Export your API key: `export GEMINI_API_KEY=your-key`
"REPLICATE_API_TOKEN not set"	Export your token: `export REPLICATE_API_TOKEN=your-token`
ICO not generated	Install ImageMagick: `brew install imagemagick`
ICNS not generated	Only works on macOS (requires iconutil)
Background not removed cleanly	Try a simpler prompt with solid background
Icon too complex	Simplify prompt, avoid "detailed" or "realistic"

Provider support

The master image comes from OpenAI `gpt-image-2.6-sunburst` or Gemini. With no flag, auto-pick prefers OpenAI when OPENAI_API_KEY is set and falls back to the only key present. Force one with --provider openai|gemini. --model sunburst|flare selects the OpenAI variant and implies --provider openai. A --input reference image goes through the OpenAI edits endpoint or the Gemini reference path. xAI is not supported (its image model has no reference images). Background removal needs REPLICATE_API_TOKEN regardless of provider; --skip-remove-bg skips it. A missing provider key stops the script with the exact env var to set.

Security

Security scanPassed, 100 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationFailed, 75 of 100Degrading. 1 run. Evaluated 8 months ago.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/generate-icon/SKILL.md

Popularity

Repository stars: 2
7-day trend score: 5

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 26 Mar 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/b-open-io/gemskills/generate-icon/badge)](https://verified-skill.com/skills/b-open-io/gemskills/generate-icon)

Something wrong with this skill or its page? Tell us.