ps-fundamentals

AI Community

Repo stars 5
License MIT
Author repo 00bx-photoshop-mcp

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: Photoshop MCP mandatory workflow rules (R1-R7), coordinate system, layer stack order, canvas rotation, selection fundamentals, m…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “WHEN TO USE THIS SKILL”, “1.1 COORDINATE SYSTEM”, “1.2 LAYER STACK ORDER”, “1.3 CANVAS ROTATION RULES”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name ps-fundamentals directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “WHEN TO USE THIS SKILL / 1.1 COORDINATE SYSTEM / 1.2 LAYER STACK ORDER” before expanding.

Boundaries And Review

Dependencies: It usually needs no extra API key, so start with a small validation task.
Permissions: Declared permissions include read / shell-exec; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

PHOTOSHOP DESIGNER SKILL — FUNDAMENTALS & RULES

Execute ANY Photoshop design effect perfectly on first try — zero trial-and-error.

WHEN TO USE THIS SKILL

Load this skill FIRST for any Photoshop operation. It contains the mandatory rules and core concepts needed before using any other Photoshop skill.

MANDATORY WORKFLOW RULES

<rules> <rule id="R1" severity="CRITICAL"> ALWAYS use a DEDICATED TOOL when one exists. NEVER use execute_batchplay for an operation that has its own tool. There are 323 dedicated tools. Check this catalog FIRST. </rule> <rule id="R2" severity="CRITICAL"> ALWAYS verify visual results after multi-step operations using get_layer_image (single layer) or get_document_image (full composite). Do NOT assume success from return status alone. </rule> <rule id="R3" severity="CRITICAL"> ALWAYS pass layer_id when calling execute_batchplay. The tool has an optional layer_id parameter that ensures the correct layer is targeted. Without it, batchPlay may silently operate on the wrong layer. </rule> <rule id="R4" severity="HIGH"> For ROUNDED CORNERS on any element: use draw_rectangle_shape(corner_radius=N) + set_layer_properties(is_clipping_mask=true). Do NOT attempt rounded rect selections via batchPlay — the corner radius keys are unreliable. </rule> <rule id="R5" severity="HIGH"> RASTERIZE layers before applying filters. Text, Shape, and Smart Object layers will fail silently with most filters. Always duplicate_layer first (preserve original), then rasterize_layer on the copy. </rule> <rule id="R6" severity="HIGH"> SCREEN blend mode requires BLACK background, not transparent. White on TRANSPARENT + SCREEN = invisible. White on BLACK + SCREEN = correct. </rule> <rule id="R7" severity="MEDIUM"> execute_batchplay is the LAST RESORT escape hatch. Use it only when: - No dedicated tool exists for the operation - You need to combine multiple atomic operations in one call - A dedicated tool has a known limitation for a specific parameter </rule> </rules>

§1 FUNDAMENTALS

1.1 COORDINATE SYSTEM

Origin (0,0) = top-left corner of canvas
X increases RIGHT, Y increases DOWN
Layer bounds: {left, top, right, bottom} in pixels from origin
Center of canvas: (width/2, height/2)

1.2 LAYER STACK ORDER

Layers are drawn bottom-up — bottom layer renders first, top layer renders last
move_layer(position="TOP") = above all (visually on top)
move_layer(position="BOTTOM") = below all (visually behind)
New layers appear ABOVE the currently active layer
Adjustment layers affect ALL layers below them unless clipped

1.3 CANVAS ROTATION RULES

rotate_canvas rotates the entire document including all layers
Rotation is destructive — pixels are resampled
Always rotate back by the exact negative amount
Plan filter directions BEFORE rotating — see Wind direction table §7.2

1.4 SELECTION FUNDAMENTALS

Selection = marching ants defining which pixels are affected
Feather = soft edges (pixels partially selected)
Selection MUST exist before: fill_selection, delete_selection, content_aware_fill, generative_fill, add_layer_mask_from_selection
select_all = entire canvas, clear_selection = deselect everything
Selections are per-document, not per-layer

1.5 MASK FUNDAMENTALS

