How do I install the Gifgrep skill?

Run npx skillmds@latest add tomevault-io/gifgrep-2 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. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. 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?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gifgrep by tomevault-io — Agent Skill

Name: Gifgrep
Author: tomevault-io

Gifgrep

Search GIF providers with CLI/TUI, download results, and extract stills/sheets. Use when the user wants to find a GIF, search for animated images, browse GIFs by keyword, download a GIF from Tenor or Giphy, extract a still frame from a GIF, create a contact sheet of GIF frames, or preview GIFs in the terminal. Use when this capability is needed.

tomevault-io 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

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: gifgrep-2description: Search GIF providers with CLI/TUI, download results, and extract stills/sheets. Use when the user wants to find a GIF, search for animated images, browse GIFs by keyword, download a GIF from Tenor or Giphy, extract a still frame from a GIF, create a contact sheet of GIF frames, or preview GIFs in the terminal. Use when this capability is needed.---# gifgrepUse `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 FinderStills + 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---> Converted and distributed by [TomeVault](https://tomevault.io/claim/elizaos) — claim your Tome and manage your conversions.

Frequently asked questions