tuzi-compress-image について
画像ファイルやディレクトリを圧縮するコマンドラインスキルです。sips、cwebp、ImageMagick、Sharp から利用可能なツールを選び、出力形式や品質、再帰処理、元画像の保持を指定できます。
主な機能
- 01画像ファイルとディレクトリの圧縮
- 02利用可能な圧縮ツールの選択
- 03出力形式と品質の指定
- 04サブディレクトリの再帰処理
- 05EXTEND.md による既定値の設定
活用シーン
- 01画像を WebP に変換
- 02画像ディレクトリを圧縮
- 03元画像を残して圧縮コピーを作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/tuzi-compress-imageを入力して読み込まれたか確認します。
同梱ファイルscripts/main.ts
詳細
画像圧縮ツール
利用可能な最適なツール（sips → cwebp → ImageMagick → Sharp）を使用して画像を圧縮します。
スクリプトディレクトリ
スクリプトは scripts/ サブディレクトリにあります。${SKILL_DIR} を、この SKILL.md があるディレクトリのパスに置き換えてください。
| スクリプト | 用途 |
|---|---|
scripts/main.ts | 画像圧縮 CLI |
設定（EXTEND.md）
優先順位に従い、Bash を使用して EXTEND.md が存在するか確認します。
# Check project-level first
test -f .tuzi-skills/tuzi-compress-image/EXTEND.md && echo "project"
# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md" && echo "user"
┌────────────────────────────────────────────────────────┬───────────────────┐ │ パス │ 場所 │ ├────────────────────────────────────────────────────────┼───────────────────┤ │ .tuzi-skills/tuzi-compress-image/EXTEND.md │ プロジェクトディレクトリ │ ├────────────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.tuzi-skills/tuzi-compress-image/EXTEND.md │ ユーザーホーム │ └────────────────────────────────────────────────────────┴───────────────────┘
┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ 結果 │ 操作 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 見つかった │ 読み込み、解析し、設定を適用 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 見つからない │ デフォルトを使用 │ └───────────┴───────────────────────────────────────────────────────────────────────────┘
EXTEND.md がサポートする設定：デフォルト形式｜デフォルト品質｜元ファイルを保持する設定
使用方法
npx -y bun ${SKILL_DIR}/scripts/main.ts <input> [options]
オプション
| オプション | 短縮形 | 説明 | デフォルト |
|---|---|---|---|
<input> | ファイルまたはディレクトリ | 必須 | |
--output | -o | 出力先のパス | 同じパス、新しい拡張子 |
--format | -f | webp、png、jpeg | webp |
--quality | -q | 品質 0～100 | 80 |
--keep | -k | 元ファイルを保持 | false |
--recursive | -r | サブディレクトリを処理 | false |
--json | JSON 出力 | false |
使用例
# Single file → WebP (replaces original)
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png
# Keep PNG format
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png -f png --keep
# Directory recursive
npx -y bun ${SKILL_DIR}/scripts/main.ts ./images/ -r -q 75
# JSON output
npx -y bun ${SKILL_DIR}/scripts/main.ts image.png --json
出力：
image.png → image.webp (245KB → 89KB, 64% reduction)
拡張機能のサポート
EXTEND.md を使用してカスタム設定ができます。パスとサポートされるオプションについては、設定セクションをご覧ください。