app-icon-skill
Design, generate, package, repair, and verify polished app icons from briefs, brand assets, references, SVGs, existing icons, and generated concepts.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/xzhih--app-icon-skill)HTML
<a href="/listings/xzhih--app-icon-skill"><img src="/api/listings/xzhih--app-icon-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx skills@latest add xzhih/app-icon-skill --skill app-icon-gen npx skills@latest add xzhih/app-icon-skill --skill app-icon-template-creator
`app-icon-template-creator` also requires `app-icon-gen` and an available raster image-generation skill. Install both repository skills when creating templates.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 134 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- 
- # App Icon Skill
- **English** | [简体中文](README.zh.md)
- A Codex skill collection for designing, generating, packaging, repairing, and verifying app icons for any platform from briefs, brand assets, references, SVGs, existing icons, and generated concepts.
- This repository currently ships `app-icon-gen`, a verification-first workflow for turning icon ideas or source assets into reusable app icon packages, and `app-icon-template-creator`, a workflow for turning reference icons into reusable `app-icon-gen` style templates.
- ## Included Skills
- ### app-icon-gen
- Create, repair, package, and verify app icons from:
- - Product briefs and visual direction
- - Brand marks, logos, SVGs, and text assets
- - Reference images, screenshots, or existing app icons
- - Generated concepts selected for conversion
- - Optional Apple Icon Composer `.icon` bundles
- ### app-icon-template-creator
- Create reusable `app-icon-gen` style templates from reference app icons. It analyzes the source design language, reconstructs the style with an available raster image-generation skill, tests whether the style transfers to different app concepts, and writes a candidate semantic prompt template with conversion rules.
- ## Install
- ```bash
- npx skills@latest add xzhih/app-icon-skill --skill app-icon-gen
- npx skills@latest add xzhih/app-icon-skill --skill app-icon-template-creator
- ```
- `app-icon-template-creator` also requires `app-icon-gen` and an available raster image-generation skill. Install both repository skills when creating templates.
- ## Quick Start
- Ask Codex to use the skill with a brief, a source file, or an existing package:
- ```text
- Use $app-icon-gen to create an app icon package for a finance app named Ledgerly. Use a calm, trustworthy visual style with a simple geometric mark.
- Use $app-icon-gen to convert this SVG logo into a verified app icon package: /path/to/logo.svg
- Use $app-icon-gen to repair and verify this existing Icon Composer package: /path/to/MyIcon.icon
- Use $app-icon-template-creator to turn this reference icon into a reusable app-icon-gen template. First prove the source style with reconstruction, then test the template across three different app concepts.
- ```
- ## Use Cases
- - Turn a product brief into a complete app icon package
- - Convert brand assets, SVG logos, or reference images into icon-ready sources
- - Generate a concept, rebuild it as clean layers, and keep source evidence
- - Extract a reusable style template from a reference icon after reconstruction and migration tests
- - Produce rounded previews and unrounded app/source assets
- - Package layered assets for Apple Icon Composer workflows
- - Compare a result against a reference with side-by-side, overlay, and diff reports
- - Repair icons that fail visual, geometry, material, or package checks
- ## Inputs
- You can provide as much or as little as you have:
- - App name, platform, category, and target audience
- - Visual style, brand colors, and words to avoid
- - Logos, SVGs, screenshots, existing icons, or reference images
- - Generated concepts or selected candidate images
- - Existing `.icon` bundles or app icon folders
- `app-icon-gen` always produces generic layered SVG/PNG icon source assets for the requested platforms. Apple Icon Composer is an optional adapter for iOS, iPadOS, macOS, and watchOS. Ask the user before claiming a native Android, Windows, Web, tvOS, or visionOS package unless a dedicated adapter is available.
- ## Outputs
- - Rounded preview SVG/PNG assets
- - Unrounded app/source SVG/PNG assets
- - Source evidence as `.origin.png` or `.origin.svg` when applicable
- - Layered SVG/PNG assets
- - Optional Apple Icon Composer `.icon` packages
- - Optional Apple-rendered PNG exports on macOS when Icon Composer is available
- - Verification reports, side-by-side comparisons, overlays, and diffs
- ## Verification-first Workflow
- `app-icon-gen` does more than create a picture. It keeps source evidence, separates preview assets from app/source assets, generates layered packages, and runs verification reports so the result can be inspected, repaired, and reused.
- The workflow is especially useful when an icon must stay close to a reference, preserve a brand mark, or produce clean source layers instead of a single flattened image.
- The verification path is built into the package flow:
- - Preserve the selected source or generated concept as root-level origin evidence
- - Generate rounded preview assets separately from unrounded app/source assets
- - Keep editable layers in bottom-to-top visual order
- - Keep generic source assets as the primary deliverable; add an Icon Composer `.icon` package only when Apple output is requested
- - Run package verification and record structured reports under `tmp/reports/`
- - When a reference exists, generate side-by-side, overlay, and diff evidence
- - Inspect geometry, material warnings, PNG layer hygiene, and local visual drift before accepting the result
- - Repair from the spec and regenerate instead of patching generated assets by hand
- This makes the icon package easier to review, reuse, and refine. A finished run should leave both the visual assets and the evidence needed to understand why they are ready.
- ## Current Templates
- `app-icon-gen` includes semantic image prompt templates for no-reference icon creation. Each template is a style family with variant axes and a conversion contract, not a fixed icon recipe.
- | Preview | Template | Best for |
- | --- | --- | --- |
- | <img src="assets/templates-gallery/black-stage-mark-signal-vault-02__SignalVaultStack.png" width="96" alt="black-stage-mark template preview"> | `black-stage-mark` | Premium security, developer tools, and high-contrast geometric marks |
- | <img src="assets/templates-gallery/black-stage-continuous-loop-loopvault-02__LoopVaultBlue.png" width="96" alt="black-stage-continuous-loop template preview"> | `black-stage-continuous-loop` | Utilities, fitness, handoff, membership, and connected loop symbols |
- | <img src="assets/templates-gallery/connected-flow-flat-silver-compact-02__RelayFlowBranch.png" width="96" alt="connected-flow-silver template preview"> | `connected-flow-silver` | Automation, sync, workflow, and compact connector topologies |
- | <img src="assets/templates-gallery/blue-field-cutout-badge-01__RouteGuard.png" width="96" alt="blue-field-cutout-badge template preview"> | `blue-field-cutout-badge` | Utility, route, security, and productivity icons with a saturated field, white badge, and same-color cut gesture |
- | <img src="assets/templates-gallery/silver-field-black-mask-catmask-02__CatMaskTwin.png" width="96" alt="silver-field-black-mask template preview"> | `silver-field-black-mask` | Companion, focus, privacy, identity, and abstract mask icons |
- | <img src="assets/templates-gallery/single-hue-gradient-outlined-mascot-charmbyte-01__CharmByteGhost.png" width="96" alt="single-hue-gradient-outlined-mascot template preview"> | `single-hue-gradient-outlined-mascot` | Playful mascot, avatar, customization, and consumer icons |
- | <img src="assets/templates-gallery/single-hue-gradient-soft-white-symbol-emberlite-02__EmberLiteDrop.png" width="96" alt="single-hue-gradient-soft-white-symbol template preview"> | `single-hue-gradient-soft-white-symbol` | Warm, clean, friendly, and lightweight consumer icons |
- | <img src="assets/templates-gallery/outlined-friendly-action-mark-01__LeafCue.png" width="96" alt="outlined-friendly-action-mark template preview"> | `outlined-friendly-action-mark` | Friendly reminder, plant, media, and utility icons with warm fields, bold outlines, and motion accents |
- | <img src="assets/templates-gallery/single-hue-gradient-cropped-silhouette-nighthop-02__NightHopWing.png" width="96" alt="single-hue-gradient-cropped-silhouette template preview"> | `single-hue-gradient-cropped-silhouette` | Bold, premium, mysterious, or night-themed silhouettes |
- | <img src="assets/templates-gallery/dark-gradient-pale-orbit-cluster-quietseed-02__QuietSeedPlum.png" width="96" alt="dark-gradient-pale-orbit-cluster template preview"> | `dark-gradient-pale-orbit-cluster` | Wellness, plant-care, sleep, focus, and cyclical utility icons |
- | <img src="assets/templates-gallery/kinetic-pop-tempostride-ribbon-01__TempoStrideRunner.png" width="96" alt="kinetic-pop template preview"> | `kinetic-pop` | Fitness, mobility, events, and fast-action products |
- | <img src="assets/templates-gallery/organic-blob-fusemap-02__FuseMapKnot.png" width="96" alt="organic-blob-mark template preview"> | `organic-blob-mark` | Clean identity marks with organic shapes on light fields |
- | <img src="assets/templates-gallery/souvenir-decal-stickers-02__SouvenirTravelStickers.png" width="96" alt="souvenir-decal-stickers template preview"> | `souvenir-decal-stickers` | Playful collection, cafe, music, maker, memory, and local apps |
- | <img src="assets/templates-gallery/glass-ribbon-filterwave-01__FilterWaveFan.png" width="96" alt="flat-color-rounded-pane-cluster template preview"> | `flat-color-rounded-pane-cluster` | Camera, video, music, and creative tools with separated color panes |
- ## Repository Layout
- - `skills/app-icon-gen/` - the current app icon generation skill
- - `skills/app-icon-gen/scripts/` - local authoring, packaging, and verification scripts
- - `skills/app-icon-gen/references/` - route-specific design, repair, and verification guidance
- - `skills/app-icon-gen/examples/` - semantic prompt and package examples
- - `assets/` - project banners, template gallery previews, and example generated icon assets
- ## Examples
- - Semantic image prompt examples: `skills/app-icon-gen/examples/semantic-image-prompts/`
- - Example generated icon package assets: `assets/icon/`
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.