Agent skill · software engineering · steipete
gifgrep
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Why this skill is useful
Provides niche commands and workflows for searching and downloading GIFs that the AI wouldn't reliably generate on its own.
What it needs
Requires gifgrep installed locally. Requires giphy, tenor account access. About 1k tokens when loaded. Last updated 2026-08-07. 385,400 stars on the source repository.
What this skill does
gifgrep Use gifgrep to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets. GIF-Grab (gifgrep workflow) Search -> preview -> download -> extract (still/sheet) for fast review and sharing. Quick start gifgrep cats --max 5 gifgrep cats --format url head -n 5 gifgrep search --json cats jq '.[0].url' gifgrep tui "office handshake" gifgrep cats --download --max 1 --format url TUI + previews TUI: gifgrep tui "query" CLI still previews: --thumbs (Kitty/Ghostty only; still frame) Download + reveal --download saves to ~/Downloads --reveal shows the last download in Finder Stills + sheets gifgrep still ./clip.gif --at 1.5s -o still.png gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat). Tune: --frames (count), --cols (grid width), --padding (spacing). Providers --source auto tenor giphy GIPHYAPIKEY required for --source giphy TENORAPIKEY optional (Tenor demo key used if unset) Output --json prints an array of results (id, title, url, previewurl, tags, width, height) --format for pipe-friendly fields (e.g., url) GIF asset hygiene Before recommending or using an animated GIF URL, verify it resolves successfully, has Content-Type: image/gif, and is actually animated (multiple frames or loop metadata; e.g. inspect with file, identify, or a small script). Record attribution/license/source URL alongside the asset. Do not hotlink when a local asset is needed: download/copy it into the project and reference the local file. Environment tweaks GIFGREPSOFTWAREANIM=1 to force software animation GIFGREPCELLASPECT=0.5 to tweak preview geometry
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/gifgrep