Agent skill · nousresearch
gif-search
Search/download GIFs from Tenor via curl + jq.
What it needs
About 1k tokens when loaded.
What this skill does
GIF Search (Tenor API) Search and download GIFs directly via the Tenor API using curl. No extra tools needed. When to use Useful for finding reaction GIFs, creating visual content, and sending GIFs in chat. Setup Set your Tenor API key in your environment (add to ${HERMESHOME:-~/.hermes}/.env): Get a free API key at https://developers.google.com/tenor/guides/quickstart — the Google Cloud Console Tenor API key is free and has generous rate limits. Prerequisites curl and jq (both standard on macOS/Linux) TENORAPIKEY environment variable Search for GIFs Download a GIF Get Full Metadata API Parameters Parameter Description ----------- ------------- q Search query (URL-encode spaces as +) limit Max results (1-50, default 20) key API key (from $TENORAPIKEY env var) mediafilter Filter formats: gif, tinygif, mp4, tinymp4, webm contentfilter Safety: off, low, medium, high locale Language: enUS, es, fr, etc. Available Media Formats Each result has multiple formats under .mediaformats: Format Use case -------- ---------- gif Full quality GIF tinygif Small preview GIF mp4 Video version (smaller file size) tinymp4 Small preview video webm WebM video nanogif Tiny thumbnail Notes URL-encode the query: spaces as +, special chars as %XX For sending in chat, tinygif URLs are lighter weight GIF URLs can be used directly in markdown:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/gif-search--134882