adobe-batch-edit-photos

What this skill does

# Adobe Batch Edit Photos

A batch editing pipeline focused on **visual cohesion** — making a set of
photos look like they were edited together. The user picks a look (or
describes one), and Claude applies it consistently across every image using
Adobe creativity tools.

The core insight: users who want "cohesion" care less about per-image
perfection and more about the whole set reading as intentional. Prioritize
consistency of tone and color over squeezing the best out of any single image.

---

## Tool Reference

| Step                | Tool                                              | Notes                                          |
| ------------------- | ------------------------------------------------- | ---------------------------------------------- |
| Ingest              | `asset_add_file`                                  | Interactive file picker                        |
| Straighten          | `image_auto_straighten`                           | Per image                                      |
| Auto-tone           | `image_apply_auto_tone`                           | Per image, `type: "cameraRawFilter"`           |
| Exposure            | `image_adjust_exposure`                           | Batch — fine-tune option (brighter/darker)     |
| Highlights          | `image_adjust_highlights`                         | Batch — fine-tune option                       |
| Shadows             | `image_adjust_dark_portions`                      | Batch — fine-tune option                       |
| Bright areas        | `image_adjust_light_portions`                     | Batch — fine-tune option                       |
| Brightness/Contrast | `image_adjust_brightness_and_contrast`            | Batch, if requested                            |
| Vibrance/Saturation | `image_adjust_vibrance_and_saturation`            | Batch, if requested                            |
| Color temperature   | `image_adjust_color_temperature`                  | Batch — key for "warm", "cool", "golden" looks |
| Look preset         | `image_apply_preset`                              | Per image, core style vehicle                  |
| Face detect         | `image_select_subject` with `bodyParts: ["Face"]` | Per image, only if crop focus needed           |
| Background blur     | `image_apply_gaussian_blur`                       | Per image, only if explicitly requested        |
| Crop                | `image_crop_and_resize`                           | Per image, optional                            |
| Sample preview      | `asset_preview_file`                              | Before/after on image[0] only                  |
| Final preview       | `asset_preview_file`                              | Batch assets array                             |
| Firefly Board       | `create_firefly_board`                            | All edited outputs                             |

---

## Step 0 - prereq: Initialize Adobe Tools
Call `adobe_mandatory_init` first. This returns file handling rules and tool routing guidance required for the rest of the workflow.

```json
{ "skill_name": "adobe-batch-edit-photos", "skill_version": "1.0.1" }
```

---

## Step 1 — Entitlement Check

Now that `adobe_mandatory_init` confirmed that the "Adobe for creativity" connector is live, check which tools are available through the "Adobe for creativity" connector by cross checking against the Tool Reference table above.

---

## Step 2: Image Ingestion

Call `asset_add_file` with no parameters to open the file picker:

```
Tool: asset_add_file
Params: {}
```

---

## Step 3: Understand the Desired Look

Once URIs are obtained, scan the conversation to infer as many preferences
as possible before asking anything:

- **Look**: inferrable from words like "warm", "golden", "cinematic", "moody",
  "bright and airy", "muted", "film", "cool", "vibrant", "punchy"
- **Fine-tune tweaks**: inferrable from "recover highlights", "lift shadows",
  "more contrast", "blown out", "too dark", "more vibrant", "desaturate"
- **Crop**: inferrable from "no crop", "square", "1:1", "portrait crop", "keep framing", etc.

**Three cases:**

**A — Everything clear from context:** Skip `AskUserQuestion` entirely. Post the confirmation message, then proceed directly to Step 3b (sample preview). Do NOT start the full batch — the preview and confirm gate always runs regardless of how clearly preferences were stated.

**B — Some things clear, some not:** Confirm what you've inferred upfront,
then call `AskUserQuestion` with only the questions that remain unanswered.
For example, if the look and a tweak are clear but crop isn't, post:
```
📷 Got [N] photo(s)! Based on what you said, I'll go with:
- Look: Moody & Cinematic
- Tweaks: Recover blown highlights

Just one thing — do you want a crop?
```
Then call `AskUserQuestion` with Question 3 only.

**C — Nothing specified:** Post the full intro and show all 3 questions:
```
📷 Got [N] photo(s)! I'll apply consistent edits across all of them so
the set looks cohesive.

What kind of look are you going for? 👇
```

The full `AskUserQuestion` questions (use only the ones that are still open):

```
Question 1 (single_select):
  question: "🎨 Pick a base look"
  options:
    - "Auto (balanced, neutral)"
    - "Warm & Golden — cozy, travel, golden hour"
    - "Bright & Airy — clean, light, lifestyle"
    - "Moody & Cinematic — dramatic, contrasty, desaturated"
    - "Cool & Fresh — clear skies, travel, blue tones"
    - "Vibrant & Punchy — vivid, bold, social-ready"
    - "Muted & Film — faded, analog, editorial"

Question 2 (multi_select):
  question: "🎛️ Fine-tune (optional)"
  options:
    - "Recover blown highlights"
    - "Lift dark shadows"
    - "Boost contrast"
    - "Boost color intensity"
    - "Desaturate / muted tones"
    - "Adjust exposure (brighter/darker)"
    - "Tune bright areas"
    - "Blur background (heavy)"
    - "None"

Question 3 (single_select):
  question: "✂️ Crop ratio? (optional)"
  options:
    - "No crop — keep original framing"
    - "1:1 square"
    - "4:5 portrait"
    - "16:9 wide"
    - "4:3 standard"

Question 4 (single_select):  [only ask if Q3 is not "No crop"]
  question: "🎯 How should the crop be framed?"
  options:
    - "Center — crop from center of image"
    - "Smart crop — detect subject/face and frame around it"
```

Wait for the user's reply before proceeding.

**Note on Question 4:** If the user's message already implies a framing preference
(e.g. "center crop", "crop to my face", "frame around the subject"), skip Q4 and
infer directly. If the user specifies a ratio but not a framing method, default to
Smart crop — it almost always produces a better result than a pure center cut.

### Look → Parameter Mapping

**Base look → `image_adjust_color_temperature` + `image_apply_preset` + adjustments:**

| Look              | Color Temp (a, b, luminance) | Preset                         | Saturation/Vibrance          | Brightness/Contrast |
| ----------------- | ---------------------------- | ------------------------------ | ---------------------------- | ------------------- |
| Auto (balanced)   | none                         | `Adaptive: Auto Tone`          | none                         | none                |
| Warm & Golden     | a=32, b=120, luminance=67    | `Adaptive: Subject - Warm Pop` | vibrance +15                 | none                |
| Bright & Airy     | a=20, b=60, luminance=62     | `Adaptive: Subject - Pop`      | saturation -10, vibrance +10 | brightness +15      |
| Moody & Cinematic | a=20, b=-50, luminance=45    | `Adaptive: Sky - Dark Drama`   | saturation -20               | contrast +25        |
| Cool & Fresh      | a=18, b=-123, luminance=45   | `Adaptive: Sky - Blue Drama`   | vibrance +10                 | none                |
| Vibrant & Punchy  | none                         | `Adaptive: Subject - Pop`      | vibrance +30, saturation +15 | contrast +10        |
| Muted & Film      | none                         | none