agentleFS
Sign inStart free
anhaoanhao/icon-generator-skill/SKILL.md

icon-generator

Skill2 starsChanged 8 months agoMITView on GitHub

Generate Android and iOS app icon sets from one source image with a bundled Pillow script. Use when Codex needs to create mobile app launcher icons, iOS AppIcon.appiconset assets, Android mipmap icons, adaptive icon foreground/background/XML files, extra square sizes, or rounded-corner icon exports from a logo or artwork file.

  • Installs packages

7 other projects use a version of this.

Adopted by

Most recently taken up by

  • Other versions7 projects use a version of this.

    Word for word · 0

    None found.

    Edited · 0

    None found.

    Wrote their own version · 7

    1. anbeime/skill★ 7.9ksame name
    2. UXLana/design-skills-pack★ 8same name
    3. dycnnnb/skills★ 2same name
    4. aki77/skills★ 1same name
    5. ZeroTokenClaw/agents-skills★ 1same name
    6. Gopyr/gopyr-skills-hub★ 0same name
    7. jagypus/icon-generator★ 0same name

    How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.

The file

Show its rules and text

We split this skill into the rules it gives an agent

17 rules. 0 are common, 4 are distinctive, and 13 are very specific to this project.

  • 0

    Common

    Most of the 3 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 13

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use the bundled script to turn one source image into Android and iOS app icon assets.

    line 10
  2. Very specific:

    Use the default contain mode when the full logo must stay visible and padding is acceptable.

    line 28
  3. Very specific:

    Use cover when the icon must fill the square and center-cropping is acceptable.

    line 29
  4. Very specific:

    Use --background to control padding color for non-square sources.

    line 30
  5. Very specific:

    Use --corner-radius when the exported icons should already include rounded corners.

    line 31
  6. Very specific:

    Use --extra-sizes when the user wants additional square PNGs beyond the built-in Android and iOS sizes.

    line 32
  7. Very specific:

    Use --android-adaptive when the user explicitly needs Android adaptive icon resources.

    line 33
  8. Very specific:

    Check android/mipmap-* for launcher PNGs.

    line 65
  9. Very specific:

    Check android/play-store/play_store_icon.png for the 512px store asset.

    line 66
  10. Very specific:

    Check ios/AppIcon.appiconset/Contents.json plus the generated PNG files.

    line 67
  11. Very specific:

    If adaptive icons were requested, check android/mipmap-anydpi-v26/ for the XML files and ic_launcher_foreground.png / …

    line 68
  12. Distinctive:

    If the script exits with a Pillow import error, install Pillow and rerun.

    line 72
  13. Very specific:

    If colors fail to parse, pass #RRGGBB or #RRGGBBAA.

    line 73
  14. Distinctive:

    If the source image is missing, stop and confirm the path before regenerating.

    line 74
  15. Distinctive:

    If the user asks for non-square outputs or hand-tuned retouching, this skill is the wrong tool.

    line 75
  16. Very specific:

    Use scripts/icon_generator.py for the actual export.

    line 79
  17. Very specific:

    Read references/usage.md for argument details, size lists, and output structure.

    line 80

“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Icon Generator

Overview

Use the bundled script to turn one source image into Android and iOS app icon assets. Prefer this skill when the task is deterministic icon export rather than manual image editing.

Quick Start

  1. Confirm the input image path.
  2. Run python3 scripts/icon_generator.py <input-image> -o <output-dir>.
  3. Inspect the generated android/ and ios/AppIcon.appiconset/ folders.

Install Pillow first if needed:

python3 -m pip install 'Pillow>=10.0.0'

Workflow

Choose output behavior

  • Use the default contain mode when the full logo must stay visible and padding is acceptable.
  • Use cover when the icon must fill the square and center-cropping is acceptable.
  • Use --background to control padding color for non-square sources.
  • Use --corner-radius when the exported icons should already include rounded corners.
  • Use --extra-sizes when the user wants additional square PNGs beyond the built-in Android and iOS sizes.
  • Use --android-adaptive when the user explicitly needs Android adaptive icon resources.

Run the script

Basic export:

python3 scripts/icon_generator.py input.png -o output_icons

Export with crop, white padding, extra sizes, and rounded corners:

python3 scripts/icon_generator.py input.png \
  -o output_icons \
  --mode cover \
  --background '#FFFFFFFF' \
  --extra-sizes 256 384 \
  --corner-radius 18

Export Android adaptive icons too:

python3 scripts/icon_generator.py input.png \
  -o output_icons \
  --android-adaptive \
  --adaptive-background '#FFFFFF'

Validate Result

  • Check android/mipmap-* for launcher PNGs.
  • Check android/play-store/play_store_icon.png for the 512px store asset.
  • Check ios/AppIcon.appiconset/Contents.json plus the generated PNG files.
  • If adaptive icons were requested, check android/mipmap-anydpi-v26/ for the XML files and ic_launcher_foreground.png / ic_launcher_background.png.

Troubleshooting

  • If the script exits with a Pillow import error, install Pillow and rerun.
  • If colors fail to parse, pass #RRGGBB or #RRGGBBAA.
  • If the source image is missing, stop and confirm the path before regenerating.
  • If the user asks for non-square outputs or hand-tuned retouching, this skill is the wrong tool; use an image editing workflow instead.

Resources

  • Use scripts/icon_generator.py for the actual export.
  • Read references/usage.md for argument details, size lists, and output structure.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free