Gifgrep
- 3k installs
- 385k repo stars
- Updated August 3, 2026
- steipete/clawdis
gifgrep is an agent skill for the gifgrep CLI to search GIF providers, download clips, and extract stills or frame sheets.
About
gifgrep is an agent skill for the gifgrep CLI that searches GIF providers, previews results, downloads clips, and extracts still frames or multi-frame sheets. Workflow runs search, optional TUI browse, download to ~/Downloads, and still or sheet extraction for docs, PRs, or chat sharing. Commands support Tenor and Giphy sources with API keys, JSON output, thumbnail previews on Kitty and Ghostty terminals, and provider auto selection. Sheet extraction samples frames into a single PNG grid with tunable frames, columns, and padding. Asset hygiene rules require verifying GIF URLs resolve, checking Content-Type image/gif, confirming animation, and recording attribution instead of hotlinking when local copies are needed. Install via Homebrew steipete/tap/gifgrep or go install. Use it when agents need GIF discovery, quick previews, local downloads, or frame grabs for documentation and social content.
- Search Tenor and Giphy with TUI browse, download, and JSON output modes.
- Extract still frames or multi-frame PNG sheets from local GIF files.
- Provider flags with GIPHY_API_KEY and optional TENOR_API_KEY support.
- Terminal thumbnail previews on Kitty and Ghostty with --thumbs.
- GIF asset hygiene checks for URL validity, content type, and attribution.
Gifgrep by the numbers
- 3,045 all-time installs (skills.sh)
- +158 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #70 of 550 CLI & Terminal skills by installs in the Skillselion catalog
- Security screen: MEDIUM risk (skills.sh audit)
- Data as of Aug 3, 2026 (Skillselion catalog sync)
gifgrep capabilities & compatibility
- Capabilities
- tenor and giphy search with filters and json out · tui browse and terminal thumbnail previews · gif download and finder reveal · still frame extraction at timestamps · multi frame sheet png generation · gif url validation and attribution hygiene
- Use cases
- image generation · copywriting · orchestration
What gifgrep says it does
Search -> preview -> download -> extract (still/sheet) for fast review and sharing.
Do not hotlink when a local asset is needed: download/copy it into the project and reference the local file.
npx skills add https://github.com/steipete/clawdis --skill gifgrepAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 3k |
|---|---|
| repo stars | ★ 385k |
| Security audit | 2 / 3 scanners passed |
| Last updated | August 3, 2026 |
| Repository | steipete/clawdis ↗ |
How do I find, preview, and download GIFs from Tenor or Giphy with local stills for docs and chat?
Search Tenor and Giphy for GIFs, browse in a TUI, download clips, and extract stills or frame sheets via gifgrep.
Who is it for?
Agents and creators sourcing GIFs with CLI search, TUI preview, and frame extraction.
Skip if: Skip when you need long-form video editing or non-GIF media pipelines.
When should I use this skill?
User searches GIFs, runs gifgrep TUI, downloads clips, or extracts stills or sheets from GIF files.
What you get
Downloaded GIFs plus optional still PNG or frame sheet with verified URLs and recorded attribution.
- downloaded gif files
- still frame images
Files
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 5gifgrep cats --format url | head -n 5gifgrep 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
--downloadsaves to~/Downloads--revealshows the last download in Finder
Stills + sheets
gifgrep still ./clip.gif --at 1.5s -o still.pnggifgrep 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|giphyGIPHY_API_KEYrequired for--source giphyTENOR_API_KEYoptional (Tenor demo key used if unset)
Output
--jsonprints an array of results (id,title,url,preview_url,tags,width,height)--formatfor 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 withfile,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
GIFGREP_SOFTWARE_ANIM=1to force software animationGIFGREP_CELL_ASPECT=0.5to tweak preview geometry
Related skills
Lark SharedWire Feishu/Lark Open Platform auth, tokens, and shared API helpers into agent-built bots and internal tools.493k
Runcomfy CliLet their coding agent call any RunComfy model from the terminal or scripts without managing separate SDKs.298k30
Skills CliDiscover, install, update, and manage reusable agent capabilities from the open Skillselion ecosystem directly inside their coding agent.270k72TzstCreate, extract, list, and script `.tzst` / `.tar.zst` archives from the terminal with the right compression, streaming, and conflict flags.267k72XdropPull files from an Xdrop share URL, decrypt them locally, and land outputs in a chosen directory with optional JSON for automation.266k72
WizardAuthor interactive bash setup wizards that open URLs, capture secrets, write .env upserts, and set GitHub Actions secrets step by step.92.1k193kHow it compares
Use gifgrep for terminal GIF search and frame extraction; use image generation skills when custom illustrations are needed instead of stock animated GIFs.
FAQ
Which API keys are needed?
GIPHY_API_KEY is required for --source giphy; Tenor works with an optional TENOR_API_KEY.
Where do downloads go?
Use --download to save into ~/Downloads; --reveal opens the last file in Finder.
How do I get a frame grid image?
Run gifgrep sheet with --frames, --cols, and --padding to output a PNG grid.
Is Gifgrep safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.