How do I install the Gifgrep skill?

Run npx skillmds@latest add sheshiyer/gifgrep in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Gifgrep safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gifgrep?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gifgrep free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gifgrep?

Sheshiyer (@sheshiyer) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gifgrep by sheshiyer — Agent Skill

Name: Gifgrep
Author: Sheshiyer

Gifgrep

Search GIF providers from a CLI/TUI, download results, and extract stills or contact sheets. USE WHEN finding a GIF by keyword, downloading GIFs in bulk, grabbing a single frame as a still image, or generating a sprite/contact sheet from a GIF.

Sheshiyer Updated Sep 17, 2026

File contents

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
GIPHY_API_KEY required for --source giphy
TENOR_API_KEY optional (Tenor demo key used if unset)

Output

--json prints an array of results (id, title, url, preview_url, tags, width, height)
--format for pipe-friendly fields (e.g., url)

Environment tweaks

GIFGREP_SOFTWARE_ANIM=1 to force software animation
GIFGREP_CELL_ASPECT=0.5 to tweak preview geometry

Frequently asked questions