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 comandoinfodevuelve 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
- Confirmar que la imagen de entrada existe y definir claramente la operación y los parámetros
- Ejecutar el subcomando correspondiente de
image_ops.pydesde la raíz del proyecto (ver más abajo) - Si se necesitan dimensiones de plataforma, consultar
references/platform-sizes.mdpara obtener la proporción/píxeles recomendados - 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