app-icon-generator_skill

This skill generates production-grade macOS and iOS app icons programmatically in Swift, producing all required sizes for asset catalogs.

Swift

56

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill rshankras/claude-code-apple-skills --skill app-icon-generator

apple-hig-icons.md5.6 KB
SKILL.md10.3 KB

Overview

This skill generates production-quality app icons programmatically using a self-contained CoreGraphics Swift script that follows Apple HIG. It produces three 1024x1024 variants, resizes for the target platform, and can install icons into an Xcode asset catalog automatically. Use it to create placeholder icons, iterate designs, or regenerate icons after tweaks.

How this skill works

The skill scans the project for an AppIcon asset catalog and reads Contents.json to detect platform and required sizes, warning if files will be overwritten. It asks a short set of configuration questions (category, visual style, color palette, accent) to choose background gradients, a primary focal element, and optional secondary elements. It outputs scripts/generate-icon.swift which renders three 1024x1024 variants using AppKit/CoreGraphics, then offers automated resizing and Contents.json updates for iOS or macOS.

When to use it

You need a new app icon that follows Apple HIG for iOS or macOS.
You want rapid, repeatable icon variants to present and iterate on.
You need a placeholder icon while branding is in progress.
You want to update or regenerate your app icon programmatically.
You need consistent export and installation into an Xcode asset catalog.

Best practices

Answer the configuration questions to pick category, style, palette, and accent before generating.
Follow Apple HIG rules: no text, single focal point, simple shapes, and ensure contrast.
Preview all three 1024px variants and test at small sizes (16x16) before installing.
Keep scripts/generate-icon.swift in the repo for future regeneration and adjustments.
When installing, back up existing AppIcon.appiconset to avoid accidental overwrite.

Example use cases

Generate three distinct icon concepts (bold symbol, gradient glyph, abstract mark) to share with stakeholders.
Create a developer-tools icon with a dark theme and terminal glyph, then install into the macOS asset catalog.
Produce a temporary placeholder icon for an iOS beta build while branding is finalized.
Adjust a single parameter (accent color or dot radius), re-run the script, and produce updated variants quickly.

FAQ

It supports iOS (1024x1024 master) and macOS (full set of required sizes) and detects the target from the asset catalog.

Can I customize the generated shapes and colors?

Yes — the script is parameterized by category, style, palette, and accent. Modify those parameters in scripts/generate-icon.swift and re-run.