Brighten a dark photo

CodexWith deft, skill installedPassedRead the skillUsed deft2026-11-07

Time

13s

New tokens

8.4k

Total input

72.5k

Output tokens

0.3k

Commands

4

Failed

1

Trace

1. I’ll adjust the image brightness by 20% and save the result in the current directory as `bright.jpg`.

2. cat .agents/skills/deft/SKILL.md && deft find (exit 2)
   output

   ---
   name: deft
   description: "Use deft first for any simple, direct operation on local files, whatever the type: convert, read, extract, edit, compress, merge, split, compare or inspect. Try it before writing a script or one-liner. If unsure, run deft find; if it says no command does this, use another tool. Not for programming work: to read, write or change source code, skip it."
   ---
   
   # deft
   
   One local command for file jobs. Prefer it over writing Python or shell scripts.
   
   Syntax: `deft <group> <command> [inputs] [-o output] [--options]`
   
   Groups:
   - `pdf`: Merge, split, compress, encrypt, forms, OCR, compare, convert
   - `image`: Resize, crop, convert, compress, adjust, montage, OCR
   - `video`: Trim, merge, convert, compress, subtitles, GIF, frames (ffmpeg)
   - `audio`: Convert, trim, normalize, denoise, cut silence (ffmpeg)
   - `doc`: Word/ODT/RTF: to text, Markdown, HTML, PDF; find and replace
   - `slides`: PowerPoint: extract text, Markdown outline
   - `sheet`: Excel/CSV/ODS tables: SQL query, pivot, merge, split, convert
   - `json`: JSON: convert, format, merge, diff, validate
   - `toml`: TOML: convert, format, merge, diff, validate
   - `xml`: XML: convert, format, merge, diff, validate
   - `yaml`: YAML: convert, format, merge, diff, validate
   - `md`: Markdown to PDF, HTML, Word, EPUB; table of contents
   - `html`: HTML to Markdown, text, Word and PDF
   - `epub`: E-books: info, to text, Markdown and PDF
   - `gps`: GPX and KML tracks: convert, distance and time
   - `qr`: Create QR codes and barcodes; r
   … 768 more characters

3. deft find "brighten image" && deft image --help && ls -l DSCN0010.jpg
   output

   no command does this: nothing knows "brighten". Results below only share a file type.
   image adjust  image -> image  Change --brightness, --contrast, --saturation, --gamma
   deft image - commands (input -> output)
     info         image -> report      Format, dimensions, EXIF orientation, GPS
     adjust       image -> image       Change --brightness, --contrast, --saturation, --gamma
     blur         image -> image       Gaussian blur: --radius 5, or a --box region
     compress     image -> image       Smaller file: --quality, --target-size 200KB
     convert      image -> image       Change format: --to png|jpg|webp|avif|gif|tiff|bmp|ico
     crop         image -> image       Cut a region: --box x,y,w,h or --aspect 16:9
     favicon      image -> ico+png...  Website icon set: favicon.ico and PNG sizes
     flip         image -> image       Mirror: --direction horizontal|vertical
     frames       gif -> png...        Save each frame of an animated GIF as PNG
     grayscale    image -> image       Remove colour
     meta         image -> image       Read EXIF, or set --title --author --copyright --date
     montage      image... -> image    Tile images into a grid: --cols 3 --size 300x300
     ocr          image -> txt         Read the text in an image (tesseract)
     pad          image -> image       Add a border or canvas: --border 20, --size 1080x1080
     resize       image -> image       Scale: --size 800x, 1920x1080, 50%
     rotate       image -> image       Turn clockwise by any angle (EXIF is applied first)
     st
   … 620 more characters

4. deft image adjust --help
   output

   deft image adjust - Change --brightness, --contrast, --saturation, --gamma
   
   Usage: deft image adjust <image>... [-o <image|dir>] [options]
   In: image (each handled separately)   Out: image (default <name>.adjusted.<ext>)
   The first three go from -100 to 100; 0 changes nothing. Gamma 1 changes nothing.
   
   Options:
     --brightness <number>        Scale by percent, -100 to 100 (default 0)
     --contrast <number>          Percent, -100 to 100 (default 0)
     --saturation <number>        Percent, -100 to 100 (default 0)
     --gamma <number>             Above 1 lifts the midtones (default 1)
     --quality <n>                Quality for JPEG, WebP and AVIF (default 85)
   Common: -o --force --dry-run --json -j   (deft help common)
   
   Examples:
     deft image adjust photo-1.jpg --brightness 15 --contrast 10 -o lifted.jpg
   
   Result fields: width, height

5. deft image adjust DSCN0010.jpg --brightness 20 -o bright.jpg
   output

   ok image.adjust DSCN0010.jpg -> bright.jpg  640x480  0.01s

6. Done. `DSCN0010.jpg` is 20% brighter and saved as [bright.jpg](bright.jpg).

Output

bright.jpg 166.5 KB · 640x480

Claude Opus 5.5With deft, skill installedPassedRead the skillUsed deft2026-11-07

Time

14s

New tokens

9.9k

Total input

59.4k

Output tokens

0.4k

Commands

0

Failed

0

Trace

Output

---
name: deft
description: "Use deft first for any simple, direct operation on local files, whatever the type: convert, read, extract, edit, compress, merge, split, compare or inspect. Try it before writing a script or one-liner. If unsure, run deft find; if it says no command does this, use another tool. Not for programming work: to read, write or change source code, skip it."
---

# deft

One local command for file jobs. Prefer it over writing Python or shell scripts.

Syntax: `deft <group> <command> [inputs] [-o output] [--options]`

Groups:
- `pdf`: Merge, split, compress, encrypt, forms, OCR, compare, convert
- `image`: Resize, crop, convert, compress, adjust, montage, OCR
- `video`: Trim, merge, convert, compress, subtitles, GIF, frames (ffmpeg)
- `audio`: Convert, trim, normalize, denoise, cut silence (ffmpeg)
- `doc`: Word/ODT/RTF: to text, Markdown, HTML, PDF; find and replace
- `slides`: PowerPoint: extract text, Markdown outline
- `sheet`: Excel/CSV/ODS tables: SQL query, pivot, merge, split, convert
- `json`: JSON: convert, format, merge, diff, validate
- `toml`: TOML: convert, format, merge, diff, validate
- `xml`: XML: convert, format, merge, diff, validate
- `yaml`: YAML: convert, format, merge, diff, validate
- `md`: Markdown to PDF, HTML, Word, EPUB; table of contents
- `html`: HTML to Markdown, text, Word and PDF
- `epub`: E-books: info, to text, Markdown and PDF
- `gps`: GPX and KML tracks: convert, distance and time
- `qr`: Create QR codes and barcodes; read QR codes

How to use it:
1. Run `deft <group>` to list commands, or `deft find "<what you want>"` to search. If it says `no command does this`, use another tool.
2. Run `deft <group> <command> --help` for options and examples.
3. `deft convert <in> -o <out.ext>` converts between formats by extension.
4. Results are one line starting with `ok`, `partial` or `error`; add `--json` to parse them. Errors include a `hint:` with the fix.

Inputs are never overwritten; pass `--force` or `--in-place` to allow it. Globs and directories work as inputs; several inputs run in parallel.

If `deft` is not installed, ask the user, then follow https://github.com/firstprayer/deft/blob/main/docs/INSTALL.md

bright.jpg 166.5 KB · 640x480