Photoshop — Claude Code skill: drive Photoshop from the shell
This skill lets a coding agent work inside Adobe Photoshop: inspect the open document, layers and selection, then make bounded edits.
npx skills add SFKislev/Flue --skill photoshop -a claude-codeWhat Photoshop does
It runs on Flue, a local bridge between the shell and the application. The agent pipes ExtendScript into photoshop_bridge.py and gets structured JSON back. Shell to bridge to ExtendScript to result.
Reach for it when the request is about something happening inside Photoshop: check the open document, look at layers or the selection, apply a small edit, run a short ExtendScript step. A CLI agent has no way in without a bridge like this.
Read FLUE.md in the skill directory first. It covers how Flue works, the bridge contract, a worked ExtendScript example and safety expectations. If Flue is already installed, also read C:\Users\fredd\.claude\skills\flue\SKILL.md and adapters/photoshop_adapter/APP.md. If it is not, tell the human: the install is pip install flue && flue setup, and it should not run without explicit approval in the current session. Flue acts inside professional desktop software, so keep steps small and inspectable, and avoid destructive actions unless they are asked for.
What it helps with
- inspect layers and selection in the open document
- apply a bounded edit to a layout from the terminal
- run a short ExtendScript step without manual clicking
- check document state before an export
- hand the agent a JSON result to branch on
Example prompts for the agent
- Inspect the open Photoshop document and list its layers with visibility.
- Hide the watermark layer and return JSON with the new state.
- Check the active selection and tell me its pixel dimensions.
How to install Photoshop
1Skills CLI (Vercel)
npx skills add SFKislev/Flue --skill photoshop -a claude-code2Manually: put the files in place
~/.claude/skills/photoshop/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/photoshop/
1Skills CLI (Vercel)
npx skills add SFKislev/Flue --skill photoshop -a codex2Manually: put the files in place
.agents/skills/photoshop/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add SFKislev/Flue --skill photoshop -a cursor2Manually: put the files in place
.cursor/skills/photoshop/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install SFKislev/Flue photoshop2Manually: put the files in place
.github/skills/photoshop/SKILL.md1Skills CLI (Vercel)
npx skills add SFKislev/Flue --skill photoshop -a gemini-cli2Platform CLI
gemini skills install https://github.com/SFKislev/Flue --path skills/photoshopManually: put the files in place
.devin/skills/photoshop/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add SFKislev/Flue --skill photoshop -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about Photoshop
How do I install the Photoshop skill in Claude?
Run npx skills add SFKislev/Flue --skill photoshop -a claude-code. The skill file lands at ~/.claude/skills/photoshop/SKILL.md.
What does the Photoshop skill do?
It lets an agent operate inside Adobe Photoshop through Flue: the agent pipes ExtendScript into photoshop_bridge.py and gets structured JSON back.
What do I need for it to work?
Flue has to be installed — pip install flue && flue setup. Without it the skill tells the human and does not install anything on its own without approval in the current session.
Source text
SKILL.md · MIT
--- name: Photoshop description: Control Adobe Photoshop from the shell via Flue - ExtendScript bridges without an MCP server. --- This skill lets a coding agent operate **Adobe Photoshop** on the desktop through [Flue](https://github.com/SFKislev/flue), a local shell-to-application bridge. The agent pipes ExtendScript into `photoshop_bridge.py` and gets structured JSON back. > agent shell -> `photoshop_bridge.py` -> ExtendScript -> JSON result ## When to use The human requests work performed **inside Photoshop** — inspect the open document, layers, selection; make bounded edits; run small ExtendScript steps. A CLI agent cannot act inside Photoshop without a bridge like Flue. ## How to proceed 1. **Read `FLUE.md` in this directory first.** It explains how Flue works, the bridge contract, a worked ExtendScript example, and safety expectations. 2. **If Flue is installed:** also read `C:\Users\fredd\.claude\skills\flue\SKILL.md` and `adapters/photoshop_adapter/APP.md` for the operational contract, then work from there. 3. **If Flue is not installed:** tell the human. The install command is `pip install flue && flue setup`. Do not install without explicit approval in the current session. ## Other apps Flue also supports Illustrator, Premiere, After Effects, InDesign, Audition, Blender, Houdini, 3ds Max, Unity, and Microsoft Office through the same stdin/stdout contract. One install covers all adapters. ## Safety Flue acts inside professional desktop software. Treat the human as the driver; prefer small, inspectable steps; avoid destructive actions unless explicitly requested. Flue is MIT-licensed and reviewable on GitHub / PyPI before use.
© SFKislev · MIT · SFKislev/Flue
