image-refiner

Composite real product photos into AI-generated scenes using Gemini.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Dunc4nJ/agent-skills --skill image-refiner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: image-refiner
Source: https://github.com/Dunc4nJ/agent-skills/tree/main/skills/image-refiner
Command: npx skills add https://github.com/Dunc4nJ/agent-skills --skill image-refiner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Refine base scene images by compositing real product photos into AI-generated scenes, enabling photorealistic product placement for marketing, catalogs, and launches. This skill orchestrates base image input, metadata, S3 asset retrieval, and Gemini-based editing with a built-in human QC gate.

Core Features & Use Cases

  • Automated image refinement: Retrieve a base image and metadata, download product reference photos from S3, and drive Gemini to edit the scene with accurate product placement.
  • Batch and single-image workflows: Supports individual refinements or batch runs with a QC gate between steps.
  • End-to-end provenance: Updates metadata with refined image path, reference assets used, and approval status for auditability.

Quick Start

Provide a base image and its associated metadata then run the image-refiner workflow to output a refined image after QC.

Frequently Asked Questions about image-refiner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate product placement for photorealistic marketing assets?

Automate photorealistic product placement by compositing real product photos into AI-generated scenes using S3-stored references and Gemini-based editing with a built-in human QC gate.

What do I need to provide for automated image refinement?

Automated image refinement requires a base scene image and an associated metadata JSON file containing refiner_notes to guide the compositing process.

Can I use S3-stored reference photos for batch image refinement?

S3-stored reference photos support batch image refinement workflows, downloading product assets to composite into multiple base scenes with a QC gate between steps.

Does this workflow require a human approval step before saving images?

A human QC gate is required before saving refined images, ensuring the photorealistic product placement meets quality standards and updating metadata with approval status.

How does the agent-browser use Gemini for product placement editing?

Gemini editing via agent-browser constructs a refinement prompt from downloaded S3 references and base image metadata to generate photorealistic product placement in AI scenes.

What is the best way to track provenance for refined product launch visuals?

Track provenance for refined product launch visuals by updating the metadata JSON with the refined image path, reference assets used, and final approval status for auditability.