Agent skill

Gif Search

by NousResearch in NousResearch/hermes-agent

Search/download GIFs from Tenor via curl + jq. An agent skill from NousResearch/hermes-agent.

MITAuto-check: notes

Install Gif Search

skills CLI
$ npx skills add NousResearch/hermes-agent --skill gif-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install NousResearch/hermes-agent gif-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/NousResearch/hermes-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/media/gif-search .claude/skills/gif-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
gif-search
GitHub stars
253k
Used in
1 other repo
Token cost
~680 tokens
SKILL.md length
196 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
MIT

At a glance

Search/download GIFs from Tenor via curl + jq. An agent skill from NousResearch/hermes-agent.

  • SKILL.md covers When to use, Setup, Prerequisites and Search for GIFs, plus 5 more sections
  • Calls curl and jq; reaches tenor.googleapis.com; needs TENOR_API_KEY

What it does

Gif Search is an agent skill from NousResearch/hermes-agent. Search/download GIFs from Tenor via curl + jq.

Its SKILL.md is about 680 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: The agent that grows with you. The licence is MIT.

Example prompts

  • “/gif-search”

Requirements

  • A credential in TENOR_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit b30f95a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • tenor.googleapis.com

    Also links to:

    • developers.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • TENOR_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gif Search loads about 680 tokens when it runs. Until then it costs about 14 tokens; SKILL.md has 196 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~14
When it runs · the whole SKILL.md, loaded when a task matches
~680

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:26
    nment (add to `${HERMES_HOME:-~/.hermes}/.env`):

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from NousResearch/hermes-agent at commit b30f95a, republished under its MIT licence (© NousResearch). 196 words, ~680 tokens.

Download SKILL.mdSave it as .claude/skills/gif-search/SKILL.md (or your agent's skills folder).
name
gif-search
description
Search/download GIFs from Tenor via curl + jq.
version
1.1.0
author
Hermes Agent
license
MIT
platforms
linux, macos, windows
prerequisites.env_vars
TENOR_API_KEY
prerequisites.commands
curl, jq

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 ${HERMES_HOME:-~/.hermes}/.env):

bash
TENOR_API_KEY=your_key_here

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)
  • TENOR_API_KEY environment variable

Search for GIFs

bash
# Search and get GIF URLs
curl -s "https://tenor.googleapis.com/v2/search?q=thumbs+up&limit=5&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.gif.url'

# Get smaller/preview versions
curl -s "https://tenor.googleapis.com/v2/search?q=nice+work&limit=3&key=${TENOR_API_KEY}" | jq -r '.results[].media_formats.tinygif.url'

Download a GIF

bash
# Search and download the top result
URL=$(curl -s "https://tenor.googleapis.com/v2/search?q=celebration&limit=1&key=${TENOR_API_KEY}" | jq -r '.results[0].media_formats.gif.url')
curl -sL "$URL" -o celebration.gif

Get Full Metadata

bash
curl -s "https://tenor.googleapis.com/v2/search?q=cat&limit=3&key=${TENOR_API_KEY}" | jq '.results[] | {title: .title, url: .media_formats.gif.url, preview: .media_formats.tinygif.url, dimensions: .media_formats.gif.dims}'

API Parameters

ParameterDescription
qSearch query (URL-encode spaces as +)
limitMax results (1-50, default 20)
keyAPI key (from $TENOR_API_KEY env var)
media_filterFilter formats: gif, tinygif, mp4, tinymp4, webm
contentfilterSafety: off, low, medium, high
localeLanguage: en_US, es, fr, etc.

Available Media Formats

Each result has multiple formats under .media_formats:

FormatUse case
gifFull quality GIF
tinygifSmall preview GIF
mp4Video version (smaller file size)
tinymp4Small preview video
webmWebM video
nanogifTiny 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: ![alt](url)

© NousResearch, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/media/gif-search of NousResearch/hermes-agent.

Open the folder on GitHubat commit b30f95a

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in NousResearch/hermes-agent, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Gif Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gif Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gif Search this skillNousResearch/hermes-agent253k1 repos~680Automated safety check: NotesMIT
Video Downloadernexu-io/open-design100k—~339Automated safety check: PassApache-2.0
Video Downloadcalesthio/OpenMontage66k—~885Automated safety check: PassAGPL-3.0
Slack GIF Creatoranthropics/skills180k29 repos~2kAutomated safety check: PassApache-2.0
YouTube Video DownloaderComposioHQ/awesome-claude-skills77k9 repos~668Automated safety check: PassNone
Video Downloaderdavila7/claude-code-templates33k5 repos~660Automated safety check: PassMIT

