adobe-retouch-portraits

What this skill does

# Adobe Retouch Portraits

A walk-away bulk retouching pipeline for photographers. The user selects their
images, optionally adds tweaks, and Claude runs the full batch using Adobe
for creativity tools.

---

## Tool Reference (Adobe for creativity connector)

| Step                  | Tool                                                        | Notes                                              |
| --------------------- | ----------------------------------------------------------- | -------------------------------------------------- |
| Ingest                | `asset_add_file`                                            | Interactive file picker                            |
| Straighten            | `image_auto_straighten`                                     | Per image                                          |
| Auto-Tone             | `image_apply_auto_tone` (cameraRawFilter)                   | Per image                                          |
| Exposure              | `image_adjust_exposure`                                     | Batch (`imageURIs` array)                          |
| Highlights            | `image_adjust_highlights`                                   | Batch                                              |
| Shadows               | `image_adjust_dark_portions`                                | Batch                                              |
| Brightness/Contrast   | `image_adjust_brightness_and_contrast`                      | Batch                                              |
| Vibrance/Saturation   | `image_adjust_vibrance_and_saturation`                      | Batch                                              |
| Face detection        | `image_select_subject` with `bodyParts: ["Face"]`           | To check for face presence                         |
| Adaptive Enhancements | `image_apply_preset`                                        | Per image, opt-in (see Step 6)                     |
| Adaptive Blur BG      | `image_apply_preset` ("Adaptive: Blur Background - Subtle") | Replaces `image_apply_lens_blur` when selected     |
| Heavy blur            | `image_apply_gaussian_blur`                                 | Per image (if user requests, no adaptive selected) |
| Crop                  | `image_crop_and_resize`                                     | Per image                                          |
| Sample preview        | `asset_preview_file`                                        | Before/after on image[0] only                      |
| Final preview         | `asset_preview_file`                                        | All final URLs directly, no resize step            |
| Firefly Board         | `create_firefly_board`                                      | Source presigned URLs from ingestion               |

---

## 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-retouch-portraits", "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. This renders an interactive UI where
the user can:
- **Browse CC storage** and select a folder or individual files
- **Upload from device** (local files)
- **In Cowork**: select a local folder path directly
```
Tool: asset_add_file
Params: {}
```

**Important:** `asset_add_file` returns `imageURIs: []` — this is expected and
NOT an error. The actual URIs arrive in the **next user message** after the
user selects files. Wait for that follow-up before continuing.

---

## Step 3: Announce Pipeline + Offer Options

Once URIs are obtained, check whether the user's message **already fully specifies** their enhancement, tweak, and crop preferences.

**If preferences are fully stated upfront** (e.g. "retouch with subject pop, no tweaks, crop 1:1"), skip `AskUserQuestion` entirely and go straight to the confirmation message. Map their stated preferences using the button→parameter table below.

**If preferences are not fully stated** (e.g. "please retouch them" with no further detail), post this message first:
```
📸 Got [N] photo(s)! The default pipeline will auto-straighten and auto-tone every image.

Let me know if you'd like any extras 👇
```

Then call `AskUserQuestion` with these three questions:

```
Question 1 (multi_select):
  question: "✨ Adaptive AI enhancements (select any — or none to skip)"
  options:
    - "All"
    - "Subject Pop — boost contrast & vibrance on the person"
    - "Warm Pop — warm, glowing subject lift"
    - "Whiten Teeth — brightens teeth (smiles only)"
    - "Blur Background — subtle bg blur, respects edges"
    - "Sky Drama (Blue) — deepen sky blue, outdoor only"
    - "Sky Drama (Dark) — moody dramatic sky, outdoor/editorial"
    - "None"

Question 2 (multi_select):
  question: "🎛️ Manual tweaks (select any — or none to skip)"
  options:
    - "Recover highlights"
    - "Lift shadows"
    - "More contrast"
    - "More vibrant"
    - "Desaturate (muted tones)"
    - "Heavy background blur"
    - "None"

Question 3 (single_select):
  question: "✂️ Crop ratio"
  options:
    - "Auto (landscape→4:3, portrait→3:4)"
    - "1:1 square"
    - "4:5 portrait"
    - "16:9 wide"
```

**Hold processing until the user replies with their selections.**

### Mapping button selections to parameters

**Adaptive enhancements:**
- "All" → run all six presets (apply skip conditions as normal: Whiten Teeth requires face, Sky presets require outdoor context)
- "Subject Pop" → `Adaptive: Subject - Pop`
- "Warm Pop" → `Adaptive: Subject - Warm Pop`
- "Whiten Teeth" → `Adaptive: Portrait - Whiten Teeth` (skip if no face detected)
- "Blur Background" → `Adaptive: Blur Background - Subtle` (skip Step 7 for that image)
- "Sky Drama (Blue)" → `Adaptive: Sky - Blue Drama`
- "Sky Drama (Dark)" → `Adaptive: Sky - Dark Drama`
- "None" → skip Step 6 entirely
**Manual tweaks:**
- "Recover highlights" → `image_adjust_highlights` → `amount: -60`
- "Lift shadows" → `image_adjust_dark_portions` → `amount: -40`
- "More contrast" → `image_adjust_brightness_and_contrast` → `contrast: 30`
- "More vibrant" → `image_adjust_vibrance_and_saturation` → `vibrance: 30`
- "Desaturate" → `image_adjust_vibrance_and_saturation` → `saturation: -30`
- "Heavy background blur" → `image_apply_gaussian_blur` → `blurRadius: 12, blurTarget: "background"` (do not combine with Blur Background adaptive preset)
- "None" → skip Step 5b entirely
**Crop:**
- "Auto" → landscape → `"4:3"`, portrait → `"3:4"`, focus: `"face"`
- "1:1 square" → `output: "1:1"`, focus: `"face"`
- "4:5 portrait" → `output: "4:5"`, focus: `"face"`
- "16:9 wide" → `output: "16:9"`, focus: `"face"`
All crop modes use `focus: "face"`. If no face is detected, fall back to `focus: "subject"`.

After receiving button selections, confirm the settings back to the user:
```
✅ Got it — running with:
- Auto-straighten + auto-tone + auto-light
- Adaptive enhancements: [list selected, or "none"]
- Manual tweaks: [list if any, or "none"]
- Crop: [ratio or "auto 4:3/3:4"]
- Blur: [adaptive / heavy / none]
```

---

## Step 3a: Large Batch Warning (N > 5)

Include this in the confirmation when N > 5:

```
⏱ Estimated time for [N] images:
  6–10 → ~3–5 min
  11–20 → ~5–10 min
  20+ → 10+ min

Feel free to step away — I'll post a ✅ completion summary with your
download links when done. (No Slack/email notifications available from here.)
```

---

## Step 3b: Sample Preview (Before/After on Image 1)

Before running the full batch, process the **first image only** through the complete pipeline (Steps 4–8) using the confirmed settings. This gives the user a real preview of exactly what will be app