ps-batchplay
- Repo stars 5
- License MIT
- Author updated Live
- Author repo 00bx-photoshop-mcp
- Domain
- Documentation
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 94 / 100 · audit passed
- Author / version / license
- @00bx · MIT
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools，默认拥有全部工具权限。
---
name: ps-batchplay
description: BatchPlay/batchplay reference for Photoshop MCP execute_batchplay tool. Descriptor format, refer…
category: documentation
runtime: no special runtime
---
# ps-batchplay output preview
## PART A: Task fit
- Use case: BatchPlay/batchplay reference for Photoshop MCP execute_batchplay tool. Descriptor format, reference forms (by ID, active layer, document, channel), unit types (pixels, percent, angle, density), operations requiring batchplay (lighting effects, VIVID_LIGHT blend mode, select layer by ID, invert pixels), filter scriptability table, event code table for all filter categories, pro tips for recording descriptors and action listener..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “4.1 DESCRIPTOR FORMAT / 4.2 REFERENCE FORMS / 4.3 UNIT TYPES” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “BatchPlay/batchplay reference for Photoshop MCP execute_batchplay tool. Descriptor format, reference forms (by ID, active layer, document, channel), unit types (pixels, percent, angle, density), operations requiring batchplay (lighting effects, VIVID_LIGHT blend mode, select layer by ID, invert pixels), filter scriptability table, event code table for all filter categories, pro tips for recording descriptors and action listener.”.
- **02** When the source has headings, the agent prioritizes “4.1 DESCRIPTOR FORMAT / 4.2 REFERENCE FORMS / 4.3 UNIT TYPES” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options.The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files, run shell commands.
Start with a small task and check whether the result follows “4.1 DESCRIPTOR FORMAT / 4.2 REFERENCE FORMS / 4.3 UNIT TYPES”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: ps-batchplay
description: BatchPlay/batchplay reference for Photoshop MCP execute_batchplay tool. Descriptor format, refer…
category: documentation
source: 00bx/00bx-photoshop-mcp
---
# ps-batchplay
## When to use
- BatchPlay/batchplay reference for Photoshop MCP execute_batchplay tool. Descriptor format, reference forms (by ID, act…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “4.1 DESCRIPTOR FORMAT / 4.2 REFERENCE FORMS / 4.3 UNIT TYPES” and keep inference separate from source facts.
- read files, write/modify files, run shell commands; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies.The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "ps-batchplay" {
input -> user goal + target files + boundaries + acceptance criteria
context -> 4.1 DESCRIPTOR FORMAT / 4.2 REFERENCE FORMS / 4.3 UNIT TYPES
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, write/modify files, run shell commands | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
}§4 BATCHPLAY REFERENCE
Use this section ONLY when no dedicated tool exists for your operation (Rule R7).
4.1 DESCRIPTOR FORMAT
[
{
_obj: "commandName", // Event string code (required)
_target: [{ _ref: "layer", _id: 5 }], // Target (optional)
paramName: value, // Simple value
enumParam: { _enum: "enumType", _value: "enumValue" }, // Enum
unitParam: { _unit: "pixelsUnit", _value: 10.0 }, // Unit value
},
];4.2 REFERENCE FORMS
{_ref: "layer", _id: 42} // By ID (best)
{_ref: "layer", _enum: "ordinal", _value: "targetEnum"} // Active layer
{_ref: "document", _enum: "ordinal", _value: "targetEnum"} // Active document
{_ref: "channel", _enum: "channel", _value: "RGB"} // RGB composite4.3 UNIT TYPES
{_unit: "pixelsUnit", _value: 10} // Pixels
{_unit: "percentUnit", _value: 50} // Percentage
{_unit: "angleUnit", _value: 90} // Degrees
{_unit: "densityUnit", _value: 72} // PPI4.4 OPERATIONS THAT STILL NEED BATCHPLAY
These operations have NO dedicated tool — use execute_batchplay:
Lighting Effects:
[
{
"_obj": "lightingEffects",
"lightList": [
{
"_obj": "lightSource",
"lightType": { "_enum": "lightType", "_value": "spotLight" },
"intensity": 50,
"focus": 60,
"posX": 500,
"posY": 300
}
]
}
]VIVID_LIGHT blend mode (not supported by set_layer_properties):
[
{
"_obj": "set",
"_target": [
{ "_ref": "layer", "_enum": "ordinal", "_value": "targetEnum" }
],
"to": {
"_obj": "layer",
"mode": { "_enum": "blendMode", "_value": "vividLight" }
}
}
]Select layer by ID:
[
{
"_obj": "select",
"_target": [{ "_ref": "layer", "_id": 42 }],
"makeVisible": false
}
]Invert layer pixels (not selection):
[{ "_obj": "invert" }]4.5 FILTER SCRIPTABILITY TABLE
| Filter | Headless (no dialog) | Notes |
|---|---|---|
| All standard filters | Yes | gaussianBlur, wave, wind, etc. |
| Blur Gallery | May force dialog | Known Adobe bug |
| Camera Raw Filter | No | Always requires dialog. Use Curves/Levels instead |
| Liquify (full mesh) | No | Only liquify_forward works headless |
| Neural Filters | No | Cloud-based, requires dialog |
4.6 EVENT CODE TABLE
Blur: gaussianBlur, motionBlur, radialBlur, smartBlur, surfaceBlur, lensBlur, blurbTransform Distort: wave, twirl, spherize, polar, ripple, oceanRipple, pinch, shear, zigZag, displace, glass Stylize: wind, emboss, findEdges, diffuse, diffuseGlow, glowingEdges, tiles, extrude, solarize Sketch: chrome, basRelief, chalkCharcoal, charcoal, photocopy, stamp, tornEdges, waterPaper, notePaper, plaster, reticulation, halftonePattern, graphicPen Artistic: plasticWrap, dryBrush, filmGrain, fresco, neonGlow, paletteKnife, paintDaubs, roughPastels, smudgeStick, sponge, underpainting, watercolor, posterEdges, coloredPencil, cutout Noise: addNoise, despeckle, dustAndScratches, median, reduceNoise Sharpen: sharpen, unsharpMask, highPass, smartSharpen Render: clouds, $DrfC (diff clouds), lensFlare, fibers/$Fbrs Texture: craquelure, grain, mosaicPlugin, patchwork, stainedGlass, texturizer Pixelate: colorHalftone, crystallize, facet, fragment, mezzotint, mosaic, pointillize Brush Strokes: accentedEdges, angledStrokes, crosshatch, darkStrokes, inkOutlines, spatter, sprayedStrokes, sumi_e Operations: make, set, get, delete, select, move, duplicate, hide, show, transform, crop, canvasSize, imageSize Adjustments: curves, levels, hueSaturation, colorBalance, brightnessEvent, channelMixer, selectiveColor, posterization, thresholdClassEvent, invert, desaturate, gradientMapEvent
§16 BATCHPLAY PRO TIPS
Record your own descriptors:
- Open Photoshop Actions panel
- Record the effect manually
- Panel flyout → "Copy As JavaScript"
- Gives exact descriptor for
execute_batchplay
Action listener (captures descriptors in real-time):
action.addNotificationListener(["all"], (event, descriptor) => {
console.log(event, descriptor);
});
Decide Fit First
Design Intent
How To Use It
Boundaries And Review