mcpField
P
photoshop-automator

photoshop-automator

github.com/abdul-karim-miaCreative & media0479 installsUpdated 37w ago
Repository

About photoshop-automator

Photoshop Automator is a skill for automating Adobe Photoshop through ExtendScript, for users scripting document edits and exports. It offers layer, text, filter, action, and export operations, with scripts restricted to ES3 syntax.

Key features

  1. 01Run ExtendScript code
  2. 02Update a named text layer
  3. 03Create and configure art layers
  4. 04Apply Gaussian Blur
  5. 05Play Photoshop actions and export images

Use cases

  1. 01Change text in PSD documents
  2. 02Blur the active layer
  3. 03Run recorded Photoshop actions
  4. 04Export the active document as PNG or JPEG

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/abdul-karim-mia/photoshop-automator --skill photoshop-automator

After installing, type/photoshop-automatorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

package.json
_meta.json
handler.js

Details

From the project README

Photoshop Automator Skill (v1.2.4)

This skill provides a high-performance bridge for automating Adobe Photoshop (vCS6 - 2026+) on Windows and macOS using the ExtendScript (JSX) engine via VBScript or AppleScript.

Commands

  • runScript: Executes raw ExtendScript (ES3) code. Use this for complex document manipulation.
  • updateText: Target a specific text layer by name and update its contents instantly.
  • createLayer: Create new art layers with custom opacity and blending modes.
  • applyFilter: Apply a professional Gaussian Blur filter to the active layer.
  • playAction: Play recorded Photoshop actions (.atn) by name and set.
  • export: Save the active document as a high-quality PNG or JPEG.

🛠 AI Protocol

1. Technical Constraints (Strict)
  • ES3 Syntax Only: Photoshop's ExtendScript engine uses ECMAScript 3 (ES3).
    • ❌ DO NOT USE: const, let, arrow functions () => {}, template literals `${}`, or Map/Set.
    • ✅ USE: Only var, standard function declarations, and string concatenation ('a' + b).
  • Assume Active Document: Commands operate on the active document. If none is open, scripts will fail unless they call app.documents.add().
2. Security & Side Effects
  • Filesystem Access: The runScript command allows execution of arbitrary ExtendScript. This engine has direct access to the host filesystem.
  • Side Effects: Scripts can create, modify, or delete files on the local machine via the File and Folder objects.
  • Verification: Always review dynamically generated scripts before execution to prevent unintended document or filesystem modifications.
3. Error Handling
  • GUI Blocks: If Photoshop has a modal dialog open (e.g., Save As window, error popup), COM operations will hang or fail. Direct the user to close any open dialogs.
  • Layer Presence: If updateText fails, ensure the layer name provided matches exactly (case-sensitive) with the layer in the PSD.

Setup

Ensure Adobe Photoshop is installed on the host system. The skill automatically uses the registered COM server.

Developed for the OpenClaw community by Abdul Karim Mia.

Comments

Markdown supported