sandraschisandraschi/gimp-mcp/skills/gimp-expert/SKILL.md

gimp-expert

Skill3 starsChanged 4 months agoMITView on GitHub

Professional image editing with GIMP 3 via portmanteau tools, PDB proxy, batch pipelines, and live bridge workflows.

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.

≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.

Common
Distinctive
Very specific

Very specific:
When sampling is available, use gimp_agentic_workflow for a one-shot plan, then execute with portmanteau tools.
line 11
Very specific:
Prefer copy-on-write outputs (output_path distinct from input_path).
line 49
Distinctive:
If GIMP is headless-only, avoid live UI assumptions.
line 50

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.

Files

SKILL.md

GIMP MCP Expert

When to use

Multi-step edits (load → transform → color → export) with explicit paths.
Batch folders: always set separate output directories; never overwrite masters.
When sampling is available, use gimp_agentic_workflow for a one-shot plan, then execute with portmanteau tools.
For operations not covered by the 8 portmanteaus, use the gimp_pdb universal proxy to call any GIMP PDB procedure directly.

Portmanteau tools

Tool	Role
`gimp_file`	load, save, convert, info, validate, list_formats
`gimp_transform`	resize, crop, rotate, flip, scale, perspective, autocrop
`gimp_color`	brightness_contrast, levels, curves, hue_saturation, …
`gimp_filter`	blur, sharpen, noise, artistic, …
`gimp_layer`	create, duplicate, merge, flatten, …
`gimp_analysis`	quality, statistics, histogram, compare, …
`gimp_batch`	folder resize/convert/watermark
`gimp_system`	status, help, diagnostics, version
`gimp_pdb`	Universal PDB proxy — call any GIMP procedure by name (selections, text, channels, plug-ins, etc.)
`gimp_workspace`	list images, undo/redo, undo groups, metadata, resolution
`gimp_channel`	create, delete, list, set color/opacity, duplicate channels
`gimp_animation`	list frames, set delay, optimize/export GIF
`gimp_paths`	create, delete, stroke, import/export SVG, vector paths
`gimp_parasites`	XCF metadata: list, attach, detach parasites on images/drawables
`gimp_gmic`	G'MIC filter integration — 500+ filters via plug-in-gmic
`gimp_gegl`	GEGL non-destructive editing operations
`gimp_color_management`	ICC profiles, assignment, conversion, soft proofing

gimp_pdb

A generic escape hatch that accepts a procedure name (e.g. gimp-selection-all, plug-in-gauss, gimp-text-layer-set-font) and optional positional args. Runs via Live Bridge (TCP to running GIMP) or Headless CLI (batch mode). Use this for any operation not yet wrapped by the 8 domain tools.

Examples

gimp_pdb("gimp-selection-all", [image_id]) — select entire image
gimp_pdb("gimp-selection-feather", [image_id, 5.0]) — feather selection
gimp_pdb("gimp-text-layer-set-font", [layer_id, "Arial"]) — change text font
gimp_pdb("plug-in-gauss", [image_id, layer_id, 5.0, 5.0, 0]) — Gaussian blur

Safety

Respect allowed_directories in server config.
Prefer copy-on-write outputs (output_path distinct from input_path).
If GIMP is headless-only, avoid live UI assumptions; use CLI/script-fu operations.

FastMCP 3.2

Resources: resource://gimp/documentation/llms, resource://gimp/documentation/capabilities
Skills: this file at skill://gimp-expert/SKILL.md
Prompts: gimp_edit_session, gimp_batch_folder_prep, gimp_color_grading_pass, gimp_agentic_sampling_hint
Prefab: gimp_capabilities_card (rich UI in capable hosts)

Download now (ZIP)

In this repository8 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- .cursor/rules/architect.mdcCursor rule
- llms-full.txtllms.txt
- llms.txtllms.txt
- full-stack-developerSkill
- mcp-server-architectSkill

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free