Communitygithub.com

画像処理加工(Easel)

既存画像のサイズ変更・トリミング・パディング・フォーマット変換・圧縮・透かし追加・角丸・結合・サムネイル生成・情報取得を、Pillow ベースの確定処理で実行します。

画像処理加工(Easel) とは?

このスキルは、既存の画像ファイルに対して確定論理(Pillow ライブラリ)を用いた様々な画像処理を実行します。対応操作は、リサイズ・クロップ・パディング(アスペクト比に合わせて余白追加)・フォーマット変換(PNG/JPG/WEBP)・画質を指定した圧縮(最大ファイルサイズ指定も可能)・文字や画像の透かし追加・角丸(円形も可)・複数画像の結合(横並び・縦並び・グリッド)・サムネイル生成・画像情報取得(サイズ・形式・比率・ファイルサイズ・アルファチャンネルの有無など)です。すべての処理は `skills/shared/scripts/image_ops.py` という単一のスクリプトを介して行われ、各サブコマンド(resize / crop / pad / convert / compress / watermark / round / collage / thumbnail / info)とパラメータを指定します。スクリプトはプロジェクトルートから実行します。このスキルは「card-*」系(HTML デザイン→レンダリング)とは明確に区別され、すでに存在する画像ファイルのみを加工し、視覚デザインやコンテンツ生成は行いません。特に、パディング機能は X(旧Twitter)・小红书・微信などのソーシャルメディア推奨サイズへの変換に便利で、`references/platform-sizes.md` から取得したアスペクト比を指定できます。プロファイルが設定されている場合は、透かし文字や出力アスペクト比をプロファイルのアカウント名やメインプラットフォームに自動調整します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ZJU-REAL/Easel/tree/HEAD/skills/openclaw/image-editing

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

画像処理加工

既存画像に対して確定処理を行います:リサイズ/クロップ/パディング/フォーマット変換/圧縮/透かし/角丸/結合/サムネイル生成。 すべての操作は skills/shared/scripts/image_ops.py(純粋な Pillow)を経由し、即興でスクリプトを書くことはありません。

入力

  • 1 枚または複数の、すでに存在する画像ファイルのパス(PNG/JPG/WebP など Pillow がサポートする形式)
  • 目標とする操作とパラメータ(サイズ、比率、品質、透かしテキスト、結合方法など)

出力

  • 処理後の画像ファイル(パスはユーザーが指定するか、デフォルトで outputs/テーマ名/ に出力)
  • 各コマンドは ✅ パス (幅x高さ, サイズKB) を表示;info は JSON を出力

境界線(card-* との明確な区別)

  • card-quote / card-xiaohongshu / poster-hero / comparison-card = デザインして新しい画像をレンダリング(HTML→スクリーンショット)
  • image-editing = 既存画像を加工。ビジュアルデザインは行わず、コンテンツ生成もせず、ピクセルレベルの処理のみ実施
  • 「データやテキストから画像を生成する」必要がある場合 → chart / infographic / card-* を使用。このスキルは既存の画像ファイルのみ扱います

実行手順

  1. 入力画像が存在することを確認し、目標操作とパラメータを明確にする
  2. プロジェクトルートから image_ops.py の対応サブコマンドを実行(下記参照)
  3. プラットフォームサイズが必要な場合、references/platform-sizes.md で推奨アスペクト比/ピクセルを確認する
  4. 出力パスとサイズを報告する。複数の操作を連続して実行可能(例:リサイズ後に圧縮)

コマンド一覧

スクリプトパスは固定で skills/shared/scripts/image_ops.py。すべてのサブコマンドで -h によりパラメータを確認できます。

# リサイズ:幅/高さ/パーセント指定、--keep-ratio でアスペクト比保持
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --percent 50
python skills/shared/scripts/image_ops.py resize -i in.jpg -o out.jpg --width 1080 --height 1440 --keep-ratio

