adobe-retouch-portraits

Files (1)

• SKILL.md

SKILL.md (first lines)

# 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`

From kalash33/kstack, Apache-2.0.

More from kalash33/kstack