ps-advanced

Design 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 advanced techniques and reference: wind direction master table (drips down, flames up, streaks left/right with canvas…
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 “8.1 WIND DIRECTION MASTER TABLE”, “8.2 FILTER PARAMETER RANGES”, “9.1 COLOR RULES”, “9.2 TYPOGRAPHY 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-advanced 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 “8.1 WIND DIRECTION MASTER TABLE / 8.2 FILTER PARAMETER RANGES / 9.1 COLOR RULES” 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 / write / 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.

§8 TOOL REFERENCE & WIND TABLE

8.1 WIND DIRECTION MASTER TABLE

Wind only blows horizontally. Use canvas rotation for vertical effects. Now uses dedicated tool: apply_wind

Desired Effect	Canvas Rotation	Wind Call	Rotate Back	Result
Drips DOWN	-90 (CCW)	`apply_wind(method="wind", direction="left")` x5-7	+90 (CW)	Streaks downward
Flames UP	+90 (CW)	`apply_wind(method="wind", direction="left")` x3-5	-90 (CCW)	Streaks upward
Streaks RIGHT	None	`apply_wind(method="wind", direction="left")` x3-5	None	Horizontal right
Streaks LEFT	None	`apply_wind(method="wind", direction="right")` x3-5	None	Horizontal left

"left" = FROM the left = pushes pixels RIGHT. "right" = FROM the right = pushes pixels LEFT.

Wind method comparison:

"wind" = controlled thin streaks — USE THIS for drip/fire effects
"blast" = thick aggressive splatter — TOO MUCH for most effects
"stagger" = randomized jagged streaks — good for lightning/electricity

8.2 FILTER PARAMETER RANGES

Filter	Parameter	Range	Default
Gaussian Blur	radius	0.1-10000px	2.5
Motion Blur	distance	1-2000px	30
Radial Blur	amount	1-100	10
Surface Blur	radius/threshold	1-100 / 2-255	5/15
Lens Blur	radius	0-100	15
Noise	amount	0.1-400%	5
Wave	generators/wavelength/amplitude	1-999 / 1-999 / 1-999	5/10-120/5-35
Unsharp Mask	amount/radius/threshold	1-500% / 0.1-1000px / 0-255	100/1.0/0
High Pass	radius	0.1-1000px	10
Wind	method	wind/blast/stagger	wind
Liquify	brush_size	1-15000px	64

§9 DESIGN PRINCIPLES

9.1 COLOR RULES

60-30-10 Rule: 60% dominant, 30% secondary, 10% accent

9.2 TYPOGRAPHY RULES

Max 2 fonts per design (3 absolute max)
Title: 2-3x body size minimum
ALL CAPS: add tracking +50 to +200
Never use Thin/Light below 24pt

9.3 COMPOSITION

Rule of Thirds: focal point at grid intersections
Z-Pattern: Logo top-left → headline top → image bottom-left → CTA bottom-right

9.4 CONTRAST & READABILITY

Body text: minimum 4.5:1 contrast ratio
Text on images: 50-70% black overlay, or blur background
Dark bg: off-white (224,225,221) not pure white

9.5 DIMENSIONS

Platform	Size
Instagram Post	1080x1080
Instagram Story/Reel	1080x1920
Twitter/X	1600x900
YouTube Thumb	1280x720
LinkedIn	1200x627
A4 Print (300dpi)	2480x3508

§10 WORKFLOW TEMPLATES

10.1 POSTER CREATION

1. Create canvas (correct dimensions + DPI)
2. Place background image
3. Color grade: curves + color_balance + vibrance
4. Cut out subject: select_subject → mask OR remove_background
5. Add main text → apply text effects (§5)
6. Add secondary text (subtitle, credits)
7. Final color harmony: unified color overlay SOFT_LIGHT 10-20%
8. Verify with get_document_image
9. Export: save_document_as

10.2 PHOTO EDIT

1. Open → duplicate background
2. auto_tone / auto_color OR manual curves+levels
3. Skin retouch: apply_spot_healing_brush or frequency separation (§6.12)
4. Color grade (§7)
5. Local adjustments: apply_dodge_tool / apply_burn_tool
6. Sharpen: apply_high_pass OVERLAY (§11.1)
7. Vignette (§6.8)
8. Optional apply_noise 2-3% OVERLAY
9. Export

10.3 COMPOSITE

1. Background plate
2. Subject (select_subject or remove_background)
3. Match lighting: harmonize_layer OR manual curves
4. Cast shadow: duplicate → flip vertical → blur → MULTIPLY 30-40%
5. Color unification: photo_filter or solid fill SOFT_LIGHT 10-15%
6. Final adjustments

§11 ADVANCED TECHNIQUES

11.1 HIGH-PASS SHARPENING

stamp_visible → apply_high_pass(radius=2-5) → set_layer_properties(blend_mode="OVERLAY") → opacity 50-80%

11.2 DODGE & BURN (non-destructive)

create_pixel_layer(fill_neutral=true, blend_mode="OVERLAY") → paint WHITE to dodge, BLACK to burn, opacity 10-15% per stroke

11.3 ORTON EFFECT (dreamy glow)

stamp_visible → apply_gaussian_blur(radius=20-40) → SCREEN 40-60%

11.4 BLEND-IF COMPOSITING

set_layer_blend_if for seamless tone-based blending:

Remove dark bg: this_layer_black=20, black_feather=50
Show in bright areas: underlying_white=180, white_feather=220

11.5 LUMINOSITY MASKING

Load RGB as selection via batchplay → save as Highlights channel → invert for Shadows

11.6 STAMP VISIBLE

stamp_visible = flattened copy of all visible layers as new layer on top. Use BEFORE destructive effects.

§12 CRITICAL TOOL GOTCHAS — 17 VERIFIED

These are verified bugs/behaviors that WILL cause failures if ignored:

select_layer CAN DELETE LAYERS — Use set_layer_properties or execute_batchplay to target layers instead
set_layer_properties RESETS clipping mask — Always pass is_clipping_mask=false (or true if clipped) to preserve state
place_image always throws error — But the layer IS created. Ignore the error and continue.
VIVID_LIGHT blend mode is rejected — MCP tool doesn't support it. Use batchplay.
scale_layer fails silently on Smart Objects — Use free_transform instead
generate_image/generative_fill return success but produce nothing — Adobe Firefly AI tools unreliable in MCP
Canvas rotation affects ALL layers — Every layer rotates. Plan accordingly.
apply_wind only blows HORIZONTALLY — Use canvas rotation for vertical effects (see §8.1)
Filters require rasterized layers — Text, shape, Smart Object layers will fail. Always rasterize first.
translate_layer Y axis — Positive Y moves DOWN (standard screen coords)
SCREEN blend requires BLACK background — White on transparent + SCREEN = invisible.
Wind "blast" method is TOO aggressive — Use "wind" method for controlled streaks.
Global Light is shared — Bevel and Drop Shadow share angle by default.
File tokens required for file paths — batchPlay won't trust raw file paths in some contexts.
All modifying batchPlay in UXP needs executeAsModal — Direct execution without modal wrapper will fail silently.
Blur Gallery may force dialog — Field/Iris/Tilt-Shift/Spin/Path blur may open dialog despite suppression.
Camera Raw Filter NOT scriptable headless — Always requires dialog. Use Curves + Levels + Color Balance instead.

§13 FAILED ATTEMPTS LOG — DO NOT REPEAT

#	What Went Wrong	Correct Approach
1	Wave distorted entire text horizontally	Use Wind (directional) not Wave
2	Stretch 400% + blur + wave = sideways	Wind + canvas rotation
3	Motion blur 90 = streams UP and DOWN	Wind is one-directional (not symmetric)
4	Rotate +90 CW + Wind right = UP	-90 CCW + Wind left = DOWN
5	White on TRANSPARENT + SCREEN	White on BLACK + SCREEN
6	Wind "blast" x10 = off-canvas	"wind" method x 5-7

§14 OUTER GLOW PARAMETER REFERENCE

Parameter	Range	Default	Notes
BlendMode	any	SCREEN	SCREEN for glow, MULTIPLY for dark halo
Opacity	0-100%	75
Noise	0-100%	0	Adds texture to glow
Color	RGB	yellow	Single color
Spread	0-100%	0	Higher = more solid center
Size	0-250px	5	Blur radius of glow

§15 QUALITY CHECKLIST

Before finalizing ANY design:

Text is readable at target viewing distance
Color palette has max 3-5 colors (60-30-10 rule)
Visual hierarchy is clear (title → image → details)
White space is sufficient
All effects look intentional (not overdone)
No artifacts from filter operations
Layer order is logical (bg → subject → text → effects → adjustments)
Canvas dimensions match target platform
Verified with get_document_image or get_layer_image

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

Fluxly category: Design
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
Write / modify
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-advanced.preview

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

SKILL.md SKILL.md

# §8 TOOL REFERENCE & WIND TABLE

## 8.1 WIND DIRECTION MASTER TABLE

Wind only blows horizontally. Use canvas rotation for vertical effects.
**Now uses dedicated tool: `apply_wind`**

| Desired Effect | Canvas Rotation | Wind Call                                           | Rotate Back | Result           |
| -------------- | --------------- | --------------------------------------------------- | ----------- | ---------------- |
| Drips DOWN     | -90 (CCW)       | `apply_wind(method="wind", direction="left")` x5-7  | +90 (CW)    | Streaks downward |
| Flames UP      | +90 (CW)        | `apply_wind(method="wind", direction="left")` x3-5  | -90 (CCW)   | Streaks upward   |
| Streaks RIGHT  | None            | `apply_wind(method="wind", direction="left")` x3-5  | None        | Horizontal right |
| Streaks LEFT   | None            | `apply_wind(method="wind", direction="right")` x3-5 | None        | Horizontal left  |

**"left" = FROM the left = pushes pixels RIGHT. "right" = FROM the right = pushes pixels LEFT.**

**Wind method comparison:**

- "wind" = controlled thin streaks — **USE THIS** for drip/fire effects
- "blast" = thick aggressive splatter — TOO MUCH for most effects
- "stagger" = randomized jagged streaks — good for lightning/electricity

## 8.2 FILTER PARAMETER RANGES

| Filter        | Parameter                       | Range                       | Default       |
| ------------- | ------------------------------- | --------------------------- | ------------- |
| Gaussian Blur | radius                          | 0.1-10000px                 | 2.5           |
| Motion Blur   | distance                        | 1-2000px                    | 30            |
| Radial Blur   | amount                          | 1-100                       | 10            |

…

Evidence boundary and execution chain

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

sections -> 8.1 WIND DIRECTION MASTER TABLE → 8.2 FILTER PARAMETER RANGES → 9.1 COLOR RULES → 9.2 TYPOGRAPHY RULES → 9.3 COMPOSITION → 9.4 CONTRAST & READABILITY
terms    -> Now uses dedicated tool: applywind · Wind method comparison · USE THIS · 60-30-10 Rule · Max 2 fonts · Title: 2-3x body size · ALL CAPS: add tracking +50 to +200 · Never use Thin/Light below 24pt
files/cmd -> applywind · applywind(method="wind", direction="left") · applywind(method="wind", direction="right") · stampvisible · applyhighpass(radius=2-5) · setlayerproperties(blendmode="OVERLAY") · createpixellayer(fillneutral=true, blendmode="OVERLAY") · applygaussianblur(radius=20-40)
body sha256 -> c8f257d6b3d9