Agent skill

iOS Icon Generator

Generates iOS icon PNG imagesets for Xcode asset catalogs from SF Symbols or the Iconify API, matching the size, color and weight of icons already in the project.

MITAuto-check passedMobile

Install iOS Icon Generator

skills CLI

$ npx skills add affaan-m/ECC --skill ios-icon-gen -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC ios-icon-gen --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ios-icon-gen .claude/skills/ios-icon-gen && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "ios-icon-gen" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/ios-icon-gen into .claude/skills/ios-icon-gen/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ios-icon-gen", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/affaan-m/ECC/tree/main/skills/ios-icon-gen

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add affaan-m/ECC --skill ios-icon-gen -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC ios-icon-gen --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/ios-icon-gen .agents/skills/ios-icon-gen && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "ios-icon-gen" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/ios-icon-gen into .agents/skills/ios-icon-gen/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ios-icon-gen", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add affaan-m/ECC --skill ios-icon-gen -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC ios-icon-gen --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/ios-icon-gen .cursor/skills/ios-icon-gen && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "ios-icon-gen" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/ios-icon-gen into .cursor/skills/ios-icon-gen/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ios-icon-gen", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/affaan-m/ECC.git --path skills/ios-icon-gen

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add affaan-m/ECC --skill ios-icon-gen -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC ios-icon-gen --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/ios-icon-gen .gemini/skills/ios-icon-gen && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "ios-icon-gen" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/ios-icon-gen into .gemini/skills/ios-icon-gen/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ios-icon-gen", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install affaan-m/ECC ios-icon-gen

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add affaan-m/ECC --skill ios-icon-gen -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/ios-icon-gen .github/skills/ios-icon-gen && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "ios-icon-gen" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/ios-icon-gen into .github/skills/ios-icon-gen/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ios-icon-gen", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add affaan-m/ECC --skill ios-icon-gen -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install affaan-m/ECC ios-icon-gen --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/ios-icon-gen .opencode/skills/ios-icon-gen && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "ios-icon-gen" agent skill from https://github.com/affaan-m/ECC/tree/main/skills/ios-icon-gen into .opencode/skills/ios-icon-gen/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ios-icon-gen", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: ios-icon-gen
GitHub stars: 277k
Token cost: ~1.4k tokens
SKILL.md length: 471 words
Files: 3 (incl. scripts)
Skills in repo: 683
Repo updated: Oct 11, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Generates iOS icon PNG imagesets for Xcode asset catalogs from SF Symbols or the Iconify API, matching the size, color and weight of icons already in the project.

Works in 8 steps: Two Sources, One Output Format → Always Match Existing Style → Output Structure → …
Adding icon assets to an Xcode asset catalog
SKILL.md covers When to Activate, Core Principles, Examples and Popular Iconify Collections, plus 3 more sections
Runs Swift and Shell scripts from its folder; calls swift

What it does

Two sources feed one output format. The Iconify API offers a very large set of open-source icons from 200+ collections and needs internet access, while SF Symbols offers 5,000+ Apple symbols, works offline and runs on macOS only. Both produce an Xcode imageset folder with a Contents.json and PNGs at 1x, 2x and 3x, with a default of 68 pixels for the base size.

The steps are to assess what the icon represents and its style, check the dimensions of existing icons with sips, search, optionally preview, then generate. Options set size, color, which defaults to 8E8E93, and output directory. The scripts are iconify_gen.sh for search, preview and generation and generate_icons.swift for SF Symbols, and a table maps common uses such as documents, cameras and settings to symbol names.

When your agent uses it

Adding icon assets to an Xcode asset catalog
Searching open-source icon collections for a glyph
Replacing placeholder icons with production-quality assets
Matching a new icon to the size and color of existing ones

Example prompts

“Find a receipt icon in Iconify and generate an imageset called expenseReport.”
“Generate the camera SF Symbol as a PNG imageset in the Assets folder.”
“Check my existing icon dimensions and create a matching settings icon.”

Requirements

macOS for SF Symbols generation
Internet access for the Iconify API

