adobe-batch-edit-photos

Original๏ผš๐Ÿ‡บ๐Ÿ‡ธ English
Translated

Apply consistent photo adjustments across a set of images so they look like they were edited together. Use this skill whenever the user says "make my photos look cohesive", "give all these the same style", "apply a warm and golden feel to all of these", "make this cinematic", "match the look across my photos", "edit all my travel photos the same way", "batch edit these", "make these consistent", "fix my phone photos", or uploads a folder of photos and wants a unified, polished result. Also triggers for requests like "apply a preset to all of these", "make these look professional", or "they were shot in mixed lighting โ€” can you fix them all". Outputs direct final image URLs plus an in-chat preview grid and optional Firefly Board link. Access: ๐Ÿ” Signed-In required | Gen AI: โŒ

7installs
Added on

NPX Install

npx skill4agent add adobe/skills adobe-batch-edit-photos

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

StepToolNotes
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:
LookColor Temp (a, b, luminance)PresetSaturation/VibranceBrightness/Contrast
Auto (balanced)none
Adaptive: Auto Tone
nonenone
Warm & Goldena=32, b=120, luminance=67
Adaptive: Subject - Warm Pop
vibrance +15none
Bright & Airya=20, b=60, luminance=62
Adaptive: Subject - Pop
saturation -10, vibrance +10brightness +15
Moody & Cinematica=20, b=-50, luminance=45
Adaptive: Sky - Dark Drama
saturation -20contrast +25
Cool & Fresha=18, b=-123, luminance=45
Adaptive: Sky - Blue Drama
vibrance +10none
Vibrant & Punchynone
Adaptive: Subject - Pop
vibrance +30, saturation +15contrast +10
Muted & Filmnonenonesaturation -35, vibrance -10contrast +10
Fine-tune โ†’ tool parameters:
  • "Recover blown highlights" โ†’
    image_adjust_highlights
    โ†’
    amount: -60
  • "Lift dark shadows" โ†’
    image_adjust_dark_portions
    โ†’
    amount: +40
  • "Boost contrast" โ†’
    image_adjust_brightness_and_contrast
    โ†’
    contrast: 30
  • "Boost color intensity" โ†’
    image_adjust_vibrance_and_saturation
    โ†’
    vibrance: 30
  • "Desaturate / muted tones" โ†’
    image_adjust_vibrance_and_saturation
    โ†’
    saturation: -30
  • "Adjust exposure (brighter/darker)" โ†’
    image_adjust_exposure
    โ†’
    exposure: +0.5
    (brighter) or
    exposure: -0.5
    (darker); infer direction from context, default to
    +0.3
    if unspecified
  • "Tune bright areas" โ†’
    image_adjust_light_portions
    โ†’
    amount: +20
  • "Blur background (heavy)" โ†’
    image_apply_gaussian_blur
    โ†’
    blurRadius: 12, blurTarget: "background"
  • "None" โ†’ skip fine-tune step entirely
Crop:
  • "No crop" โ†’ skip Step 7 entirely
  • Ratio + "Center" โ†’
    image_crop_and_resize
    with
    fit: "reframe"
    , that ratio as
    output
    ,
    align: { x: 0.5, y: 0.5 }
    (pure center cut)
  • Ratio + "Smart crop" โ†’
    image_crop_and_resize
    with
    fit: "reframe"
    , that ratio as
    output
    ,
    focus: "face"
    if portraits/people likely, else
    focus: "subject"
    (smart reframe around detected subject at the chosen ratio)
After receiving selections, confirm the settings back to the user:
โœ… Got it โ€” running with:
- Look: [selected look]
- Tweaks: [list if any, or "none"]
- Crop: [ratio or "no crop"] + [Center / Smart crop]
- Background blur: [yes/no]
Then proceed immediately to Step 3b (sample preview) โ€” do not start the full batch yet.

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

Include this as part of the Step 3b confirmation prompt (after the before/after preview) 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 โœ… summary with download links when done.

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 applied to every image.
  1. Run the full pipeline on
    sourceURIs[0]
    only (straighten โ†’ tone โ†’ look โ†’ fine-tune โ†’ blur โ†’ crop).
  2. Call
    asset_preview_file
    directly with both the original source URL and the processed output URL โ€” do NOT resize either through
    image_crop_and_resize
    first, as that introduces white bars or unwanted cropping:
javascript
asset_preview_file({
  assets: [
    { name: "Before", presignedAssetUrl: sourceURIs[0] },
    { name: "After",  presignedAssetUrl: processed_url }
  ]
})
  1. Post this message (append the large-batch timing note here if N > 5):
๐Ÿ‘† Here's a before/after preview using your first photo and the settings you selected.

How does it look?
  1. Call
    AskUserQuestion
    with a single question:
Question (single_select):
  question: "Ready to run the full batch?"
  options:
    - "โœ… Looks great โ€” run all [N] images"
    - "๐ŸŽ›๏ธ Adjust settings"
    - "โŒ Cancel"
