Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xzhih--app-icon-skill/badge.svg)](/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

i

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)

  1. ![App Icon Gen banner](assets/app-icon-skill-poster.png)
  2. # App Icon Skill
  3. **English** | [简体中文](README.zh.md)
  4. 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.
  5. 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.
  6. ## Included Skills
  7. ### app-icon-gen
  8. Create, repair, package, and verify app icons from:
  9. - Product briefs and visual direction
  10. - Brand marks, logos, SVGs, and text assets
  11. - Reference images, screenshots, or existing app icons
  12. - Generated concepts selected for conversion
  13. - Optional Apple Icon Composer `.icon` bundles
  14. ### app-icon-template-creator
  15. 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.
  16. ## Install
  17. ```bash
  18. npx skills@latest add xzhih/app-icon-skill --skill app-icon-gen
  19. npx skills@latest add xzhih/app-icon-skill --skill app-icon-template-creator
  20. ```
  21. `app-icon-template-creator` also requires `app-icon-gen` and an available raster image-generation skill. Install both repository skills when creating templates.
  22. ## Quick Start
  23. Ask Codex to use the skill with a brief, a source file, or an existing package:
  24. ```text
  25. 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.
  26. Use $app-icon-gen to convert this SVG logo into a verified app icon package: /path/to/logo.svg
  27. Use $app-icon-gen to repair and verify this existing Icon Composer package: /path/to/MyIcon.icon
  28. 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.
  29. ```
  30. ## Use Cases
  31. - Turn a product brief into a complete app icon package
  32. - Convert brand assets, SVG logos, or reference images into icon-ready sources
  33. - Generate a concept, rebuild it as clean layers, and keep source evidence
  34. - Extract a reusable style template from a reference icon after reconstruction and migration tests
  35. - Produce rounded previews and unrounded app/source assets
  36. - Package layered assets for Apple Icon Composer workflows
  37. - Compare a result against a reference with side-by-side, overlay, and diff reports
  38. - Repair icons that fail visual, geometry, material, or package checks
  39. ## Inputs
  40. You can provide as much or as little as you have:
  41. - App name, platform, category, and target audience
  42. - Visual style, brand colors, and words to avoid
  43. - Logos, SVGs, screenshots, existing icons, or reference images
  44. - Generated concepts or selected candidate images
  45. - Existing `.icon` bundles or app icon folders
  46. `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.
  47. ## Outputs
  48. - Rounded preview SVG/PNG assets
  49. - Unrounded app/source SVG/PNG assets
  50. - Source evidence as `.origin.png` or `.origin.svg` when applicable
  51. - Layered SVG/PNG assets
  52. - Optional Apple Icon Composer `.icon` packages
  53. - Optional Apple-rendered PNG exports on macOS when Icon Composer is available
  54. - Verification reports, side-by-side comparisons, overlays, and diffs
  55. ## Verification-first Workflow
  56. `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.
  57. 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.
  58. The verification path is built into the package flow:
  59. - Preserve the selected source or generated concept as root-level origin evidence
  60. - Generate rounded preview assets separately from unrounded app/source assets
  61. - Keep editable layers in bottom-to-top visual order
  62. - Keep generic source assets as the primary deliverable; add an Icon Composer `.icon` package only when Apple output is requested
  63. - Run package verification and record structured reports under `tmp/reports/`
  64. - When a reference exists, generate side-by-side, overlay, and diff evidence
  65. - Inspect geometry, material warnings, PNG layer hygiene, and local visual drift before accepting the result
  66. - Repair from the spec and regenerate instead of patching generated assets by hand
  67. 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.
  68. ## Current Templates
  69. `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.
  70. | Preview | Template | Best for |
  71. | --- | --- | --- |
  72. | <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 |
  73. | <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 |
  74. | <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 |
  75. | <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 |
  76. | <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 |
  77. | <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 |
  78. | <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 |
  79. | <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 |
  80. | <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 |
  81. | <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 |
  82. | <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 |
  83. | <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 |
  84. | <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 |
  85. | <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 |
  86. ## Repository Layout
  87. - `skills/app-icon-gen/` - the current app icon generation skill
  88. - `skills/app-icon-gen/scripts/` - local authoring, packaging, and verification scripts
  89. - `skills/app-icon-gen/references/` - route-specific design, repair, and verification guidance
  90. - `skills/app-icon-gen/examples/` - semantic prompt and package examples
  91. - `assets/` - project banners, template gallery previews, and example generated icon assets
  92. ## Examples
  93. - Semantic image prompt examples: `skills/app-icon-gen/examples/semantic-image-prompts/`
  94. - Example generated icon package assets: `assets/icon/`

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.