Workflow steps

8 steps, taken from the step headings in SKILL.md.

Two Sources, One Output Format
Always Match Existing Style
Output Structure
Assess Requirements
Search for Icons
Preview (Optional)
Generate
Verify and Integrate

What it can do on your machine

Read from SKILL.md and the folder at commit 2d515e4. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 2 files in scripts/ (Swift and Shell), which the agent can run.
Shell commands in SKILL.md call:
- swift
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- icon-sets.iconify.design
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

iOS Icon Generator loads about 1.4k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 471 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~75
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 2d515e4, republished under its MIT licence (© affaan-m). 471 words, ~1,414 tokens.

Download SKILL.mdSave it as .claude/skills/ios-icon-gen/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: ios-icon-gen
description: Generate iOS app icons as PNG imagesets for Xcode asset catalogs from SF Symbols (5000+ Apple-native) or Iconify API (275k+ open source icons from 200+ collections). Use when generating icons, creating icon assets, adding icons to asset catalog, or searching for icons for iOS projects.
metadata.origin: community

iOS Icon Generator

Generate PNG icon imagesets for Xcode asset catalogs from two sources.

When to Activate

Generating icon assets for an iOS/macOS Xcode project
Searching for icons across open source collections
Creating PNG imagesets (1x, 2x, 3x) for asset catalogs
Replacing placeholder icons with production-quality assets
Matching existing icon styles in an Xcode project

Core Principles

1. Two Sources, One Output Format

Both sources produce identical Xcode-compatible imagesets. Choose based on need:

Source	Icons	Requires	Best for
Iconify API	275,000+ from 200+ collections	Internet	Wide selection, specific styles, open source icons
SF Symbols	5,000+ Apple symbols	macOS only	Apple-native style, offline use

2. Always Match Existing Style

Before generating, check the project's existing icons for size, color, and weight consistency.

3. Output Structure

Both methods produce a complete Xcode imageset:

<output-dir>/<asset-name>.imageset/
  Contents.json
  <asset-name>.png        # 1x (68px default)
  <asset-name>@2x.png     # 2x (136px default)
  <asset-name>@3x.png     # 3x (204px default)

Examples

Step 1: Assess Requirements

Determine icon needs: what the icon represents, preferred style, target color, and size.

If the project already has icons, check existing style:

bash

# Check dimensions of existing icon
sips -g pixelWidth -g pixelHeight path/to/existing@2x.png

Step 2: Search for Icons

Iconify API (recommended for wide selection):

bash

# Search all collections
$SKILL_DIR/scripts/iconify_gen.sh search "receipt"

# Search within a specific collection
$SKILL_DIR/scripts/iconify_gen.sh search "business card" --prefix mdi

# List available collections
$SKILL_DIR/scripts/iconify_gen.sh collections

SF Symbols (for Apple-native style): Browse the SF Symbols app or reference common names:

Use Case	Symbol Name
Document	`doc.text`, `doc.fill`
Receipt	`doc.text.below.ecg`, `receipt`
Person	`person.crop.rectangle`, `person.text.rectangle`
Camera	`camera`, `camera.fill`
Scan	`doc.viewfinder`, `qrcode.viewfinder`
Settings	`gearshape`, `slider.horizontal.3`

Step 3: Preview (Optional)

bash

# Iconify preview
$SKILL_DIR/scripts/iconify_gen.sh preview mdi:receipt-text-outline

Step 4: Generate

Iconify API:

bash

# Basic generation
$SKILL_DIR/scripts/iconify_gen.sh mdi:receipt-text-outline editTool_expenseReport

# Custom color and output location
$SKILL_DIR/scripts/iconify_gen.sh mdi:receipt-text-outline myIcon --color 007AFF --output ./Assets.xcassets/icons

Options: --size <pt> (default: 68), --color <hex> (default: 8E8E93), --output <dir> (default: /tmp/icons)

SF Symbols:

bash

# Basic generation
swift $SKILL_DIR/scripts/generate_icons.swift doc.text.below.ecg editTool_expenseReport

