Picture to PDF by extension

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

Time

13s

New tokens

6.8k

Total input

70.4k

Output tokens

0.4k

Commands

4

Failed

1

Trace

1. I’ll use the `deft` file conversion workflow first, then check that the PDF was created in this directory.

2. cat .agents/skills/deft/SKILL.md
   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
   … 700 more characters

3. deft image convert gallery.webp -o gallery.pdf (exit 2)
   output

   error BAD_OPTION -o gallery.pdf: deft image convert writes png, jpg, webp, gif, tiff, bmp, ico, avif
   hint: for other formats: deft convert <input> -o <name.ext>

4. deft convert gallery.webp -o gallery.pdf
   output

   ok convert gallery.webp -> gallery.pdf  via image.to-pdf  0.02s

5. ls -l gallery.pdf && file gallery.pdf
   output

   -rw-r--r--@ 1 user  staff  350025 Nov  7 00:44 gallery.pdf
   gallery.pdf: PDF document, version 1.7 (zip deflate encoded)

6. Converted `gallery.webp` to [gallery.pdf](gallery.pdf). The PDF was created successfully.

Output

gallery.pdf 341.8 KB · 1 page

CodexWith deft, skill as AGENTS.mdPassed2026-11-05

Time

10s

New tokens

8.9k

Total input

45.5k

Output tokens

0.2k

Commands

2

Failed

0

Trace

1. I’ll use the local `deft` file workflow specified for this workspace and convert the image in place to a new PDF.

2. deft image --help
   output

   deft image - commands (input -> output)
     info      image -> report  Format, dimensions, EXIF orientation, GPS
     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
     flip      image -> image   Mirror: --direction horizontal|vertical
     resize    image -> image   Scale: --size 800x, 1920x1080, 50%
     rotate    image -> image   Turn clockwise: --angle 90 (EXIF is applied first)
     strip     image -> image   Remove EXIF, GPS and text metadata
     to-pdf    image... -> pdf  One page per image, in the given order
   More: deft image <command> --help

3. deft image to-pdf gallery.webp -o gallery.pdf
   output

   ok image.to-pdf gallery.webp -> gallery.pdf  1 page  0.01s

4. Converted `gallery.webp` to [gallery.pdf](gallery.pdf). The PDF has one page.

Output

Its files were not kept in this run. The last line of the trace is its own report.

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

Time

10s

New tokens

9.2k

Total input

43.6k

Output tokens

0.3k

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

gallery.pdf 341.8 KB · 1 page