Similar skills

  • Video Downloader

    nexu-io/open-design

    Download videos from YouTube and other platforms for offline viewing, editing, or archival with support for various formats and quality options.

    100k GitHub stars~339 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Video Download

    calesthio/OpenMontage

    Download video and audio from YouTube and 1000+ sites using yt-dlp.

    66k GitHub stars~885 tokensUpdated 7 days ago
    Media & CreativeAuto-check passed
  • Slack GIF Creator

    anthropics/skills

    Official

    Provides Slack size and frame limits, Python animation helpers and validators for building animated GIFs sized for emoji and messages.

    180k GitHub starsUsed in 29 repos~2k tokens
    Media & CreativeAuto-check passed
  • YouTube Video Downloader

    ComposioHQ/awesome-claude-skills

    Downloads a single YouTube video with chosen quality, format or audio-only MP3 output, using a bundled Python script built on yt-dlp.

    77k GitHub starsUsed in 9 repos~668 tokens
    Media & CreativeAuto-check passed
  • Video Downloader

    davila7/claude-code-templates

    Downloads videos from YouTube and other platforms for offline viewing, editing, or archival.

    33k GitHub starsUsed in 5 repos~660 tokens
    Media & CreativeAuto-check passed
  • Slack Gif Creator

    nexu-io/open-design

    Create animated GIFs optimized for Slack with validators for size constraints and composable animation primitives.

    100k GitHub stars~316 tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from NousResearch/hermes-agent

All 31 skills in this repo
  • AI Presenter Video

    NousResearch/hermes-agent

    Produces a presenter-led video from a topic or script plus one authorized presenter image, with captions, lip-sync checks and acceptance reports.

    253k GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Word DOCX Toolkit

    NousResearch/hermes-agent

    Creates, reads, edits and templates Word .docx files with python-docx scripts, including tracked changes, comments, tables of contents and health checks.

    253k GitHub stars~2.6k tokensUpdated today
    Auto-check passed
  • Grounded Citations

    NousResearch/hermes-agent

    Attaches a numbered, URL-backed citation to every outside fact in an answer or document, rejecting quotes that aren't real.

    253k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • PDF

    NousResearch/hermes-agent

    PDF files: create, read, merge, fill, OCR, edit text. An agent skill from NousResearch/hermes-agent.

    253k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Scrollcraft

    NousResearch/hermes-agent

    Premium scroll-driven landing pages; scroll = timeline. An agent skill from NousResearch/hermes-agent.

    253k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • XLSX

    NousResearch/hermes-agent

    Create, read, edit Excel .xlsx workbooks and CSVs. An agent skill from NousResearch/hermes-agent.

    253k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

Questions about Gif Search

What does Gif Search do?

Search/download GIFs from Tenor via curl + jq. An agent skill from NousResearch/hermes-agent. Gif Search is an agent skill from NousResearch/hermes-agent. Search/download GIFs from Tenor via curl + jq.

How do I install Gif Search in Claude Code?

Run `npx skills add NousResearch/hermes-agent --skill gif-search -a claude-code`. Or copy the skill folder (skills/media/gif-search in NousResearch/hermes-agent) into .claude/skills/gif-search in your project. Claude Code loads it when a task matches its description.

How do I install Gif Search in Codex?

Run `npx skills add NousResearch/hermes-agent --skill gif-search -a codex`. Or copy the skill folder (skills/media/gif-search in NousResearch/hermes-agent) into .agents/skills/gif-search in your project. Codex loads it when a task matches its description.

Can I use Gif Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add NousResearch/hermes-agent --skill gif-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gif-search, .gemini/skills/gif-search, .github/skills/gif-search and .opencode/skills/gif-search in your project.

What does Gif Search need to run?

Going by SKILL.md and its folder, Gif Search needs the command-line tools its instructions call (curl and jq) and credentials named TENOR_API_KEY. Our summary lists: A credential in TENOR_API_KEY.

Does Gif Search access the network?

SKILL.md names 2 domains. In commands or code: tenor.googleapis.com; the agent is likely to contact it when it follows the instructions. As links in the text: developers.google.com. This is read from the text; nothing was executed.

Is Gif Search safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Gif Search use?

Gif Search is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gif Search use?

About 680 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gif Search?

Skills that share tags, products or a category with Gif Search: Video Downloader (nexu-io/open-design, 100k stars), Video Download (calesthio/OpenMontage, 66k stars), Slack GIF Creator (anthropics/skills, 180k stars) and YouTube Video Downloader (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gif Search?

NousResearch (a GitHub organization) maintains it in NousResearch/hermes-agent, which has 252,613 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 11, 2026.

Source: NousResearch/hermes-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.