# クロップ:座標指定 または 中央クロップで指定サイズに
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --box 100,50,900,650
python skills/shared/scripts/image_ops.py crop -i in.jpg -o out.jpg --width 1080 --height 1080

# パディング(ソーシャルメディア適応の中核):任意の画像を 1:1 / 9:16 / 16:9 にパディング
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 9:16 --background "#ffffff"
python skills/shared/scripts/image_ops.py pad -i in.jpg -o out.png --ratio 1:1 --background "20,20,30"

# フォーマット変換 png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85

# 圧縮:品質指定 または 目標ファイルサイズ上限に近づける(jpg/webp)
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --quality 80
python skills/shared/scripts/image_ops.py compress -i in.jpg -o out.jpg --max-kb 200

# 透かし:テキスト(位置・透明度・フォントサイズ・色、自動でシステムの中華フォントを検索)または画像(右下など)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@アカウント名" --position bottom-right --opacity 0.5 --size 40
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --image logo.png --position bottom-right --scale 0.3 --opacity 0.8

# 角丸(透明PNG出力);--radius-percent 50 で円形
python skills/shared/scripts/image_ops.py round -i in.jpg -o out.png --radius 60
python skills/shared/scripts/image_ops.py round -i avatar.jpg -o out.png --radius-percent 50

# 複数画像の結合:横並び/縦並び/グリッド NxM(列x行)、--cell-width/height でセルサイズ統一
python skills/shared/scripts/image_ops.py collage -i a.jpg b.jpg c.jpg -o out.jpg --mode horizontal --gap 12
python skills/shared/scripts/image_ops.py collage -i 1.jpg 2.jpg 3.jpg 4.jpg -o out.jpg --grid 2x2 --gap 10 --cell-width 540 --cell-height 540

# サムネイル(最長辺ピクセル指定)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256

# 画像情報取得(JSON:サイズ/形式/アスペクト比/ファイルサイズ/アルファチャンネル)
python skills/shared/scripts/image_ops.py info -i in.jpg

ドメイン知識:プラットフォーム推奨サイズ

一般的なプラットフォームの推奨サイズは references/platform-sizes.md にあります。頻出の覚え書き:

  • 小红书(小紅書)縦型図文:1080×1440(3:4);小红书動画/縦型ポスター:1080×1920(9:16)
  • WeChat(微信)朋友圈単画像 / 汎用正方形:1:1(例 1080×1080)
  • 横型名言/カバー:16:9(例 1920×1080);WeChat 公式アカウントヘッダー 900×383
  • Weibo(微博)添付画像:1:1 または 4:3;Douyin(抖音)/ 微信视频号カバー:9:16(1080×1920)

適応の考え方:優先して pad(余白を追加、画像を切らず変形しない)で画を保全;全面にしたい場合は crop で中央を目標アスペクト比にクロップ;単にファイルサイズを小さくしたい場合は resize / compress を使用。

プロファイル対応

  • プロファイルあり:透かしテキストはデフォルトでアカウント名/ハンドルに;出力アスペクト比はデフォルトでメインプラットフォームに合わせる(例:小红书アカウントのデフォルトは 1080×1440)
  • プロファイルなし:ユーザーが明示的に指定したパラメータで実行。出力アスペクト比はデフォルトで元画像を保持、透かしはユーザーがテキストを指定する必要あり

依存関係とエラーハンドリング

  • 依存:Pillow(インストール済み、python -c "import PIL" で確認可)、純粋な標準ライブラリ、その他サードパーティなし
  • スクリプト内蔵の境界チェック:ファイルが存在しない/クロップ枠が画像範囲を超える/不正なアスペクト比や色 → 終了コード 2 で ERROR: を表示
  • システムに中国語フォントがない場合、PIL のデフォルトフォントにフォールバックし WARN を表示。--font でフォントを指定可能
  • 自己診断:python skills/shared/scripts/image_ops.py --selftest

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

ZJU-REAL/Easel

