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.