Skip to content

motiful/product-shots / skills/product-shots-image-gen

product-shots-image-gen

Verified

Unified image-generation engine for the product-shots ecosystem. Dispatches to the right model family (OpenAI gpt-image-2 / Gemini gemini-3-pro-image-preview Nano Banana Pro) with one parameterised script for text-to-image and image-to-image. Primary backend: OmniMaaS / Cloubic gateway (https://api.omnimaas.com/v1); also supports any OpenAI-SDK-compatible gateway via fallback env vars. Auto-resizes oversized reference images to prevent edge-proxy timeouts. Use when the user says "generate an image", "make a picture", "create a visual", "render this", "edit this image", "做一张图", "生成图片", "改这张图" — or when invoked as the image-generation backend by another product-shots skill (main-image / detail-page / ad-creative / social-post / multi-angle). NOT a creative-direction skill: takes a prompt + optional reference images, returns a file path.

FileKindSize
SKILL.mdskill md16.7 KB
references/error-handling.mdmarkdown5.8 KB
references/model-selection.mdmarkdown6.5 KB
references/parameter-spec.mdmarkdown7.8 KB
references/reference-image-handling.mdmarkdown4.0 KB
scripts/generate.pyexecutablescript15.3 KB
scripts/setup.shexecutablescript2.9 KB

scripts/setup.sh

View on GitHub
#!/usr/bin/env bash
# product-shots-image-gen — dependency installer.
#
# Detects Python 3 + pip, then installs the two runtime dependencies
# (requests, Pillow) if they are not already importable. Idempotent -
# safe to re-run.
#
# Usage:
#   bash scripts/setup.sh

set -euo pipefail

need_pip_install=false

# --- Python 3 ---
if ! command -v python3 > /dev/null 2>&1; then
    echo "ERROR: python3 not found in PATH. Install Python 3.9+ first." >&2
    exit 1
fi
PYV=$(python3 -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")')
echo "[image-gen] python3 found: $PYV"

# --- pip ---
if ! python3 -m pip --version > /dev/null 2>&1; then
    echo "ERROR: pip not available for python3. Try: python3 -m ensurepip --upgrade" >&2
    exit 1
fi

# --- requests ---
if python3 -c 'import requests' 2>/dev/null; then
    REQV=$(python3 -c 'import requests; print(requests.__version__)')
    echo "[image-gen] requests already installed: $REQV"
else
    echo "[image-gen] installing requests..."
    python3 -m pip install --quiet 'requests>=2.28'
    need_pip_install=true
fi

# --- Pillow ---
if python3 -c 'from PIL import Image' 2>/dev/null; then
    PILV=$(python3 -c 'from PIL import Image; print(Image.__version__)')
    echo "[image-gen] Pillow already installed: $PILV"
else
    echo "[image-gen] installing Pillow..."
    python3 -m pip install --quiet 'Pillow>=10.0'
    need_pip_install=true
fi

# --- API key + base URL reminders ---
if [ -z "${OMNIMAAS_API_KEY:-}" ] \
   && [ -z "${PRODUCT_SHOTS_IMAGEGEN_API_KEY:-}" ] \
   && [ -z "${RENDER_API_KEY:-}" ] \
   && [ -z "${CANVASFLOW_IMAGEGEN_API_KEY:-}" ] \
   && [ ! -f "$HOME/.product_shots_imagegen_api_key" ] \
   && [ ! -f "$HOME/.product_shots_render_api_key" ] \
   && [ ! -f "$HOME/.canvasflow_imagegen_api_key" ]; then
    echo ""
    echo "WARNING: No API key found for the image gateway."
    echo "  Preferred:"
    echo "    export OMNIMAAS_API_KEY='your-omnimaas-token'"
    echo "  Generic (any OpenAI-SDK-compatible gateway):"
    echo "    export PRODUCT_SHOTS_IMAGEGEN_API_KEY='your-token'"
    echo "  Or write the key to a chmod-600 file:"
    echo "    echo 'your-token' > ~/.product_shots_imagegen_api_key && chmod 600 ~/.product_shots_imagegen_api_key"
fi

if [ -z "${OMNIMAAS_BASE_URL:-}" ] \
   && [ -z "${PRODUCT_SHOTS_IMAGEGEN_BASE_URL:-}" ] \
   && [ -z "${RENDER_BASE_URL:-}" ] \
   && [ -z "${CANVASFLOW_IMAGEGEN_BASE_URL:-}" ] \
   && [ -z "${OMNIMAAS_API_KEY:-}" ]; then
    echo ""
    echo "WARNING: No base URL configured."
    echo "  When OMNIMAAS_API_KEY is set, the script defaults to https://api.omnimaas.com/v1."
    echo "  Otherwise set one of:"
    echo "    export OMNIMAAS_BASE_URL='https://api.omnimaas.com/v1'"
    echo "    export PRODUCT_SHOTS_IMAGEGEN_BASE_URL='https://your-gateway/v1'"
fi

echo ""
if $need_pip_install; then
    echo "[image-gen] setup complete. Dependencies installed."
else
    echo "[image-gen] setup complete. All dependencies already present."
fi
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: 472kUpdated Claude CodeCodexUnverifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall