gifgrep

Search GIF providers, download results, and extract stills or contact sheets.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill gifgrep-amirulandalib
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/AmirulAndalib/Vilvona-AI/tree/main/skills/gifgrep
Command: npx skills add https://github.com/AmirulAndalib/Vilvona-AI --skill gifgrep-amirulandalib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding, downloading, and reviewing animated GIFs from providers like Tenor and Giphy usually requires manual browser work, and verifying that a GIF is valid and animated is tedious. This Skill wraps the gifgrep CLI/TUI so you can search, preview, download, and extract frames from GIFs directly in your workflow. ## Core Features & Use Cases - GIF Search & Download: Query Tenor or Giphy from the CLI or an interactive TUI, output JSON or pipe-friendly URLs, and save results to ~/Downloads. - Frame Extraction: Generate a single still at a given timestamp or a grid sheet of sampled frames for quick review in docs, PRs, and chat. - Asset Hygiene: Verify GIF URLs resolve with Content-Type image/gif and are actually animated, and record attribution before use. - Use Case: You need a reaction GIF for a pull request comment. Search for it, download the result, and generate a 9-frame sheet to confirm it looks right before sharing. ## Quick Start Use gifgrep to search for "office handshake" GIFs, download the top result, and extract a 9-frame sheet from it.

Frequently Asked Questions about gifgrep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and download GIFs from the command line?

Run gifgrep with a query and the --download flag, for example gifgrep cats --download --max 1. Results are saved to ~/Downloads, and --reveal shows the last download in Finder.

How do I extract frames from a GIF file?

Use gifgrep still to capture a single frame at a timestamp, or gifgrep sheet to build a PNG grid of sampled frames. Tune the sheet with --frames, --cols, and --padding options.

Does gifgrep support both Tenor and Giphy?

Yes, select the provider with --source auto, tenor, or giphy. Giphy requires a GIPHY_API_KEY environment variable, while Tenor works with a demo key if TENOR_API_KEY is unset.

How do I get GIF search results as JSON?

Pass --json to print an array of results containing id, title, url, preview_url, tags, width, and height. You can pipe it to jq, for example gifgrep search --json cats | jq '.[0].url'.

How do I verify a GIF URL is valid before using it?

Check that the URL resolves with Content-Type image/gif and contains multiple frames or loop metadata, using tools like file or identify. Record the attribution and source URL, and download a local copy instead of hotlinking.