AGENT SKILL

gif-search

Search/download GIFs from Tenor via curl + jq.

License 许可
MIT
所属仓库
ZDStudios/AIOS
最近更新
2026-10-06
Stars
★ 7
Forks
1

01 前言 Front Matter

name
gif-search
author
Hermes Agent
license
MIT
version
1.1.0
metadata
{ "hermes": { "tags": [ "GIF", "Media", "Search", "Tenor", "API" ] } }
platforms
[ "linux", "macos", "windows" ]
description
Search/download GIFs from Tenor via curl + jq.
prerequisites
{ "commands": [ "curl", "jq" ], "env_vars": [ "TENOR_API_KEY" ] }

03 SKILL.md 正文

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):

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

# 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

# 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

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

Parameter Description
q Search query (URL-encode spaces as +)
limit Max results (1-50, default 20)
key API key (from $TENOR_API_KEY env var)
media_filter Filter formats: gif, tinygif, mp4, tinymp4, webm
contentfilter Safety: off, low, medium, high
locale Language: en_US, es, fr, etc.

Available Media Formats

Each result has multiple formats under .media_formats:

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: ![alt](url)

04 同仓库更多 Skills

ZDStudios
ZDStudios/AIOS

ruflo

Ruflo is a multi-agent orchestration platform for AI coding agents (Claude Code, Cursor, Codex, Copilot, Gemini, Amp, +12 more). Use this skill when the user wants to (1) install/init ruflo in a project, (2) run multi-agent swarms with hierarchical coordination, (3) use ruflo's 314+ MCP tools for memory, routing, hooks, sub-agents, or workflows, (4) check ruflo status/version/doctor health, or (5) discover which of ruflo's 30+ plugins fits their task.

★ 7
ZDStudios
ZDStudios/AIOS

ponytail

Forces the laziest solution that actually works, simplest, shortest, most minimal. Channels a senior dev who has seen everything: question whether the task needs to exist at all (YAGNI), reach for the standard library before custom code, native platform features before dependencies, one line before fifty. Supports intensity levels: lite, full (default), ultra. Use on ANY coding task: writing, adding, refactoring, fixing, reviewing, or designing code, and choosing libraries or dependencies. Also use whenever the user says "ponytail", "be lazy", "lazy mode", "simplest solution", "minimal solution", "yagni", "do less", or "shortest path", or complains about over-engineering, bloat, boilerplate, or unnecessary dependencies. Do NOT use for non-coding requests (general knowledge, prose, translation, summaries, recipes).

★ 7
ZDStudios
ZDStudios/AIOS

ponytail

Lazy senior dev mode for any coding task (write, refactor, fix, review): YAGNI, stdlib first, no unrequested abstractions. Not for non-coding requests.

★ 7
ZDStudios
ZDStudios/AIOS

ponytail-review

Review a diff for over-engineering. Finds what to delete: reinvented stdlib, needless deps, speculative abstractions. One line per finding.

★ 7
ZDStudios
ZDStudios/AIOS

ponytail-help

Quick reference for ponytail's modes, skills, and commands. One-shot display.

★ 7
ZDStudios
ZDStudios/AIOS

ponytail-gain

Show ponytail measured impact as a scoreboard: less code, less cost, more speed, from the benchmark medians. One-shot display.

★ 7