AI 视频生成:文生视频 / 图生视频 / 数字人首帧驱动。通过可插拔 provider(通义万相 Wan / 火山 Seedance / 快手可灵 / OpenAI 兼容)异步生成视频,用户自备 API key。当用户说 AI 视频生成、文生视频、图生视频、AI 生成视频、AI 短视频、让图片动起来、数字人视频、生成一段视频 时使用。与 video-strategy(选型/策略)、video-editing(剪辑处理)、clipify(切片)区别:本 SKILL 是从 0 用 AI 生成新视频。

ZJU-REAL/Easel

通用音频处理:音频剪辑/裁剪、格式转码(mp3/wav/m4a/aac)、音量归一化、从视频提取音轨、多段拼接、淡入淡出、变速(保音高)。当用户说“剪音频”“裁一段”“转成 mp3”“调音量/响度”“提取音轨/扒音频”“拼接音频”“淡入淡出”“加速/减速音频”“变速不变调”时使用。与 audio-denoise 的区别:audio-denoise 专做降噪,audio-editing 做除降噪外的通用音频操作(也内置 denoise 作为兜底)。

ZJU-REAL/Easel

一句话主题 → 成品短视频:自动串联 文案→配图/AI视频→配音→字幕→BGM→合成,把 Easel 制作层零件编排成一条'一键出片'流水线。**单条视频、口播/资讯向,画面默认逐句配图 + Ken Burns 缓动,需要动态时才逐段图生视频**。当用户说 一键生成视频、自动做短视频、主题生成视频、帮我做条视频、口播视频一条龙、自动出片、短视频一键生成 时使用。**有剧情/角色/对白/反转/多集的短剧改用 short-drama(每镜强制图生视频、不用静态图冒充);只写脚本用 video-script;只生成单个片段用 ai-video-gen。**

ZJU-REAL/Easel

自动字幕 / 语音转字幕:把音频或视频里的语音识别成字幕文件(SRT/ASS/TXT/JSON),可选把字幕烧录进视频。当用户说自动字幕、语音转字幕、视频加字幕、上字幕、转录、听写、字幕文件、生成字幕、烧字幕时使用。

ZJU-REAL/Easel

音乐卡点视频 / 踩点视频:检测背景音乐的节拍,让图片或片段在节拍点上切换,配推进/白闪特效,做出燃系'卡点'短视频。当用户说 卡点视频、踩点视频、音乐卡点、节奏卡点、按音乐切换、鼓点视频、踩节奏、beat 卡点、图片卡点、卡点混剪 时使用。基于 shared/scripts/beatsync.py(librosa 节拍检测)。与 slideshow-video 区别:slideshow 每图固定时长、柔和转场,本 SKILL 切换点由音乐节拍决定、硬切踩点带特效。

ZJU-REAL/Easel

Easel clipify: long English talk → punchline cuts → optional 16:9→9:16 face-pan/split → opus word-by-word ASS burn. Ships scripts + assets/preview.png. Part of 1.6k★ Easel suite.

ZJU-REAL/Easel

多角色对话配音:按 cast 和逐行对白为不同角色分配音色与情绪,合成多声线音轨和带角色名字幕。 当用户说“多角色/双人/剧本/对话配音、多人对白、不同角色不同声音、有声剧配音”时使用。 单一公共音色用 tts-voiceover;克隆本人音色用 voice-clone;整部短剧制作由 short-drama 编排。

ZJU-REAL/Easel

Easel video-highlights: CN/livestream highlight extract + stable static vertical reframe (sibling to clipify).

ZJU-REAL/Easel

>- 视频制作策略与工具选型:AI 视频生成模型对比、视频脚本结构设计、制作流程规划,覆盖产品演示/解说/社媒短视频场景。 当用户说"视频怎么做""视频选型""用什么工具做视频""视频制作流程""视频策略""视频系列规划"时使用。 和 video-script 的区别:video-strategy 做内容规划与工具选型,video-script 写具体某条视频的脚本。

関連スキル