Make a GIF

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

Time

13s

New tokens

8.5k

Total input

72.5k

Output tokens

0.4k

Commands

4

Failed

0

Trace

1. I’ll check the available media tools and the video, then create `clip.gif` in the current directory.

2. cat '.agents/skills/deft/SKILL.md' && rg --files -g 'bunny.mp4' -g '"'!*node_modules*'"' -g '"'!*.gif'"' .
   output

   ---
   name: deft
   description: "Use deft instead of writing a script for file jobs: PDF merge/split/compress/watermark, image resize/convert/compress, video and audio trim/convert/compress, spreadsheets, Markdown to PDF/HTML, and YouTube downloads and subtitles."
   ---
   
   # 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, filters, montage, OCR
   - `video`: Trim, crop, speed, convert, compress, GIF, frames (ffmpeg)
   - `audio`: Convert, trim, merge, fade, speed, tag, normalize (ffmpeg)
   - `doc`: Word/ODT/RTF: to text, Markdown, HTML, PDF; find and replace
   - `slides`: PowerPoint: extract text, Markdown outline, PDF handout
   - `data`: JSON/YAML/TOML/XML: convert, query with jq syntax, merge, diff
   - `sheet`: Excel/CSV/ODS tables: filter, sort, join, pivot, convert
   - `md`: Markdown to PDF, HTML, Word, EPUB; table of contents
   - `html`: HTML to Markdown, text, Word, PDF; screenshots
   - `epub`: E-books: info, to text, Markdown and PDF
   - `email`: EML files: headers, text, attachments
   - `contact`: VCF address books: to and from CSV
   - `calendar`: ICS calendars: to and from CSV
   - `gps`: GPX and KML tracks: convert, distance and time
   - `youtube`: Info, download, audio, subtitles, thumbnail (yt-dlp)
   - `file`: Any file: hash, duplicates, batch rename, base64, encoding
   - `qr`: Cre
   … 740 more characters

3. The file is present. I’m using `deft`’s video GIF conversion and checking its options for duration and width.

4. deft video
   output

   deft video - commands (input -> output)
     info               video -> report      Duration, size, frame rate, codecs
     add-audio          video -> video       Replace or mix the soundtrack: --audio song.mp3
     add-subtitles      video -> video       Add subtitles: burned into the picture, or --soft
     chunk              video -> video...    Cut into equal parts: --length 10:00
     compress           video -> mp4         Smaller file: --level, --target-size, --max-height
     convert            video|gif -> video   Change container and codec: --to mp4|webm|mov|mkv
     crop               video -> video       Cut a region: --box or --aspect 1:1
     download           url -> video         Save a video: --resolution 720p, --to mp4|webm|mkv [net]
     extract-audio      video -> audio       Save the soundtrack: --to mp3|m4a|wav|flac|ogg
     extract-subtitles  video -> srt|vtt     Save an embedded subtitle track: --to srt|vtt
     fade               video -> video       Fade: --fade-in 1 --fade-out 2
     frames             video -> png|jpg...  Save frames as images: --fps 1 or --at 0:05,0:10
     from-images        image... -> video    Slideshow: --duration, --fps, --audio
     merge              video... -> mp4      Join videos; --transition fades
     mute               video -> video       Remove the audio track
     pad                video -> video       Fit into a frame with bars: --size 1080x1920
     repeat             video -> video       Repeat a video: --count 3 plays it three times
     resize             vid
   … 891 more characters

5. deft video to-gif --help
   output

   deft video to-gif - Animated GIF: --fps, --size, --from, --to-time
   Same as: deft convert
   
   Usage: deft video to-gif <video>... [-o <gif|dir>] [options]
   In: video (each handled separately)   Out: gif (default <name>.<ext>)
   
   Options:
     --fps <number>               Frames per second (default 12)
     --size <size>                Output size (default: at most 480 wide)
     --from <time>                Start time (default 0)
     --to-time <time>             End time (default: end of the video)
   Common: -o --force --dry-run --json -j   (deft help common)
   
   Examples:
     deft video to-gif clip.mp4 -o clip.gif
     deft video to-gif clip.mp4 --from 0:01 --to-time 0:02 --size 240x --fps 8 -o short.gif
   Needs: ffmpeg, ffprobe

6. deft video to-gif bunny.mp4 --from 0 --to-time 3 --size 320x -o clip.gif
   output

   ok video.to-gif bunny.mp4 -> clip.gif  1.4MB  0.61s

7. Created [clip.gif](clip.gif) from the first 3 seconds of `bunny.mp4`, at 320 pixels wide.

Output

clip.gif 1.4 MB · 320x180

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

Time

11s

New tokens

9.6k

Total input

45.8k

Output tokens

0.3k

Commands

2

Failed

0

Trace

1. I’ll check the local `deft` video commands, then create `clip.gif` from the first three seconds at 320 pixels wide.

2. deft video
   output

   deft video - commands (input -> output)
     info           video -> report      Duration, size, frame rate, codecs
     compress       video -> mp4         Smaller file: --level, --target-size, --max-height
     convert        video -> video       Change container and codec: --to mp4|webm|mov|mkv
     download       url -> video         Save a video: --resolution 720p, --to mp4|webm|mkv [net]
     extract-audio  video -> audio       Save the soundtrack: --to mp3|m4a|wav|flac|ogg
     frames         video -> png|jpg...  Save frames as images: --fps 1 or --at 0:05,0:10
     merge          video... -> mp4      Join videos in order (sizes are matched to the first)
     mute           video -> video       Remove the audio track
     resize         video -> video       Scale: --size 1280x, x720, 50%
     rotate         video -> video       Turn clockwise: --angle 90
     split          video -> video       Cut out a part: --from 0:10 --to-time 0:25
     to-gif         video -> gif         Animated GIF: --fps, --size, --from, --to-time
   More: deft video <command> --help

3. deft video to-gif bunny.mp4 -o clip.gif --from 0 --to-time 3 --size 320x
   output

   ok video.to-gif bunny.mp4 -> clip.gif  1.4MB  0.69s

4. Created [clip.gif](clip.gif) from the first 3 seconds of `bunny.mp4`, scaled to 320 pixels wide.

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

11s

New tokens

10.2k

Total input

75.1k

Output tokens

0.5k

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

clip.gif 1.4 MB · 320x180