Cassiiopeia/projectops / skills/pro-image
pro-image
VerifiedMake image assets (backgrounds, characters, icons, illustrations, items) that fit the project's own style: you write the prompt from a per-repo harness, Codex or Antigravity draws it, the CLI fixes size and transparency. Use for 'make an image', 'draw', 'generate an icon'.
scripts/pro_image/converter.py
View on GitHub"""Format conversion and size fitting: conversion via Pillow > sips (macOS) > ImageMagick, size via Pillow > stdlib
2 fit modes: cover keeps ratio then center-crops the overflow, contain keeps ratio with transparent padding
"""
from __future__ import annotations
import shutil
import subprocess
from pathlib import Path
from . import png_codec, resample
def _pillow():
try:
from PIL import Image # noqa: PLC0415 — optional dependency
except ImportError:
return None
return Image
def available_tool() -> str:
"""Converter for JPEG/WebP (stdlib is enough for PNG only)"""
if _pillow():
return "pillow"
if shutil.which("sips"):
return "sips"
return "magick" if shutil.which("magick") else "stdlib-png-only"
def _run(command: list[str]) -> None:
completed = subprocess.run(command, capture_output=True, encoding="utf-8", errors="replace", timeout=120)
if completed.returncode != 0:
raise RuntimeError((completed.stderr or completed.stdout or "conversion failed").strip()[-400:])
def to_png(source: Path, target: Path) -> str:
"""Any format > 8-bit RGBA PNG > name of tool used"""
image_module = _pillow()
if image_module:
with image_module.open(source) as image:
image.convert("RGBA").save(target, "PNG")
return "pillow"
if shutil.which("sips"):
_run(["sips", "-s", "format", "png", str(source), "--out", str(target)])
return "sips"
if shutil.which("magick"):
_run(["magick", str(source), "-depth", "8", f"PNG32:{target}"])
return "magick"
raise RuntimeError("no converter: install Pillow (pip install pillow) or ImageMagick")
def _cover_box(source_size: tuple[int, int], target_size: tuple[int, int]) -> tuple[int, int]:
scale = max(target_size[0] / source_size[0], target_size[1] / source_size[1])
return round(source_size[0] * scale), round(source_size[1] * scale)
def fit(source: Path, target: Path, size: tuple[int, int], mode: str) -> str:
"""Fit size > name of tool used"""
width, height = size
image_module = _pillow()
if image_module:
with image_module.open(source) as image:
image = image.convert("RGBA")
if mode == "cover":
resized = image.resize(_cover_box(image.size, size), image_module.LANCZOS)
left, top = (resized.width - width) // 2, (resized.height - height) // 2
resized.crop((left, top, left + width, top + height)).save(target, "PNG")
else:
image.thumbnail(size, image_module.LANCZOS)
canvas = image_module.new("RGBA", size, (0, 0, 0, 0))
canvas.paste(image, ((width - image.width) // 2, (height - image.height) // 2))
canvas.save(target, "PNG")
return "pillow"
return _fit_stdlib(source, target, size, mode)
def _fit_stdlib(source: Path, target: Path, size: tuple[int, int], mode: str) -> str:
"""Without Pillow: normalize to PNG then resize with stdlib (JPEG/WebP converted first via sips or ImageMagick)"""
png_source = source
if source.read_bytes()[:8] != png_codec.PNG_SIGNATURE:
png_source = target.with_name(target.stem + "_source.png")
to_png(source, png_source)
width, height, rgba = png_codec.read_rgba(png_source)
if mode == "cover":
box_width, box_height = _cover_box((width, height), size)
scaled = resample.resize(width, height, rgba, box_width, box_height)
left, top = (box_width - size[0]) // 2, (box_height - size[1]) // 2
png_codec.write_rgba(target, size[0], size[1], resample.crop(box_width, scaled, left, top, size[0], size[1]))
else:
scale = min(size[0] / width, size[1] / height)
fit_width, fit_height = max(1, round(width * scale)), max(1, round(height * scale))
scaled = resample.resize(width, height, rgba, fit_width, fit_height)
png_codec.write_rgba(target, size[0], size[1], resample.pad(fit_width, fit_height, scaled, size[0], size[1]))
return "stdlib"
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |