/adobe-retouch-portraits

name: adobe-retouch-portraits
description: >
  Bulk-retouch a folder of portrait photos using Adobe tools —
  designed for wedding photographers and event photographers who need fast,
  walk-away batch processing. Use this skill when the user says "retouch my
  photos", "batch process these portraits", "process my wedding photos",
  "clean up this folder of images", "run my headshots through Adobe", or
  uploads/selects a folder of photos and wants them polished and ready to
  review. Automatically applies auto-straighten, auto-tone, and auto-light
  to every image. Outputs a preview grid and download folder.
  Access: 🔐 Signed-In required | Gen AI: ❌ by default — optional background-only cleanup only where the surface permits generative AI (e.g. Codex); none on Claude
license: Apache-2.0
compatibility: "Runs on both widget-capable surfaces (e.g. Claude Cowork, which supports the asset_add_file picker and asset_preview_file preview widgets) and non-UI agents (e.g. Codex, where those widgets are unavailable). The default flow uses the widgets; each widget step has a text-only fallback. Local files are staged to Creative Cloud first; raw local paths are never passed to image tools."
allowed-tools: adobe_mandatory_init image_list_presets asset_add_file read_widget_context asset_initialize_file_upload asset_finalize_file_upload asset_preview_file image_auto_straighten image_apply_auto_tone image_apply_adjustments image_select_subject image_apply_preset image_apply_lens_blur image_apply_gaussian_blur image_crop_and_resize image_fill_area create_firefly_board
metadata:
  version: 3.1.0
  visibility: public
  surface: [claude, codex]

Adobe Retouch Portraits

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

> **Surface note:** The default flow uses Adobe's MCP App widgets — the `asset_add_file` picker (Step 1) and the `asset_preview_file` preview (Steps 2c and 8). Follow it as written. Only if a widget tool is **not available on this surface** (e.g. Codex) use the *No-widget fallback* attached to that step. Present `AskUserQuestion` prompts as plain-text labeled options wherever no question widget exists.

---

Generative AI Policy

**This retouching pipeline is fully non-generative by default.** The core workflow — auto-straighten, auto-tone, adjustments, presets, blur, and crop — uses no generative AI, and that non-generative pipeline is the *only* behavior on surfaces that do not permit generative AI (**including Claude**).

**Generative editing runs only where the surface permits it.** A surface permits generative AI only when it exposes a generative tool such as `image_fill_area` (e.g. Codex). Where no such tool is available (e.g. Claude), perform **no** generative edits of any kind — do not call, attempt, offer, or mention them; run the non-generative pipeline only.

**Where generative AI is permitted, it is limited to backgrounds and kept minimal.** Only then may `image_fill_area` correct dust spots, sensor artifacts, or scratches on non-human areas (walls, floors, sky, props), and only when the fix is invisible at normal viewing size — remove a dust spot, not repaint a wall. **Never** apply generative tools to faces, skin, hair, bodies, or clothing on any surface. Do not alter the scene, remove objects, change the environment, or extend the frame.

If the user asks you to generatively modify a person (e.g. "change her hair color", "make him look younger"), clarify that this skill does not perform generative edits on people — and, on a surface with no generative capability at all, that generative editing isn't available here — then suggest a dedicated generative workflow instead.

---

Tool Reference (Adobe for creativity connector)

| Step | Tool | Notes | | --------------------- | ----------------------------------------------------------- | -------------------------------------------------- | | Ingest | `asset_add_file` + `read_widget_context` | Interactive file picker; resolve URIs via `read_widget_context` | | Ingest *(no-widget fallback)* | `asset_initialize_file_upload` + `asset_finalize_file_upload` | Only when `asset_add_file` is unavailable — stage a local file to CC | | Discover presets | `image_list_presets` | Once at startup; builds the smart preset plan | | Straighten | `image_auto_straighten` | Per image | | Auto-Tone | `image_apply_auto_tone` (cameraRawFilter) | Per image | | Tone adjustments | `image_apply_adjustments` | Batch — all tweaks in one call | | Subject/body detect | `image_select_subject` | Face + body parts + clothes detection | | Adaptive Enhancements | `image_apply_preset` | Per image, opt-in (see Step 5) | | Background blur | `image_apply_lens_blur` | Per image, preferred — depth-aware bokeh | | Heavy/stylized blur | `image_apply_gaussian_blur` | Per image, only if user explicitly requests heavy | | Background cleanup | `image_fill_area` (optional; generative) | Only where the surface permits generative AI (tool available, e.g. Codex) — backgrounds only, never people; **not used on Claude** | | Crop | `image_crop_and_resize` | Per image | | Sample preview | `asset_preview_file`