Communitygithub.com

ZJU-REAL/Easel

Procesamiento general de imágenes: cambiar tamaño/escalar, recortar, rellenar bordes para adaptar a dimensiones de plataformas, convertir formato (png/jpg/webp), comprimir a un tamaño objetivo, añadir marcas de agua (texto o imagen), esquinas redondeadas, collage de múltiples imágenes, generar miniaturas y leer información de la imagen. Basado en el procesamiento determinista de image_ops.py.

¿Qué es Easel?

Este skill, denominado Easel (originalmente ZJU-REAL/Easel), proporciona un conjunto completo de herramientas para el procesamiento determinista de imágenes existentes, sin depender de scripts improvisados. Está diseñado para agentes de IA que necesitan modificar imágenes de forma predecible, realizando operaciones como redimensionar, recortar, rellenar bordes para adaptarse a dimensiones específicas de plataformas (como Xiaohongshu, WeChat, Weibo, Douyin), convertir formatos (png/jpg/webp), comprimir para alcanzar un tamaño máximo de archivo, añadir marcas de agua (texto o imagen) con control de posición y opacidad, aplicar esquinas redondeadas (incluso círculos), crear collages en cuadrícula o disposición horizontal/vertical, generar miniaturas y extraer metadatos de la imagen. Se ejecuta exclusivamente mediante el script `skills/shared/scripts/image_ops.py` (basado en la biblioteca Pillow), garantizando consistencia en los resultados. Es especialmente útil para agentes en plataformas como Claude Code, Cursor o Codex, donde se requiere un procesamiento fiable y repetible de imágenes. Se diferencia claramente de los skills de tipo *card-* (que generan nuevas imágenes a partir de HTML) al operar únicamente sobre archivos de imagen ya existentes, sin realizar diseño visual ni generación de contenido.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Procesamiento de imágenes

Procesamiento determinista de imágenes existentes: escalar/recortar/rellenar bordes/convertir formato/comprimir/marca de agua/esquinas redondeadas/collage/miniatura. Todas las operaciones se realizan a través de skills/shared/scripts/image_ops.py (Pillow puro), sin scripts improvisados.

Entrada

  • Una o más rutas de archivos de imagen existentes (formatos compatibles con Pillow: png, jpg, webp, etc.)
  • Operación y parámetros objetivo (dimensiones, proporción, calidad, texto de marca de agua, modo de collage, etc.)

Salida

  • Archivo(s) de imagen procesado(s) (ruta especificada por el usuario o por defecto en outputs/nombre_del_tema/)
  • Cada comando muestra ✅ ruta (ancho x alto, tamaño KB); el comando info devuelve JSON

Límites (diferenciación con card-*)

  • card-quote / card-xiaohongshu / poster-hero / comparison-card = diseñar y renderizar una nueva imagen (HTML → captura)
  • image-editing = procesar una imagen existente, sin diseño visual, sin generar contenido, solo procesamiento a nivel de píxeles
  • Si se necesita "generar una imagen a partir de datos/texto" → usar chart/infographic/card-*; este SKILL solo procesa archivos de imagen ya existentes

Pasos de ejecución

  1. Confirmar que la imagen de entrada existe y definir claramente la operación y los parámetros
  2. Ejecutar el subcomando correspondiente de image_ops.py desde la raíz del proyecto (ver más abajo)
  3. Si se necesitan dimensiones de plataforma, consultar references/platform-sizes.md para obtener la proporción/píxeles recomendados
  4. Informar la ruta de salida y las dimensiones; las operaciones múltiples se pueden encadenar (por ejemplo, redimensionar y luego comprimir)

Referencia rápida de comandos

La ruta del script es siempre skills/shared/scripts/image_ops.py. Todos los subcomandos admiten -h para ver los parámetros.

# Redimensionar: por ancho/alto/porcentaje; --keep-ratio mantiene la proporción sin estirar dentro del marco
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

# Recortar: por coordenadas o recorte centrado a dimensiones específicas
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

# Rellenar bordes hasta una proporción objetivo (esencial para redes sociales): convierte cualquier imagen a 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"

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

# Comprimir: calidad fija o acercarse a un tamaño máximo de archivo (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

# Marca de agua: texto (posición/transparencia/tamaño/color, busca automáticamente fuentes chinas) o imagen (esquina inferior derecha, etc.)
python skills/shared/scripts/image_ops.py watermark -i in.jpg -o out.png --text "@nombre_usuario" --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

# Esquinas redondeadas (genera png transparente); --radius-percent 50 produce un círculo
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 de varias imágenes: horizontal/vertical/cuadrícula NxM (columnas x filas), --cell-width/height para celdas 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

# Miniatura (píxel del lado más largo)
python skills/shared/scripts/image_ops.py thumbnail -i in.jpg -o thumb.jpg --size 256

# Leer información de la imagen (json: dimensiones/formato/proporción/tamaño/canal alfa)
python skills/shared/scripts/image_ops.py info -i in.jpg

Conocimiento del dominio: Dimensiones recomendadas por plataforma

Las recomendaciones comunes se encuentran en references/platform-sizes.md. Recordatorio rápido de alta frecuencia:

  • Xiaohongshu vertical imagen+texto: 1080×1440 (3:4); Xiaohongshu video/póster vertical: 1080×1920 (9:16)
  • WeChat Moments imagen única / imagen cuadrada genérica: 1:1 (por ejemplo, 1080×1080)
  • Frase destacada horizontal/portada: 16:9 (por ejemplo, 1920×1080); imagen de cabecera de cuenta oficial de WeChat: 900×383
  • Weibo imagen adjunta: 1:1 o 4:3; Douyin/portada de video: 9:16 (1080×1920)

Enfoque de adaptación: priorizar pad (rellenar bordes sin recortar contenido ni deformar) para preservar la imagen completa; si se busca una imagen sin bordes, usar crop centrado para recortar a la proporción objetivo; solo para reducir tamaño usar resize/compress.

Conocimiento del perfil

  • Si hay perfil: el texto de la marca de agua usa por defecto el nombre de usuario/handle; la proporción de salida se ajusta por defecto a la plataforma principal (por ejemplo, para cuentas de Xiaohongshu, por defecto 1080×1440)
  • Si no hay perfil: se ejecuta según los parámetros explícitos del usuario; la proporción se mantiene igual que la original; la marca de agua requiere que el usuario proporcione el texto

Dependencias y manejo de errores

  • Dependencia: Pillow (ya instalado, python -c "import PIL" funciona), solo biblioteca estándar sin otros terceros
  • El script incluye comprobación de límites: archivo no encontrado / recorte fuera de rango / proporción o color no válido → código de salida 2 e imprime ERROR:
  • Si no se encuentra una fuente china, se degrada a la fuente predeterminada de PIL y muestra WARN; se puede especificar con --font
  • Autocomprobación: 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 relacionados