mcpField
I
icon-generator

icon-generator

github.com/anhaoデザイン・UI284 回インストール32 週間前に更新
リポジトリ

icon-generator について

付属の Python スクリプトで、元画像から Android と iOS のアプリアイコン素材を出力するスキルです。画像の配置、背景、角丸、追加サイズを調整でき、Android のアダプティブアイコン素材も任意で生成できます。

主な機能

  1. 01Android と iOS のアイコン素材を出力
  2. 02contain または cover で画像を配置
  3. 03余白の背景色を指定
  4. 04角丸を適用
  5. 05追加の PNG サイズを生成
  6. 06Android アダプティブアイコンに対応

活用シーン

  1. 01ロゴ画像からアプリアイコンを生成
  2. 02余白付きまたは中央クロップのアイコンを作成
  3. 03追加の正方形 PNG サイズを出力
  4. 04Android アダプティブアイコン素材を準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/anhao/icon-generator-skill --skill icon-generator

インストール後、Claude Code で/icon-generatorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
LICENSE
agents/
openai.yaml
references/
usage.md
scripts/
icon_generator.py

詳細

アイコンジェネレーター

概要

同梱のスクリプトを使って、1 枚の元画像から Android および iOS アプリのアイコン素材を生成します。手作業での画像編集ではなく、決定的なアイコンの書き出しが目的の場合は、このスキルを使用してください。

クイックスタート

  1. 入力画像のパスを確認します。
  2. python3 scripts/icon_generator.py <input-image> -o <output-dir> を実行します。
  3. 生成された android/ および ios/AppIcon.appiconset/ フォルダーを確認します。

必要に応じて、まず Pillow をインストールしてください。

python3 -m pip install 'Pillow>=10.0.0'

ワークフロー

出力方法を選択する
  • ロゴ全体を表示し、余白を許容できる場合は、デフォルトの contain モードを使用します。
  • アイコン全体を正方形に収め、中央でのトリミングを許容できる場合は、cover を使用します。
  • 正方形でないソース画像の余白の色を指定するには、--background を使用します。
  • 書き出すアイコンにあらかじめ角丸を適用するには、--corner-radius を使用します。
  • Android および iOS の組み込みサイズ以外の正方形 PNG も必要な場合は、--extra-sizes を使用します。
  • Android のアダプティブアイコンリソースが明示的に必要な場合は、--android-adaptive を使用します。
スクリプトを実行する

基本的な書き出し：

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

トリミング、白い余白、追加サイズ、角丸を適用して書き出す：

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

Android のアダプティブアイコンも書き出す：

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

結果を検証する

  • ランチャー用 PNG は android/mipmap-* で確認します。
  • 512px のストア用素材は android/play-store/play_store_icon.png で確認します。
  • ios/AppIcon.appiconset/Contents.json と、生成された PNG ファイルを確認します。
  • アダプティブアイコンが必要な場合は、XML ファイルと ic_launcher_foreground.png ／ ic_launcher_background.png が android/mipmap-anydpi-v26/ にあることを確認します。

トラブルシューティング

  • スクリプトが Pillow のインポートエラーで終了した場合は、Pillow をインストールして再実行します。
  • 色を解析できない場合は、#RRGGBB または #RRGGBBAA を指定します。
  • ソース画像が見つからない場合は、再生成する前に処理を中止してパスを確認します。
  • 正方形でない出力や、手作業で細かく調整するレタッチが必要な場合、このスキルは適していません。代わりに画像編集のワークフローを使用してください。

リソース

  • 実際の書き出しには scripts/icon_generator.py を使用します。
  • 引数の詳細、サイズ一覧、出力構成については references/usage.md を参照してください。

コメント

Markdown 対応