psd-automator

What This Skill Does

The psd-automator is a powerful OpenClaw skill designed to streamline repetitive Photoshop tasks across both macOS and Windows environments. It enables users to perform programmatic text replacements within PSD or PSB files without the need for manual Photoshop interaction or popup dialogs. By leveraging AppleScript on macOS and Photoshop COM/PowerShell on Windows, it provides a consistent automation layer for design teams. The tool includes robust features such as dry-run modes, style-lock checks to ensure design integrity, and automatic rollback capabilities to handle execution failures gracefully.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Ensure you have the openclaw/skills repository access configured. Run the following command:

clawhub install openclaw/skills/skills/dhrxy/psd-automator

After installation, remember to build your initial PSD index cache by running the provided script against your design directories: node skills/psd-automator/scripts/build-index.js --root "/Your/Design/Path".

Use Cases

• Bulk Personalization: Rapidly generate multiple versions of name tags, business cards, or event passes by replacing text layers across a batch of PSD files.
• Design Systems: Update text-based elements in layout templates for social media assets or marketing banners automatically.
• Asset Exporting: Streamline the transition from design to production by automating text changes followed by immediate PNG exports of individual slices or layer sets.
• Collaboration: Ideal for team members in communication channels like DingTalk who need to request image updates from designers without leaving their chat workflow.

Example Prompts

1. "@OpenClaw psd-automator, find 20260225_event_pass.psd and update the 'Attendee Name' layer to 'John Doe'. Export the result to my Desktop as a PNG and show me a dry-run first."
2. "/psd locate badge_v1.psb and change the 'Role' text to 'Administrator', save the output as a high-quality PNG, and alert me when finished."
3. "@OpenClaw, use psd-automator to update all name layers in /Projects/Design/Teams based on my list, keeping the style-lock enabled to prevent formatting errors."

Tips & Limitations

• Dry-Run: Always execute with the --dry-run flag first to verify layer mappings and avoid unwanted overwrites of source files.
• Indexing: Maintain a healthy psd-index.json by running periodic incremental updates to ensure the automator finds files quickly.
• DingTalk Integration: When using in DingTalk, the skill provides specific [DINGTALK_IMAGE] markers for direct rendering; ensure your paths are absolute to prevent file resolution issues.
• Scope: This tool is strictly for text manipulation and export; screenshot understanding or visual AI analysis is currently out of scope. Ensure layers are named correctly according to your project standards, as the tool relies on layer name exact matching.