Color Change Photoshop
Use this skill to standardize image recolor requests before editing and to keep repeated product-color changes consistent.
Read references/intake-template.md before asking the user for missing details. Use the template's fields and wording whenever possible.
Workflow
- Identify the recolor target.
- Identify protected parts that must not change.
- Lock the target finish and reference color.
- Choose the execution path:
- Use AI image editing when the user wants you to directly edit a provided image.
- Use Photoshop masking workflow when the user wants a repeatable manual or semi-automatic process.
- Produce or request a case card using the template.
- Verify the result against the checklist in references/quality-checklist.md.
Input Contract
Collect these fields before editing:
source_image: local file or attachment
target_object: the part that changes color
target_color: reference image, hex value, or short color description
protected_parts: components that must stay unchanged
finish: matte, satin, glossy, powder coat, metallic, etc.
invariants: composition, angle, shadows, labels, UI, hardware details
output_notes: anything Amazon-specific, such as "main image white background"
If a user only says "change it to white," ask or infer one of these:
- reference image white
- hex or RGB white
- descriptive white such as cool white, warm white, neutral white
Editing Rules
- Change only the named target object.
- Keep protected parts completely unchanged.
- Preserve product geometry, perspective, crop, shadows, and lighting.
- Preserve mixed materials correctly: screws stay metallic, chrome rods stay chrome, screens stay lit, plastic housings stay plastic.
- Avoid repainting logos, labels, displays, or motor housings unless explicitly requested.
- Match finish as well as hue. A cool powder-coated white is different from a glossy white.
- If protected parts touch the recolor target, treat that seam as high risk and mention it in the result.
Photoshop Path
Use this path when building a repeatable local workflow:
- Open the source image.
- Duplicate the image into a working file.
- Create a target mask for the recolor object only.
- Subtract protected parts from the mask.
- Apply recolor using
Color, Hue/Saturation, Selective Color, or painted fill layers depending on the finish.
- Check seams around protected parts and metallic hardware.
- Export JPG for delivery and PSD for re-editing.
Use the workspace Photoshop helper at scripts/basic-edit-tool.jsx for quick masked recolor when the user already has a selection.
AI Edit Path
Use this path when the user gives an image and wants you to directly edit it:
- Restate the target object and protected parts.
- Include the color reference method.
- Explicitly say "change only" and "keep unchanged" for protected parts.
- Preserve original composition and lighting.
- After editing, compare against the quality checklist.
Examples
- "Change the desk frame to cool white, but keep the motor housing and controller black."
- "Turn the chair fabric beige, but keep the metal legs gold and the logo tag unchanged."
- "Make the cabinet body walnut brown, preserve handles, hinges, and countertop exactly."
Resources (optional)
scripts/
scripts/build_case_card.py: convert a loose recolor request into a standard markdown case card.
references/
references/intake-template.md: exact fields to request from the user.
references/quality-checklist.md: final review checklist for recolor work.
1---2name: color-change-photoshop3description: Recolor existing product images in Photoshop while preserving protected parts, geometry, lighting, and material details. Use when Codex needs to change a product or component color in JPG/PNG images, especially Amazon listing images such as desk frames, furniture, hardware, or accessories where some areas must stay unchanged, like controllers, motors, screws, chrome parts, or logos.4---56# Color Change Photoshop78Use this skill to standardize image recolor requests before editing and to keep repeated product-color changes consistent.910Read [references/intake-template.md](./references/intake-template.md) before asking the user for missing details. Use the template's fields and wording whenever possible.1112## Workflow13141. Identify the recolor target.152. Identify protected parts that must not change.163. Lock the target finish and reference color.174. Choose the execution path:18 - Use AI image editing when the user wants you to directly edit a provided image.19 - Use Photoshop masking workflow when the user wants a repeatable manual or semi-automatic process.205. Produce or request a case card using the template.216. Verify the result against the checklist in [references/quality-checklist.md](./references/quality-checklist.md).2223## Input Contract2425Collect these fields before editing:2627- `source_image`: local file or attachment28- `target_object`: the part that changes color29- `target_color`: reference image, hex value, or short color description30- `protected_parts`: components that must stay unchanged31- `finish`: matte, satin, glossy, powder coat, metallic, etc.32- `invariants`: composition, angle, shadows, labels, UI, hardware details33- `output_notes`: anything Amazon-specific, such as "main image white background"3435If a user only says "change it to white," ask or infer one of these:3637- reference image white38- hex or RGB white39- descriptive white such as cool white, warm white, neutral white4041## Editing Rules4243- Change only the named target object.44- Keep protected parts completely unchanged.45- Preserve product geometry, perspective, crop, shadows, and lighting.46- Preserve mixed materials correctly: screws stay metallic, chrome rods stay chrome, screens stay lit, plastic housings stay plastic.47- Avoid repainting logos, labels, displays, or motor housings unless explicitly requested.48- Match finish as well as hue. A cool powder-coated white is different from a glossy white.49- If protected parts touch the recolor target, treat that seam as high risk and mention it in the result.5051## Photoshop Path5253Use this path when building a repeatable local workflow:54551. Open the source image.562. Duplicate the image into a working file.573. Create a target mask for the recolor object only.584. Subtract protected parts from the mask.595. Apply recolor using `Color`, `Hue/Saturation`, `Selective Color`, or painted fill layers depending on the finish.606. Check seams around protected parts and metallic hardware.617. Export JPG for delivery and PSD for re-editing.6263Use the workspace Photoshop helper at [scripts/basic-edit-tool.jsx](../../../scripts/basic-edit-tool.jsx) for quick masked recolor when the user already has a selection.6465## AI Edit Path6667Use this path when the user gives an image and wants you to directly edit it:68691. Restate the target object and protected parts.702. Include the color reference method.713. Explicitly say "change only" and "keep unchanged" for protected parts.724. Preserve original composition and lighting.735. After editing, compare against the quality checklist.7475## Examples7677- "Change the desk frame to cool white, but keep the motor housing and controller black."78- "Turn the chair fabric beige, but keep the metal legs gold and the logo tag unchanged."79- "Make the cabinet body walnut brown, preserve handles, hinges, and countertop exactly."8081## Resources (optional)8283### scripts/84- `scripts/build_case_card.py`: convert a loose recolor request into a standard markdown case card.8586### references/87- `references/intake-template.md`: exact fields to request from the user.88- `references/quality-checklist.md`: final review checklist for recolor work.