If "Looks great": Start the full batch on the remaining images (
sourceURIs[1โ€ฆ]
). Reuse the already-processed image[0] result โ€” do not reprocess it.
If "Adjust settings": Re-show the full
AskUserQuestion
set from Step 3. Once new settings are confirmed, ask whether the user wants another preview or wants to go straight to the full batch:
Question (single_select):
  question: "Want to preview the new settings first, or run all images now?"
  options:
    - "๐Ÿ‘ Preview first"
    - "๐Ÿš€ Run all [N] images now"
  • If "Preview first": repeat Step 3b with the new settings (process image[0] again, show before/after, offer the same Looks great / Adjust / Cancel gate).
  • If "Run all now": start the full batch immediately on all
    sourceURIs
    with the new settings. Do not reuse the earlier image[0] result โ€” reprocess it with the updated settings. If "Cancel": Acknowledge and stop. Do not process any images.

Step 4: Auto-Straighten (per image)

Tool: image_auto_straighten
Params:
  imageURIs: ["<source_uri_N>"]
  options:
    uprightMode: "auto"
    constrainCrop: true
Output:
results[0].outputUrl
โ†’
straightened_urls[]
On failure: use original URI, note "straighten skipped" for that image.

Step 5: Auto-Tone (per image)

Tool: image_apply_auto_tone
Params:
  imageURI: "<straightened_url_N>"
  options:
    type: "cameraRawFilter"
  outputFileType: "jpeg"
Use
type: "cameraRawFilter"
for
image_apply_auto_tone
. Output:
results[0].outputUrl
โ†’
toned_urls[]

Step 6: Apply the Look (per image)

Apply the look in this order per image, chaining outputs:
6a: Color Temperature (if the look requires it โ€” see mapping table)
image_adjust_color_temperature
supports a batch
imageURIs
array. Pass all toned URLs at once for efficiency:
Tool: image_adjust_color_temperature
Params:
  imageURIs: ["<toned_url_1>", "<toned_url_2>", ...]
  options:
    a: <value from mapping>         # green-red axis (-128โ€“127)
    b: <value from mapping>         # blue-yellow axis (-128โ€“127)
    luminance: <value from mapping> # 0โ€“100
Output:
results[N].outputUrl
โ†’
color_temp_urls[]
6b: Look Preset (if the look uses one โ€” see mapping table)
Tool: image_apply_preset
Params:
  imageURI: "<color_temp_url_N>"
  options:
    presetName: "<preset from mapping>"
6c: Vibrance / Saturation (if the look requires it)
Tool: image_adjust_vibrance_and_saturation
Params:
  imageURIs: ["<previous_url_N>"]
  options:
    vibrance: <value>
    saturation: <value>
6d: Brightness + Contrast (if the look requires either โ€” combine into one call)
Tool: image_adjust_brightness_and_contrast
Params:
  imageURIs: ["<previous_url_N>"]
  options:
    brightness: <value>   # omit if not needed for this look
    contrast: <value>     # omit if not needed for this look
Combining brightness and contrast into a single call saves a round trip and produces the same result as two sequential calls.
The goal is consistency: apply the same parameter values to every image, even if some images might technically look better with different values. Cohesion beats perfection here.
On 403 (entitlement) for
image_apply_preset
:
Skip the preset for all images. Note in the delivery summary: "[Preset name] was skipped โ€” not included in your Adobe plan." Continue with the rest of the look adjustments.

Step 7: Fine-Tune Adjustments (batch, if selected)

Apply user-selected tweaks across all images at once. All of these tools accept a batch
imageURIs
array โ€” chain from the look output:
Tool: image_adjust_highlights / image_adjust_dark_portions / image_adjust_brightness_and_contrast /
      image_adjust_vibrance_and_saturation / image_adjust_exposure / image_adjust_light_portions
Params:
  imageURIs: ["<look_url_1>", "<look_url_2>", ...]
  options:
    <values from mapping>
Run each selected tweak in sequence, chaining outputs. If "Boost contrast" is selected AND the look already calls
image_adjust_brightness_and_contrast
for brightness (e.g. Bright & Airy), merge them into a single call with both
brightness
and
contrast
values rather than running two separate calls.
Background blur (if selected, per image):
Tool: image_apply_gaussian_blur
Params:
  imageURIs: ["<url_N>"]
  options:
    blurRadius: 12
    blurTarget: "background"

Step 8: Crop (per image, if requested)

If "No crop" was selected, skip this step entirely.
Both crop modes use the same
fit: "reframe"
at the chosen ratio โ€” the difference is in how the frame is positioned within the image.
Center crop โ€” cuts to the target ratio from the geometric center:
Tool: image_crop_and_resize
Params:
  imageURI: "<adjusted_url_N>"
  options:
    output: "<ratio>"        # "1:1", "4:5", "16:9", "4:3"
    fit: "reframe"
    align: { x: 0.5, y: 0.5 } # geometric center
  outputFileType: "jpeg"
