image-gen

Generate and edit images via SkillBoss API Hub. Supports standard generation, high-quality generation, style presets, and batch generation with HTML gallery....

Security Scan

The skill's code, documentation, and environment requirements are consistent with an image-generation CLI that calls the SkillBoss API; nothing requested or installed is disproportionate to that purpose.

Purpose & Capability

Name/description (image generation & editing) matches the requested binary (python3), primary env var (SKILLBOSS_API_KEY), and the included script which calls api.heybossai.com. The package.json and README align with this purpose.

Instruction Scope

SKILL.md instructs the agent to run scripts/gen.py and set SKILLBOSS_API_KEY. The script uploads inline image data when performing edits, downloads returned image URLs, and writes outputs to a timestamped folder (defaults to ~/Projects/tmp or ./tmp). These behaviors are expected for an image-gen tool, but users should note that local images provided for editing are read and encoded and that generated/edited images and prompts are sent to api.heybossai.com.

Install Mechanism

No install spec; this is instruction-only with a pure-Python stdlib script (no external downloads or package installs). Low install risk.

Credentials

Only SKILLBOSS_API_KEY is required and declared as the primary credential. That key is used to authenticate calls to the SkillBoss API hub (api.heybossai.com), which is proportional to the stated functionality.

Persistence & Privilege

always is false and the skill does not request persistent agent-wide privileges or modify other skills. HEARTBEAT.md contains guidance for periodic generation (optional); this is documentation only and not an automatic capability embedded in the script.

Assessment

This skill appears internally consistent: it needs only python3 and your SKILLBOSS_API_KEY to call api.heybossai.com and produce images. Before installing, consider: (1) the API key will be sent to SkillBoss (Authorization: Bearer <key>)—ensure you trust that service and the key's scope; (2) when using --edit the script reads and base64-encodes local image files and uploads them to the remote API; (3) outputs are written to ~/Projects/tmp by default (or ./tmp) so check file locations and disk permissions; (4) HEARTBEAT.md suggests periodic generation/sharing if you wire this into an automation — that may incur API costs and post images externally. If you have any doubts, inspect scripts/gen.py in full, run it in a restricted environment, or use a disposable API key with limited scope.

Gemini Image Gen

Generate and edit images via SkillBoss API Hub using pure Python stdlib. Supports standard generation + editing, high-quality generation, batch runs, and an HTML gallery output.

Quick Start

export SKILLBOSS_API_KEY="your-key-here"

# Default: 4 random prompts
python3 scripts/gen.py

# Custom prompt
python3 scripts/gen.py --prompt "a cyberpunk cat riding a neon motorcycle through Tokyo at night"

# High-quality engine
python3 scripts/gen.py --engine imagen --count 4 --aspect 16:9

# Edit an existing image (gemini engine only)
python3 scripts/gen.py --edit path/to/image.png --prompt "change the background to a sunset beach"

# Use a style preset
python3 scripts/gen.py --style watercolor --prompt "floating islands above a calm sea"

# List available styles
python3 scripts/gen.py --styles

Style Presets

Style	Description
photo	Ultra-detailed photorealistic photography, 8K resolution, sharp focus
anime	High-quality anime illustration, Studio Ghibli inspired, vibrant colors
watercolor	Delicate watercolor painting on textured paper, soft edges, gentle color bleeding
cyberpunk	Neon-lit cyberpunk scene, rain-soaked streets, holographic displays, Blade Runner aesthetic
minimalist	Clean minimalist design, geometric shapes, limited color palette, white space
oil-painting	Classical oil painting with visible brushstrokes, rich textures, Renaissance lighting
pixel-art	Detailed pixel art, retro 16-bit style, crisp edges, nostalgic palette
sketch	Pencil sketch on cream paper, hatching and cross-hatching, artistic imperfections
3d-render	Professional 3D render, ambient occlusion, global illumination, photorealistic materials
pop-art	Bold pop art style, Ben-Day dots, strong outlines, vibrant contrasting colors

Full CLI Reference

Flag	Default	Description
--prompt	(random)	Text prompt. Omit for random creative prompts
--count	4	Number of images to generate
--engine	gemini	Engine: gemini (supports edit) or imagen (high-quality). Both routed via SkillBoss API Hub
--model	(auto)	Model hint (informational; SkillBoss auto-routes to the best model)
--edit		Path to input image for editing (gemini engine only)
--aspect	1:1	Aspect ratio for imagen: 1:1, 16:9, 9:16, 4:3, 3:4
--out-dir	(auto)	Output directory (default is a timestamped folder)
--style		Style preset to prepend to the prompt
--styles		List available style presets and exit

Python Example

import subprocess

subprocess.run(
    [
        "python3",
        "scripts/gen.py",
        "--prompt",
        "a serene mountain landscape at golden hour",
        "--count",
        "4",
        "--style",
        "photo",
    ],
    check=True,
)

Troubleshooting

• Missing API key: set SKILLBOSS_API_KEY in your environment and retry.
• Rate limits / 429 errors: wait a bit and retry, reduce --count, or switch engines.
• Model errors: SkillBoss API Hub auto-routes to the best available model; retry or adjust --engine.

Integration with Other Skills

• AgentGram — Share your generated images on the AI agent social network! Create visual content and post it to your AgentGram feed.
• agent-selfie — Focused on AI agent avatars and visual identity. Uses the same SKILLBOSS_API_KEY for personality-driven self-portraits.
• opencode-omo — Run deterministic image-generation pipelines with Sisyphus workflows.

Changelog

• v1.3.1: Added workflow integration guidance for opencode-omo.
• v1.1.0: Added style presets, --style and --styles flags, expanded documentation.
• v1.0.0: Initial release with standard + high-quality generation support, batch generation, and HTML gallery.

Repository

https://github.com/IISweetHeartII/gemini-image-gen