Layer mask = grayscale image controlling layer visibility
White = fully visible, Black = fully hidden, Gray = partially visible
add_layer_mask_reveal_all = white mask (everything shows)
add_layer_mask_hide_all = black mask (everything hidden)
fill_mask_with_gradient = smooth transition between visible/hidden
To paint on mask: select_layer_mask → brush/fill → select_layer_rgb to go back
Gradient mask direction: start point = BLACK (hidden), end point = WHITE (visible)

1.6 SMART OBJECTS vs RASTERIZED LAYERS

Smart Objects preserve original data but BLOCK most filters
Rasterize BEFORE applying: Wind, Wave, Twirl, Spherize, Crystallize, Noise, Sharpen, etc.
Text layers must be rasterized before ANY filter
rasterize_layer is irreversible — always duplicate first

1.7 FILL OPACITY vs LAYER OPACITY

Layer Opacity = affects layer content + ALL layer styles
Fill Opacity = affects ONLY layer content, NOT layer styles (drop shadow, glow, bevel stay at full)
Key trick: Fill 0% + layer styles = invisible content with visible effects (used for glass text)
Set via: set_layer_properties(layer_id=X, fill_opacity=0)

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: AI
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 94 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @00bx · MIT
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: No requirement detected
Detected OS requirements: Unspecified
Runtime requirements: Unspecified
Detected file/system behavior: Read-only
Shell exec
Detected network behavior: Local-only
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview ps-fundamentals.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# PHOTOSHOP DESIGNER SKILL — FUNDAMENTALS & RULES

Execute ANY Photoshop design effect perfectly on first try — zero trial-and-error.

## WHEN TO USE THIS SKILL

Load this skill FIRST for any Photoshop operation. It contains the mandatory rules and core concepts needed before using any other Photoshop skill.

---

# MANDATORY WORKFLOW RULES

<rules>
<rule id="R1" severity="CRITICAL">
ALWAYS use a DEDICATED TOOL when one exists. NEVER use execute_batchplay for an operation that has its own tool.
There are 323 dedicated tools. Check this catalog FIRST.
</rule>

<rule id="R2" severity="CRITICAL">
ALWAYS verify visual results after multi-step operations using get_layer_image (single layer) or get_document_image (full composite).
Do NOT assume success from return status alone.
</rule>

<rule id="R3" severity="CRITICAL">
ALWAYS pass layer_id when calling execute_batchplay. The tool has an optional layer_id parameter that ensures the correct layer is targeted.
Without it, batchPlay may silently operate on the wrong layer.
</rule>

<rule id="R4" severity="HIGH">
For ROUNDED CORNERS on any element: use draw_rectangle_shape(corner_radius=N) + set_layer_properties(is_clipping_mask=true).
Do NOT attempt rounded rect selections via batchPlay — the corner radius keys are unreliable.
</rule>

<rule id="R5" severity="HIGH">
RASTERIZE layers before applying filters. Text, Shape, and Smart Object layers will fail silently with most filters.
Always duplicate_layer first (preserve original), then rasterize_layer on the copy.
</rule>

<rule id="R6" severity="HIGH">
SCREEN blend mode requires BLACK background, not transparent.
White on TRANSPARENT + SCREEN = invisible. White on BLACK + SCREEN = correct.
</rule>

<rule id="R7" severity="MEDIUM">

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> WHEN TO USE THIS SKILL → 1.1 COORDINATE SYSTEM → 1.2 LAYER STACK ORDER → 1.3 CANVAS ROTATION RULES → 1.4 SELECTION FUNDAMENTALS → 1.5 MASK FUNDAMENTALS
terms    -> top-left · bottom-up · Adjustment layers affect ALL layers below them · entire document · destructive · Plan filter directions BEFORE rotating · Selection MUST exist before · White = fully visible
files/cmd -> {left, top, right, bottom} · (width/2, height/2) · movelayer(position="TOP") · movelayer(position="BOTTOM") · rotatecanvas · selectall · clearselection · addlayermaskrevealall
body sha256 -> 4e3d89da1773