# Custom color, weight, and output
swift $SKILL_DIR/scripts/generate_icons.swift person.crop.rectangle myIcon --color 007AFF --weight regular --output ./Assets.xcassets/icons

Options: --size <pt> (default: 68), --color <hex> (default: 8E8E93), --weight <name> (default: thin), --output <dir> (default: /tmp/icons)

Step 5: Verify and Integrate

Read the generated @2x PNG to verify visually

Copy to asset catalog if not output there directly:

bash

cp -r /tmp/icons/<name>.imageset path/to/Assets.xcassets/<group>/

Build the project to verify Xcode picks up the new assets

Show full SKILL.md (189 more words)Show less

Popular Iconify Collections

Prefix	Name	Count	Style
`mdi`	Material Design Icons	7400+	Filled + outline variants
`ph`	Phosphor	9000+	6 weights per icon
`solar`	Solar	7400+	Bold, linear, outline
`tabler`	Tabler Icons	6000+	Consistent stroke width
`lucide`	Lucide	1700+	Clean, minimal
`ri`	Remix Icon	3100+	Filled + line variants
`carbon`	Carbon	2400+	IBM design language
`heroicons`	HeroIcons	1200+	Tailwind CSS companion

Browse all: https://icon-sets.iconify.design/

Scripts Reference

Script	Source	Path
`iconify_gen.sh`	Iconify API (275k+ icons)	`$SKILL_DIR/scripts/iconify_gen.sh`
`generate_icons.swift`	SF Symbols (5k+ icons)	`$SKILL_DIR/scripts/generate_icons.swift`

Best Practices

Search before generating -- browse available icons to find the best match
Match existing project style -- check dimensions, color, and weight of existing icons before generating new ones
Use Iconify for variety -- 200+ collections means you can find the exact style you need
Use SF Symbols for Apple consistency -- they match system UI perfectly
Generate directly to asset catalog -- use --output ./Assets.xcassets/icons to skip manual copying
Verify visually -- always preview the @2x PNG before committing

Anti-Patterns

Generating icons without checking existing project icon style
Using default colors when the project has a defined color palette
Generating at wrong sizes (check existing icons first)
Committing generated icons without visual verification

Files

SKILL.md and 2 other files (scripts) in skills/ios-icon-gen of affaan-m/ECC.

SKILL.md
scripts/generate_icons.swift
scripts/iconify_gen.sh

Open the folder on GitHubat commit 2d515e4

Compare with similar skills

iOS Icon Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

iOS Icon Generator compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
iOS Icon Generator this skillaffaan-m/ECC	277k	—	~1.4k	Automated safety check: Pass	MIT	today
App Icon Generatorrshankras/claude-code-apple-skills	787	—	~5.1k	Automated safety check: Notes	MIT	2 mo ago
Coding Assistantwpsnote/wpsnote-skills	179	—	~1.1k	Automated safety check: Pass	None	4 mo ago
Orca iOS Simulator Controlstablyai/orca	89k	1 repos	~584	Automated safety check: Pass	Apache-2.0	today
Apple Crash Log .NET Symbolicationdotnet/skills	5.6k	1 repos	~2.4k	Automated safety check: Pass	MIT	yesterday
Update Swiftui APIsAvdLee/SwiftUI-Agent-Skill	3.7k	—	~1.2k	Automated safety check: Pass	MIT	5 days ago

Similar skills