Smart crop โ€” same ratio, but positions the frame around the detected subject or face rather than the geometric center. The subject stays in frame even if they're off-center in the original:
Tool: image_crop_and_resize
Params:
  imageURI: "<adjusted_url_N>"
  options:
    output: "<ratio>"   # "1:1", "4:5", "16:9", "4:3"
    fit: "reframe"
    focus: "face"       # or "subject" for non-portrait scenes
  outputFileType: "jpeg"
Collect as
final_urls[]
. If no crop:
final_urls[]
= outputs from Step 7 (or Step 6 when no fine-tunes are selected).

Step 9: Preview

Pass the final output URLs directly to
asset_preview_file
โ€” do NOT run them through
image_crop_and_resize
first. Adding a resize step introduces white bars (from
fit: "pad"
) or crops subjects (from
fit: "reframe"
).
asset_preview_file
handles its own thumbnailing correctly.
javascript
asset_preview_file({
  assets: [
    { name: "photo_1.jpg", presignedAssetUrl: final_url_1 },
    // ... one per image
  ]
})
If
asset_preview_file
fails, present the final output URLs as plain text links in the completion summary.
Before/after preview (Step 3b): Same rule applies โ€” pass the original source URL and the processed URL directly to
asset_preview_file
. Do not resize either.

Create Firefly Board

Call the firefly board tool with the final output urls as follows:
javascript
create_firefly_board({
  import_adobe_storage: [
    final_output_url_1,
    final_output_url_2,
    // ...
  ]
})
Board link handling:
  • create_firefly_board
    returns a board URL. Extract it and store as
    board_url
    .
  • If
    board_url
    is present and non-empty, include it in the completion message.
  • If the call throws an error or returns no URL: omit the board link and note "Firefly Board unavailable" in the summary (retrying does not help). Then post the completion message. The preview grid is included in every completion message. The board link is included whenever
    board_url
    was returned.
If N โ‰ค 3:
โœ… Done! [N] photos edited with a consistent [look name] look.

๐Ÿ“ฅ Download:
โ€ข Photo 1 โ†’ <final_url_1>
โ€ข ...

๐ŸŽจ View in Firefly Board โ†’ <board_url>   โ† always include if board_url is set

Look applied: [look name] โ†’ [brief description of what was applied]
If N > 3:
โœ… Done! [N] photos edited with a consistent [look name] look.

๐Ÿ“ฅ Your edited photos:
โ€ข Photo 1 โ†’ <final_url_1>
โ€ข Photo 2 โ†’ <final_url_2>
โ€ข ...

๐ŸŽจ View in Firefly Board โ†’ <board_url>   โ† always include if board_url is set

Look applied: [look name] โ†’ [brief description of what was applied]

Verbosity Rule

Report only: major stage starts, per-image failures (logged once), and the final summary.
  • When a major stage starts (e.g. "Applying Warm & Golden look to [N] imagesโ€ฆ")
  • Any per-image failure (log once, continue)
  • Final summary with grid + download links

Output Extraction

All pipeline tools return:
json
{ "results": [{ "success": true, "outputUrl": "https://..." }] }
Read
results[N].outputUrl
. On
success: false
โ†’ see Error Handling.

Error Handling

SituationAction
image_apply_preset
returns 403
Skip preset for all images (Pattern 1). Note in summary. Continue with other look steps.
Any tone/color tool returns 403Skip that step. Note in summary. Continue.
Any tool returns "No approval received"Treat the same as a 403 entitlement error. For optional steps (presets, fine-tune adjustments, preview), skip and note in summary. Retrying does not help for this error โ€” continue per the rules above.
Any tool returns 401Ask user to re-authenticate via Adobe OAuth and retry.
Any tool returns "file too large or corrupted"Stop processing that image immediately. Do not retry, do not attempt alternative URLs. Tell the user: "I couldn't process [filename] โ€” it's either too large or the file may be damaged. Try re-uploading a smaller version, or check that the file opens correctly on your end." Flag the image in the summary and continue with remaining images.
asset_add_file
shows no files
Remind user to select files in the picker.
image_auto_straighten
fails
Use original URI; note "straighten skipped".
image_apply_auto_tone
fails
Use straightened URI; note in summary.
Any adjustment tool failsUse previous step's output; note in summary.
image_apply_gaussian_blur
fails
Use previous output; note "blur skipped".
image_crop_and_resize
fails
Use blur/adjusted output as final; note in summary.
asset_preview_file
returns "No approval received"
Present final output URLs as plain text links in the summary instead.
All steps fail on one imageReturn original URI; flag clearly in summary.

Hard Constraints

  • Every image in the batch is processed; failures are flagged rather than silently skipped.
  • image_apply_auto_tone
    is called with
    type: "cameraRawFilter"
    .
  • Apply the same parameter values to every image in the batch (cohesion over perfection).
  • Adaptive presets are off by default โ€” only run them as part of a look.
  • Background blur uses
    image_apply_gaussian_blur
    with
    blurTarget: "background"
    (
    image_apply_lens_blur
    is not used here).
  • Completion is posted as a clear in-chat message (no push notifications).