image-generation_skill

Overview

This skill generates, edits, upscales, and manages images using the Pictura unified provider API. It supports multiple aspect ratios, formats, and provider fallbacks to ensure reliable results. Use it for new image creation, iterative edits, and browsing or listing generated outputs.

How this skill works

The skill calls pictura_generate to create or modify images and returns exact absolute file paths for every generated asset. After generation, the skill instructs the agent to Read those file paths so images are displayed to the user. The skill only calls pictura_gallery or pictura_list when the user explicitly requests gallery browsing or a recent-image list.

When to use it

• Create new images in custom aspect ratios or multiple formats
• Request edits, variations, or upscales of previously generated images
• Generate social or marketing assets with provider fallback support
• List or browse recent generated images when explicitly asked
• Open an HTML gallery only when the user requests it

Best practices

• Always report exact absolute file paths returned by pictura_generate immediately after generation
• Use the Read tool on those paths so users can view the generated images
• Never automatically open the gallery or list — call pictura_gallery or pictura_list only on explicit user request
• For edits or variations, always use the last generated image as the reference with consistency: "reference" and ref: "<last-image-path>"
• Do not use reference mode when the user asks for a completely new concept or supplies a different reference image

Example use cases

• Generate a set of social media images for a coffee shop using the "social" preset and multiple ratios
• After a generation, ask for warmer lighting and call pictura_generate with consistency: "reference" and ref set to the last output path
• Upscale a chosen PNG to higher resolution for print using pictura_generate with upscale parameters
• User requests "Show my recent images" → call pictura_list and present the returned paths
• User says "Open the gallery" or "Browse images" → call pictura_gallery to open the HTML gallery