Multi-Panel Figure Assembler

Assemble 6 sub-figures (A–F) into a high-resolution composite figure with consistent styling, labels, and publication-ready output.

Input Validation

This skill accepts: exactly 6 image files (panels A–F) in supported formats, plus an output path, for assembly into a composite figure.

If the request does not involve assembling exactly 6 image panels into a composite figure — for example, asking to generate plots from data, edit image content, or assemble a different number of panels — do not proceed. Instead respond:

"multi-panel-figure-assembler is designed to assemble exactly 6 sub-figures (A–F) into a composite image. Your request appears to be outside this scope. Please provide 6 image files and an output path, or use a more appropriate tool for your task. For plot generation from data, consider matplotlib, seaborn, or R ggplot2."

Do not attempt any data processing or partial analysis before emitting this refusal. Validate scope first — this is the absolute first action before any other processing.

When to Use

• - Combining individual plot panels into a single composite figure for publication
• Standardizing label fonts, padding, and DPI across a figure set
• Producing 2×3 or 3×2 grid layouts from existing image files
• Automating figure assembly to ensure reproducibility

Note: This skill is fixed to exactly 6 panels (A–F labeling convention). For 4-panel (2×2) or 9-panel (3×3) layouts, a future --panels parameter may be added.

Workflow

1. 1. Validate input — confirm scope and that exactly 6 panels are provided before any processing. Do not generate any output before this check.
2. Confirm the user objective, required inputs, and non-negotiable constraints.
3. Use the packaged script path or the documented reasoning path with only the inputs that are actually available.
4. Return a structured result that separates assumptions, deliverables, risks, and unresolved items.
5. If execution fails or inputs are incomplete, switch to the fallback path and state exactly what blocked full completion.

Usage

CODEBLOCK0

Parameters

Supported Formats

• - Input: PNG, JPG, JPEG, BMP, TIFF, GIF
• Output: PNG (recommended), JPG, TIFF

Quick Check

CODEBLOCK1

Error Handling

• - If fewer or more than 6 input images are provided, state the count mismatch and stop.
• If any input file path contains ../ or points outside the workspace, reject with a path traversal warning.
• If the task goes outside the documented scope, stop instead of guessing or silently widening the assignment.
• If scripts/main.py fails (e.g., returncode=2 from missing required args), report the exact error and provide the correct command syntax.
• If PIL/Pillow is not installed, print: pip install Pillow numpy and exit with a non-zero code.
• Do not fabricate files, citations, or execution outcomes.

Fallback Template

When execution fails or inputs are incomplete, respond with this structure:

CODEBLOCK2

Response Template

Use the following fixed structure for non-trivial requests:

1. 1. Objective
2. Inputs Received
3. Assumptions
4. Workflow
5. Deliverable
6. Risks and Limits
7. Next Checks

If the request is simple, compress the structure but keep assumptions and limits explicit when they affect correctness.

Notes

• - Input images are automatically resized to match the largest dimension while maintaining aspect ratio
• For best results, use input images with similar aspect ratios
• Label fonts require the font to be available on the system; Arial falls back to DejaVu Sans if unavailable
• PNG output preserves transparency if any input images have alpha channels

Prerequisites

CODEBLOCK3