App Icon Generator
rshankras/claude-code-apple-skills
Generates an app icon for macOS or iOS — a fast CoreGraphics placeholder and/or flat layered source art to finish in Icon Composer (the Liquid Glass / iOS 26+ standard).
787 GitHub stars~5.1k tokensUpdated 2 mo ago
Frontend & DesignAuto-check: notes
Coding Assistant
wpsnote/wpsnote-skills
多平台编码助手。遵循各平台官方文档做编码规范、单测与编译/lint；协助将核心技术梳理为完整 WPS 笔记技术文档。生成的笔记必须包含 7 个二级标题（核心技术、核心代码、关键技术点、核心类和职责、调用链、架构概览、注意事项）；其中架构、核心技术、调用链的图示优先用 WPS 笔记的 generateimage 根据描述生成图片再用 insertimage…
179 GitHub stars~1.1k tokensUpdated 4 mo ago
MobileAuto-check passed
Orca iOS Simulator Control
stablyai/orca
iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…
89k GitHub starsUsed in 1 repo~584 tokens
MobileAuto-check passed
Apple Crash Log .NET Symbolication
dotnet/skills
Official
Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.
5.6k GitHub starsUsed in 1 repo~2.4k tokens
MobileAuto-check passed
Update Swiftui APIs
AvdLee/SwiftUI-Agent-Skill
Scan Apple's SwiftUI documentation for deprecated APIs and update the SwiftUI Expert Skill with modern replacements.
3.7k GitHub stars~1.2k tokensUpdated 5 days ago
MobileAuto-check passed
iOS Simulator Skill
conorluddy/ios-simulator-skill
29 production-ready scripts for iOS app testing, building, and automation.
1.3k GitHub stars~5.7k tokensUpdated 5 days ago
MobileAuto-check passed

Questions about iOS Icon Generator

What does iOS Icon Generator do?

Generates iOS icon PNG imagesets for Xcode asset catalogs from SF Symbols or the Iconify API, matching the size, color and weight of icons already in the project. Two sources feed one output format. The Iconify API offers a very large set of open-source icons from 200+ collections and needs internet access, while SF Symbols offers 5,000+ Apple symbols, works offline and runs on macOS only.

When should I use iOS Icon Generator?

iOS Icon Generator fits situations like: adding icon assets to an Xcode asset catalog; searching open-source icon collections for a glyph; replacing placeholder icons with production-quality assets; matching a new icon to the size and color of existing ones.

How do I install iOS Icon Generator in Claude Code?

Run `npx skills add affaan-m/ECC --skill ios-icon-gen -a claude-code`. Or copy the skill folder (skills/ios-icon-gen in affaan-m/ECC) into .claude/skills/ios-icon-gen in your project. Claude Code loads it when a task matches its description.

How do I install iOS Icon Generator in Codex?

Run `npx skills add affaan-m/ECC --skill ios-icon-gen -a codex`. Or copy the skill folder (skills/ios-icon-gen in affaan-m/ECC) into .agents/skills/ios-icon-gen in your project. Codex loads it when a task matches its description.

Can I use iOS Icon Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill ios-icon-gen -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ios-icon-gen, .gemini/skills/ios-icon-gen, .github/skills/ios-icon-gen and .opencode/skills/ios-icon-gen in your project.

What does iOS Icon Generator need to run?

Going by SKILL.md and its folder, iOS Icon Generator needs Swift and a shell for the scripts in its folder and the command-line tools its instructions call (swift). Our summary lists: macOS for SF Symbols generation; Internet access for the Iconify API.

Does iOS Icon Generator access the network?

SKILL.md names 1 domain. As links in the text: icon-sets.iconify.design. This is read from the text; nothing was executed.

Is iOS Icon Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does iOS Icon Generator use?

iOS Icon Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does iOS Icon Generator use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to iOS Icon Generator?

Skills that share tags, products or a category with iOS Icon Generator: App Icon Generator (rshankras/claude-code-apple-skills, 787 stars), Coding Assistant (wpsnote/wpsnote-skills, 179 stars), Orca iOS Simulator Control (stablyai/orca, 89k stars) and Apple Crash Log .NET Symbolication (dotnet/skills, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains iOS Icon Generator?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,673 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 11, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install iOS Icon Generator

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

iOS Icon Generator

When to Activate

Core Principles

1. Two Sources, One Output Format

2. Always Match Existing Style

3. Output Structure

Examples

Step 1: Assess Requirements

Step 2: Search for Icons

Step 3: Preview (Optional)

Step 4: Generate

Step 5: Verify and Integrate

Popular Iconify Collections

Scripts Reference

Best Practices

Anti-Patterns

Files

Compare with similar skills

Similar skills

More from affaan-m/ECC

Related

Questions about iOS Icon Generator