| name | image-compressor |
| description | 添付された複数の画像を一括で圧縮・リサイズするスキル。「画像を圧縮して」「このスクショを軽くして」「リサイズして」「画像を小さくして」などのリクエストで使用する。Pillowで長辺1920pxにリサイズし、JPEG/PNGで出力先ディレクトリに保存する。 |
| license | MIT |
| author | shohei |
| version | 1.0.0 |
画像圧縮・リサイズ
添付された画像を一括で圧縮・リサイズして出力先ディレクトリに保存するスキル。
実行手順
- ユーザーが添付した画像パスを収集する
- ユーザーの指示から出力フォーマット（
jpg / png）、長辺サイズ、品質などの指定を抽出する
- 以下のコマンドを実行する
基本（元の拡張子を維持、長辺1920px）:
python .claude/skills/image-compressor/scripts/compress_images.py "画像1" "画像2" "画像3"
JPGで出力:
python .claude/skills/image-compressor/scripts/compress_images.py "画像1" "画像2" --format jpg
PNGで出力、長辺1280px、品質90:
python .claude/skills/image-compressor/scripts/compress_images.py "画像1" --format png --max-size 1280 --quality 90
- 出力パスと圧縮結果をユーザーに報告する
引数
| 引数 | 説明 | デフォルト |
|---|
images | 入力画像パス（可変長・必須） | — |
--format | 出力フォーマット（jpg / png） | 元の拡張子を維持 |
--max-size | 長辺の最大ピクセル数 | 1920 |
--quality | JPEG品質（1-100） | 85 |
設定
プロジェクトルートの .env に以下の環境変数を設定する（任意。未設定時はデフォルト値を使用）:
IMAGE_COMPRESS_OUTPUT_PATH=images/compressed
| 変数名 | 説明 |
|---|
IMAGE_COMPRESS_OUTPUT_PATH | 出力先ディレクトリ（デフォルト: images/compressed） |
出力
- ファイル名: 元ファイル名をそのまま使う（
photo.jpg → photo.jpg）。同名ファイルが既に存在する場合のみ _1, _2 … と連番を付与
- 保存先: プロジェクトルートの
images/compressed/
- JPEG出力時、RGBA画像は白背景で合成してRGBに変換する
- 長辺が
--max-size 未満の場合はリサイズせず圧縮のみ行う
依存パッケージ確認
初回エラー時は以下でインストール:
pip install pillow python-dotenv
