Gif Hunter

The problem

Finding the right GIF for documentation, presentations, or chat responses usually requires leaving your terminal or editor to browse cluttered websites. Manually searching, downloading, and checking dimensions takes too much time for a simple reaction or illustration.

What it does

• Searches the Tenor API using specific keywords and filters for tone and safety.
• Filters results by media format, aspect ratio, and dimensions to ensure the file fits the destination.
• Handles URL encoding and API authentication via environment variables.
• Downloads selected GIFs directly to local storage using curl and verifies file integrity with jq.

Frameworks & tools

Tenor API, curl, jq, and standard Unix shell utilities.

Why this beats prompting it yourself

Standard LLMs often hallucinate dead image links or point to web pages instead of direct asset URLs. This skill provides a deterministic pipeline that validates the API response, checks file dimensions, and confirms the download succeeded before presenting the result.

Use cases

• Find a "celebration" GIF for a team Slack announcement.
• Fetch an animated "how-to" illustration for a technical README.
• Locate specific aspect-ratio GIFs for presentation slides.
• Automate reaction GIF selection for bot-driven notifications.

Known limitations

Requires a Tenor API key and the jq utility installed on the system. Not intended for long-form video or static image formats.