Communitygithub.com

app-icon-design

Create, revise, and audit app icons using Apple's Human Interface Guidelines, with a clear visual identity and production-ready deliverables.

What is app-icon-design?

app-icon-design is a Claude Code agent skill that create, revise, and audit app icons using Apple's Human Interface Guidelines, with a clear visual identity and production-ready deliverables.

Works with~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jamesisbuilding/App-Building-Skills/tree/main/skills/appicon-creator

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

App Icon Design Skill

Trigger

Use for any new app icon, icon redesign, icon critique, or Apple app-icon export request. Check Apple's current design and technical documentation when a production spec matters.

Process

  1. Identify the app's core purpose and brand language. Use previously established branding if relevant, otherwise choose a distinctive visual metaphor.
  2. Reduce the metaphor to one recognizable core symbol with bold, filled, simple shapes and a clear silhouette. Avoid tiny details, busy texture, thin strokes, screenshots, unnecessary text, and excessive gloss.
  3. Choose a deliberate, restrained palette and clear foreground/background contrast. Center the primary icon optically and leave a generous safe area for system masks.
  4. Design to remain identifiable at small sizes. Preview at full size, 180 px, 60 px and 30 px (design tests, not Apple-prescribed pixel requirements).
  5. Consider default, dark, clear and tinted modes. Preserve concept and recognizability across appearances.
  6. Review the QA checklist; simplify any element that becomes noise at small scale.
  7. Produce highest-quality assets in formats actually supported by the available tools. Never claim vector/editable source or variants if they haven't been made.

Apple Human Interface Guidelines

  • Prefer simplicity and immediate recognition. Fine features can become noisy once the system adds highlights and shadows.
  • Prefer illustrations to photos and don't merely reproduce app UI.
  • Avoid extremely thin lines and sharp angles if their detail is lost at smaller sizes.
  • Avoid nonessential words, slogans or platform-specific statements.
  • Do not replicate Apple hardware.
  • Use unmasked square layers; the system applies corners/circular masks itself. Do not bake rounded corners into base artwork.
  • Position important content centrally so system masking doesn't truncate it.
  • Icons should maintain visual consistency across devices and appearances.

Apple sizes and system shapes (verified 2026-10-24)

TargetCanvasSystem mask
iOS, iPadOS, macOS1024 × 1024 pxrounded rectangle
watchOS1088 × 1088 pxcircle
visionOS1024 × 1024 pxcircle
tvOS800 × 480 pxrounded rectangle
  • Use sRGB for portable exports; Display P3 is also supported on Apple platforms as documented.
  • For the contemporary Apple workflow, prefer layered artwork and Icon Composer to preview platforms and appearance variants (default, dark, clear light/dark, tinted light/dark).
  • Draw artwork as vectors and export each independently adjustable layer as SVG when possible, converting text to outlines. PNG layers are suitable if SVG features are unsupported.
  • Defer blur, shadows, specular effects, translucency, opacity, gradients and background effects to Icon Composer when preparing Liquid Glass layered icons.
  • Background must cover the full canvas. For a static iOS icon, default to a fully opaque full-bleed backdrop. A transparent isolated glyph is a different asset type, not a complete icon.
  • The system applies masks; do not export mask geometry on artwork layers.
  • Flat 1024px PNG can be delivered for static icon workflows, but it is not equivalent to a layered Icon Composer .icon asset.

QA checklist

  • One memorable concept, recognisable silhouette
  • Legible at small size and in grayscale
  • Limited colours and strong contrast
  • No unnecessary words, texture, fine details, or screenshots
  • Optical centering and safe edge spacing
  • Source artwork square and unmasked, background full-bleed
  • Reviewed against dark, tinted and clear appearances
  • Correct target platform size, color space, and export format
  • Claims about editability, layers and formats match actual files

User's current brain/maths app: optional brand-specific overlay

Use only for this specific project, not all apps:

  • Three solid colours maximum; palette drawn from cobalt/electric blue, violet and magenta-pink (or deep navy when appropriate).
  • No gradients unless user overrides.
  • Abstract, simplified brain silhouette with a handful of bold lobes; no hyperdetailed anatomical illustration.
  • Minimal, recognisable and attractive at small icon sizes. Depth should be restrained and should not add more colours.
  • App icon background is part of the composition, not transparent (unless separate symbol layer requested).

