From photoshop-cli
Control Adobe Photoshop via CLI (psd command) and MCP server. Use when user asks to open, close, or save PSD files, list open documents, get document info, or automate Photoshop workflows. Triggers: "open in Photoshop", "PSD file", "document list", "psd file", "photoshop automation", "layer info", "save image", "Photoshopで開いて", "PSDファイルを", "ドキュメント一覧". Do NOT use for Lightroom (use lightroom-cli skill), Figma, or other design tools.
How this skill is triggered — by the user, by Claude, or both
Slash command
/photoshop-cli:photoshop-cliThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Control Adobe Photoshop via CLI/MCP.
Control Adobe Photoshop via CLI/MCP.
The following rules MUST be followed. Violations can cause data loss or break user trust.
file open, file close, file save modify Photoshop state.
Always ask for user confirmation before executing.
BAD: psd file close --doc-id 1
GOOD: "Close Document 1 (photo.psd)?" → execute after approval
--output json for read operationsAlways specify --output json for file list and file info.
Text output is unstable for parsing and causes agent hallucinations.
# Correct
psd --output json file list
psd --output json file info --doc-id 1
# Wrong (causes parse errors)
psd file list
--fields to save context windowOnly fetch the fields you need.
psd --output json --fields documentId,name file list
psd --output json --fields width,height,resolution file info --doc-id 1
--dry-run for pre-validationValidate mutation operations with --dry-run before executing.
# Validate first
psd --dry-run --output json file open /path/to/file.psd
# Execute after successful validation
psd --output json file open /path/to/file.psd
Check exit codes and respond appropriately:
| Exit Code | Meaning | Action |
|---|---|---|
| 0 | Success | Continue |
| 1 | General error | Check error message, report to user |
| 2 | Connection error | Ask user to verify Photoshop/plugin is running |
| 3 | Timeout | Retry with extended --timeout |
| 4 | Validation error | Fix input parameters and retry |
When unsure about command arguments or options, use psd schema.
Never hallucinate parameters.
psd --output json schema file.open # Check file.open arguments
psd --output json schema # List all commands
psd command is available)Claude Code
↓ psd file list
CLI (psd)
↓ WebSocket
Python SDK (ResilientWSBridge) ← WS Server listening on port from /tmp/photoshop_ws_port.txt
↑ WebSocket connection
UXP Plugin (ws_client.ts) → Photoshop app API
psd --output json file list # List open documents
psd --output json file info --doc-id <ID> # Get document info
psd --output json file open /path/to/file.psd # Open file
psd --output json file close --doc-id <ID> # Close document
psd --output json file close --doc-id <ID> --save # Save and close
psd --output json file save --doc-id <ID> # Save document
psd --output json system ping # Check connection to Photoshop
psd --output json schema # List all available commands
psd --output json schema file.open # Show JSON schema for file.open
psd --output json schema system.ping # Show JSON schema for system.ping
psd mcp install # Install MCP server to Claude Desktop
psd mcp install --force # Overwrite existing entry
psd mcp uninstall # Remove MCP server from config
psd mcp status # Show installation status
psd mcp test # Test connection via MCP
| Option | Short | Description |
|---|---|---|
--output json|text|table | -o | Output format (default: json for non-TTY) |
--fields f1,f2 | -f | Filter output fields |
--dry-run | Validate only, do not execute | |
--timeout <sec> | -t | Command timeout in seconds |
--verbose | -v | Enable debug logging |
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | General error |
| 2 | Connection error (Photoshop not running / plugin not connected) |
| 3 | Timeout |
| 4 | Validation error |
cat /tmp/photoshop_ws_port.txtpsd --output json file list# Example: extend timeout for large files
psd --timeout 120 --output json file open /large/file.psd
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub znznzna/photoshop-cli --plugin photoshop-cli