Communitygithub.com

ZJU-REAL/Easel

Traitement d'image générique : redimensionnement, recadrage, rembourrage, conversion de format, compression, ajout de filigrane, coins arrondis, collage, création de vignettes et lecture d'informations. Basé sur le script déterministe image_ops.py.

Qu'est-ce que Easel ?

Easel est une compétence spécialisée dans le traitement déterministe d'images existantes, sans génération de contenu visuel. Elle repose sur un script Python unique (`image_ops.py`) utilisant la bibliothèque Pillow, garantissant des résultats reproductibles et fiables. La compétence prend en charge une large gamme d'opérations : redimensionnement (par dimensions exactes, pourcentage ou avec conservation du ratio), recadrage (par boîte ou centré), remplissage pour adapter à des ratios spécifiques (1:1, 9:16, etc.), conversion entre les formats PNG/JPG/WEBP, compression avec qualité cible ou limite de taille, ajout de filigrane textuel ou par image, arrondi des coins (jusqu'au cercle complet), collage multi-images (horizontal, vertical, grille), création de vignettes et extraction d'informations (dimensions, format, taille, transparence). L'utilisateur peut invoquer ces opérations via des commandes CLI standardisées, avec la possibilité de chaîner plusieurs traitements (par exemple, redimensionner puis compresser). La compétence est conçue pour s'intégrer harmonieusement avec les plateformes sociales : elle peut consulter le fichier `references/platform-sizes.md` pour les dimensions recommandées (comme 1080×1440 pour Xiaohongshu ou 1080×1080 pour WeChat Moments) et adapter l'image en priorité par `pad` (remplissage sans perte de contenu) ou par `crop` si un recadrage plein cadre est demandé. Si un profil utilisateur est disponible, elle utilise automatiquement le nom de compte pour le filigrane et les ratios par défaut de la plateforme principale. La compétence inclut une gestion robuste des erreurs (fichier manquant, boîte de recadrage invalide, police non trouvée) et propose un auto-test via `--selftest`.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Traitement d'image

Effectue un traitement déterministe sur des images existantes : redimensionnement/recadrage/rembourrage/conversion de format/compression/filigrane/coins arrondis/collage/vignettes. Toutes les opérations passent par skills/shared/scripts/image_ops.py (Pillow pur), pas de script improvisé.

Entrée

  • Un ou plusieurs chemins de fichiers image existants (png/jpg/webp et autres formats supportés par Pillow)
  • Opération cible et paramètres (dimensions, ratio, qualité, texte du filigrane, mode de collage, etc.)

Sortie

  • Fichier(s) image traité(s) (chemin spécifié par l'utilisateur ou par défaut dans outputs/nom_du_sujet/)
  • Chaque commande affiche ✅ chemin (largeur x hauteur, taille KB) ; info affiche du json

Limites (distinction claire avec les compétences card-*)

  • card-quote / card-xiaohongshu / poster-hero / comparison-card = conception et rendu de nouvelles images (HTML → capture d'écran)
  • image-editing = traitement d'images existantes, pas de conception visuelle, pas de génération de contenu, uniquement des manipulations au niveau pixel
  • Besoin de "générer une image à partir de données/texte" → utiliser chart/infographic/card-* ; cette compétence ne traite que des fichiers image prêts

Étapes d'exécution

  1. Vérifier que les images d'entrée existent, clarifier l'opération cible et les paramètres
  2. Exécuter la sous-commande correspondante de image_ops.py depuis la racine du projet (voir ci-dessous)
  3. Si nécessaire, consulter references/platform-sizes.md pour obtenir les ratios/pixels recommandés pour la plateforme
  4. Retourner le chemin de sortie et les dimensions ; les opérations multiples peuvent être chaînées (par ex. resize puis compress)

Référence rapide des commandes

Le chemin du script est toujours skills/shared/scripts/image_ops.py, toutes les commandes supportent -h pour voir les paramètres.

# Redimensionnement : par largeur/hauteur/pourcentage, --keep-ratio pour mise à l'échelle proportionnelle dans la boîte sans distorsion
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

# Recadrage : par boîte de coordonnées ou centré à des dimensions spécifiques
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

# Rembourrage pour atteindre un ratio cible (cœur de l'adaptation aux réseaux sociaux) : pad toute image en 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"

# Conversion de format png/jpg/webp
python skills/shared/scripts/image_ops.py convert -i in.png -o out.webp --format webp --quality 85

# Compression : qualité fixe ou approche de la taille de fichier maximale (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

# Filigrane : texte (position/opacité/taille/couleur, recherche automatique de police chinoise système) ou image (coin inférieur droit, etc.)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@nom_utilisateur" --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

# Coins arrondis (sortie png transparent) ; --radius-percent 50 donne un cercle
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

# Collage multi-image : horizontal/vertical/grille NxM (colonnes x lignes), --cell-width/height pour cellules uniformes
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

# Vignette (pixel du côté le plus long)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256

# Lecture des informations de l'image (json : dimensions/format/ratio/taille/canal alpha)
python skills/shared/scripts/image_ops.py info -i in.jpg

Connaissances du domaine : dimensions recommandées par plateforme

Les recommandations courantes pour les plateformes se trouvent dans references/platform-sizes.md. Aide-mémoire fréquent :

  • Xiaohongshu (小红书) portrait : 1080×1440 (3:4) ; Xiaohongshu vidéo/portrait poster : 1080×1920 (9:16)
  • WeChat Moments (朋友圈) image unique / carré générique : 1:1 (ex. 1080×1080)
  • Couverture horizontale / citation : 16:9 (ex. 1920×1080) ; en-tête compte officiel WeChat 900×383
  • Image associée Weibo : 1:1 ou 4:3 ; couverture Douyin/WeChat Channels : 9:16 (1080×1920)

Approche d'adaptation : privilégier pad (remplissage sans rogner le contenu, sans déformation) pour préserver l'image complète ; si une image pleine sans bordure est souhaitée, utiliser crop centré pour recadrer au ratio cible ; si seule une réduction de volume est nécessaire, utiliser resize/compress.

Sensibilité au profil

  • Avec profil : le texte du filigrane par défaut utilise le nom de compte/handle ; le ratio de sortie par défaut correspond à la plateforme principale de l'utilisateur (par ex. compte Xiaohongshu par défaut 1080×1440)
  • Sans profil : exécution selon les paramètres explicites de l'utilisateur, le ratio par défaut conserve celui de l'image d'origine, le filigrane nécessite que l'utilisateur fournisse le texte

Dépendances et gestion des erreurs

  • Dépendance : Pillow (déjà installé, python -c "import PIL" disponible), bibliothèque standard pure sans autre dépendance tierce
  • Vérifications intégrées dans le script : fichier inexistant / boîte de recadrage hors limites / ratio ou couleur invalide → code de sortie 2 et affichage de ERROR:
  • Si la police chinoise système n'est pas trouvée, dégradation vers la police par défaut de PIL avec WARN, possibilité d'utiliser --font pour spécifier
  • Auto-test : 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 写具体某条视频的脚本。

Skills associés