gifgrep
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Best use case
gifgrep is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Teams using gifgrep should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/gifgrep/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How gifgrep Compares
| Feature / Agent | gifgrep | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# 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
Related Skills
xurl
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.
weather
Get current weather and forecasts via wttr.in or Open-Meteo. Use when: user asks about weather, temperature, or forecasts for any location. NOT for: historical weather data, severe weather alerts, or detailed meteorological analysis. No API key needed.
wacli
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
video-frames
Extract frames or short clips from videos using ffmpeg.
trello
Manage Trello boards, lists, and cards via the Trello REST API.
tmux
Remote-control tmux sessions for interactive CLIs by sending keystrokes and scraping pane output.
things-mac
Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database). Use when a user asks Understudy to add a task to Things, list inbox/today/upcoming, search tasks, or inspect projects/areas/tags.
summarize
Summarize or extract text/transcripts from URLs, podcasts, and local files (great fallback for “transcribe this YouTube/video”).
spotify-player
Terminal Spotify playback/search via spogo (preferred) or spotify_player.
sonoscli
Control Sonos speakers (discover/status/play/volume/group).
songsee
Generate spectrograms and feature-panel visualizations from audio with the songsee CLI.
slack
Use when you need to control Slack from Understudy via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.