agentleFS
codeonym-osscodeonym-oss/design-skills/skills/photo-editing/SKILL.md

photo-editing

Skill0 starsChanged 48 days agoMITView on GitHub

Photo development and retouching with darktable 5 (RAW/JPEG development, color grading, batch styles), GIMP 3.2 (retouching, compositing), ImageMagick and exiftool (metadata), with headless batch processing in a reproducible container. Use when the user wants to edit, color-grade, batch-process, resize for web, watermark, or strip location/metadata from photos, or wants a consistent look across a photo set (portfolio, product shots, headshots).

2 other projects use a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈0

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Never edit originals: darktable keeps edits in .xmp sidecars (batch-develop.sh reuses them).

    line 39

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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

Photo editing (darktable · GIMP · exiftool)

Scripts run inside the design-skills container automatically (bash <skill-dir>/scripts/<name>.sh …, see design-sandbox). batch-develop.sh needs the full image; everything else runs in core.

Toolkit

ToolUse it forCLI (in the container)
darktable 5 (full image)Non-destructive RAW/JPEG development: exposure, color, grading, lens fixes, batch looksdesktop app · darktable-cli in.raw [edits.xmp] out.jpg --style NAME
GIMP 3.2 (full image)Pixel retouching: object removal, healing, compositingdesktop app
exiftoolRead/strip metadata (GPS!), rename by dateexiftool
ImageMagick 7Resize, sharpen, watermark, contact sheetsmagick
AI upscaling (optional, desktop)2×/4× upscaling of small or old photosUpscayl (Windows/macOS/Linux)

Scripts

ScriptWhat it does
check.shVerifies darktable-cli, GIMP, exiftool, ImageMagick; lists .dtstyle files in the folder
batch-develop.sh <style.dtstyle|name|-> <photos…>Headless darktable export, optionally applying a style, into export/ (FORMAT=jpg|tif|png|webp, WIDTH=0)
web-ready.sh <photos…> [--max 2048] [--watermark "© You"] [--quality 85]Resize, light sharpen, strip metadata, optional watermark → web/
strip-metadata.sh [--no-backup] <photos…>Removes GPS, camera serial, software tags; keeps orientation + color profile; backups as *_original
contact-sheet.sh <photos…> [-o sheet.jpg] [--cols 5]One JPEG grid of thumbnails to review/share a set

Guides

  • references/darktable-workflow.md — scene-referred workflow in darktable 5, module order, styles for consistent sets.
  • references/retouching.md — GIMP retouch recipes (object removal, headshot cleanup, sky replacement).

Rules of thumb

  1. Develop in darktable first (global look), then GIMP only for local pixel fixes — round-trip via 16-bit TIFF.
  2. Never edit originals: darktable keeps edits in .xmp sidecars (batch-develop.sh reuses them); exports go to export/.
  3. Strip metadata before publishing anything online (strip-metadata.sh or web-ready.sh).
  4. For a consistent set: grade one hero photo, save it as a style, export the .dtstyle next to the photos, apply to the rest with batch-develop.sh look.dtstyle *.raw.

Download now (ZIP)

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.