Image-generation brief template

'Create a square app icon for [APP], with one memorable central symbol [SYMBOL], composed of a small number of solid high-contrast shapes in [PALETTE], on a full-bleed opaque [BACKGROUND] backdrop. Center by visual weight, allow generous breathing space around outer edges, avoid gradients [if requested], letters, interface elements and minor detail, strong recognition at tiny sizes, no built-in rounded-corner mask.'

Source of truth

  1. Apple HIG app icons: https://developer.apple.com/design/human-interface-guidelines/app-icons
  2. Apple's Icon Composer workflow: https://developer.apple.com/documentation/xcode/creating-your-app-icon-using-icon-composer
  3. Apple Design Resources: https://developer.apple.com/design/resources/
  4. Apple Icon Composer: https://developer.apple.com/icon-composer/

Design advice is a synthesis; check current Apple specifications before release. This is a portable skill document, not proof that it is registered as an executable system/plugin skill.

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

app-keyword-research

Validate an app idea against the App Store before building it. Turns the idea into search phrases, measures demand (App Store autocomplete) and competition (current top-10 apps) for each, ranks keywords by opportunity, and maps which apps own the market. Use when the user wants keyword research, ASO, "is there demand for…", "who are the competitors for…", "what should we call it / which keywords", or to validate or compare app ideas.

app-offer

Designs one opinionated "Grand Slam Offer" for any app idea, new or already shipped, by running Alex Hormozi's $100M Offers method adapted to app stores. It covers the market and niche, the commodity check, a value-equation audit, the problem inventory, delivery vehicles, the trimmed value stack, pricing and tiers, scarcity, urgency, bonuses, the guarantee, naming, the paywall per placement, the onboarding fast win, a test plan and a ship plan. It works within App Store and Google Play rules. For a shipped app it reads the code and notes first and produces a before/after. Use it when the user says "/app-offer", "run app-offer on <idea>", "make a grand slam offer for my app", "Hormozi my app", "price my app" or "design my paywall offer", or asks how to package, price, name, guarantee or paywall an app. It writes offer/grand-slam-offer.md (or ./<app-slug>-grand-slam-offer.md for a new idea).

brand-reference-pack

Build or refresh a shortform brand reference pack for any app from its real surfaces — website, App Store listing and reviews, socials, the live app (driven end to end on the simulator) and its code tokens — plus a status check of the upstream foundations (ICP, voice of customer, brand voice). Produces the context that content formats and design decisions are made from, as markdown, tokens.json and a PDF. Use for "build a brand pack for <app>", "refresh the brand pack", "capture the site/app/socials for shortform", "/brand-reference-pack".

deep-work

Timekeeper and scribe for the user's own timeboxed build session, default 90 min, also 1h / 1.5h / 2h (Orient, Build, Verify, Harden, Close, scaled to the block). Use when the user says "start a session", "deep work", "90 min block", "work block", or invokes /deep-work. Subcommands: status, park <note>, close, abort.

new-app-info

Builds the information pack Apple asks for when App Review replies "We need additional information to better understand the app". It covers all six required items: (1) a screen recording on a physical device, as a shot list the user records; (2) the app's purpose and target audience; (3) setup and main features, with any login credentials or sample files; (4) the external services the app uses; (5) regional differences; (6) regulated industry or protected third-party material. It also runs Apple's "Prevent common issues" checks. Every answer comes from the app's own code (accounts, user-generated content, in-app purchases, SDKs, locales, screen-capture blocking, data deletion). It reads the connected iPhone's iOS version and checks it is the latest. It ends by telling the user to paste the reply into App Review Information → Notes. Use it when the user pastes that App Review message, says "/new-app-info", "we got rejected, they want more info", "answer App Review", or "make the App Store review pack". It w...

reel-motion-graphics

Turn a script or concept into an on-brand 9:16 explainer reel (luxury tech, warm sand on near-black, glassmorphism, CSS 3D, Bodoni + Instrument Sans) built in HyperFrames, with the animation above the fold and the presenter's talking head below. Use when the user gives a script, transcript, paper summary or concept and asks for a reel, motion graphics, an animated explainer or "the same style as the upcycling reel". Produces a HyperFrames project, a rendered MP4 and a live artifact player.

Related Skills