gif-search
Skill1 starsChanged 4 months agoMITView on GitHub
Use when the user wants a GIF for a message or reaction — including a specific reaction GIF (facepalm, thumbs up, celebration) — found and downloaded via the Tenor API.
- Reads credentials
17 other projects use a version of this.
Adopted by
Most recently taken up by
- rakaarwaky/agents-arwakytheir own version, first seen Nov 8, 2026
- delorenj/skillstheir own version, first seen Nov 7, 2026
- Stuko0/alice-agenttheir own version, first seen Oct 13, 2026
- nobodyohm-web/Thottheir own version, first seen Oct 13, 2026
- Tommy-yw/RunbookHermestheir own version, first seen Oct 8, 2026
- RedWoodOG/Hermes-Desktoptheir own version, first seen Oct 8, 2026
Other versions17 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 17
- math-inc/OpenGauss★ 1.3ksame name
- Tommy-yw/RunbookHermes★ 546same name
- RedWoodOG/Hermes-Desktop★ 177same name
- wundercorp/loki★ 28same name
- delorenj/skills★ 17same name
- Samin12/skills★ 8same name
- claude-world/claude-agent★ 5same name
- john-data-chen/hermes-agent-backup★ 2same name
- rmusser01/tldw-stuff★ 2same name
- tunnckoCore/skills★ 2same name
7 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository58 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- api-test-suiteSkill
- ascii-artSkill
- caddy-reverse-proxySkill
- changelog-generatorSkill
- color-palette-generatorSkill
- cron-taskSkill
- csv-toolkitSkill
- discord-bot-buildSkill
- docker-umbrellaSkill
- dotfiles-manageSkill
- email-sendSkill
- env-config-managerSkill
- excalidraw-diagramSkill
- file-organizerSkill
- forgejo-self-hostSkill
- frontend-design-toolkitSkill
- generate-dockerfileSkill
- git-backupSkill
- github-actions-ciSkill
- hallmark-readmeSkill
- http-api-testerSkill
- invoice-generatorSkill
- json-formatterSkill
- log-analyzerSkill
- markdown-linterSkill
- markdown-to-pdfSkill
- markdown-to-slidesSkill
- mcp-server-buildSkill
- media-id-mappingSkill
- movie-catalogue-siteSkill
- movie-night-calendarSkill
- ntfy-notifierSkill
- ocr-documentsSkill
- ollama-localSkill
- openapi-generatorSkill
- password-generatorSkill
- pdf-extractSkill
- portfolio-upkeepSkill
- qr-code-generatorSkill
- regex-testerSkill
- resume-builderSkill
- rss-monitorSkill
- searxng-self-hostSkill
- skill-publishSkill
- skill-registry-catalogSkill
- skills-portfolio-scaffoldSkill
- snippet-managerSkill
- sqlite-dashboardSkill
- streaming-provider-embedsSkill
- tailscale-deploySkill
- telegram-bot-buildSkill
- tmdb-metadataSkill
- uptime-kuma-self-hostSkill
- watchlist-syncSkill
- webhook-receiverSkill
- youtube-transcriptSkill
The file
We split this skill into the rules it gives an agent
2 rules. 0 are common, 2 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 17 edited versions we read keep these.
2
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 17
Search and download animated GIFs from Tenor's API.
- Distinctive: line 133
Search Tenor with the query
“Common” is measured: kept by at least 6 in 10 of the 17 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
gif-search
Overview
Search and download animated GIFs from Tenor's API. The agent finds GIFs by keyword, previews results, and downloads the selected GIF to a local file.
When to Use
- The user wants a GIF for a message or reaction.
- The user wants to find a specific reaction GIF (facepalm, thumbs up, celebration).
- The user says "find me a GIF", "search for a GIF", or "I need a reaction GIF".
Prerequisites
A Tenor API key. Get one free at https://developers.google.com/tenor/guides/quickstart
# Store the key as an environment variable
export TENOR_API_KEY="your_key_here"Search for GIFs
import requests
import os
def search_gifs(query: str, limit: int = 10, pos: str = "") -> list:
"""Search Tenor for GIFs matching the query."""
api_key = os.environ.get("TENOR_API_KEY", "")
params = {
"q": query,
"key": api_key,
"limit": limit,
"media_filter": "gif",
"contentfilter": "medium",
}
if pos:
params["pos"] = pos
resp = requests.get("https://tenor.googleapis.com/v2/search", params=params)
resp.raise_for_status()
data = resp.json()
results = []
for item in data.get("results", []):
gif_url = None
for media in item.get("media_formats", []):
if media.get("gif"):
gif_url = media["gif"]["url"]
break
if gif_url:
results.append({
"id": item.get("id"),
"title": item.get("title", ""),
"url": gif_url,
"preview": item.get("media_formats", [{}])[0].get("tinygif", {}).get("url", ""),
})
return resultsDownload a GIF
def download_gif(url: str, output_path: str) -> str:
"""Download a GIF to a local file."""
resp = requests.get(url, stream=True)
resp.raise_for_status()
with open(output_path, "wb") as f:
for chunk in resp.iter_content(chunk_size=8192):
f.write(chunk)
return output_pathFull Workflow
# 1. Search for GIFs
results = search_gifs("facepalm", limit=5)
# 2. Show options to the user
for i, r in enumerate(results):
print(f"{i}: {r['title']} — {r['url']}")
# 3. User picks one
choice = 2
selected = results[choice]
# 4. Download
path = download_gif(selected["url"], "facepalm.gif")
print(f"Downloaded to {path}")Trending GIFs
def trending_gifs(limit: int = 10) -> list:
"""Get currently trending GIFs."""
api_key = os.environ.get("TENOR_API_KEY", "")
params = {"key": api_key, "limit": limit, "media_filter": "gif"}
resp = requests.get("https://tenor.googleapis.com/v2/featured", params=params)
resp.raise_for_status()
# Same parsing as search_gifs
...Categories
def categories() -> list:
"""Get available GIF categories."""
api_key = os.environ.get("TENOR_API_KEY", "")
params = {"key": api_key, "type": "featured"}
resp = requests.get("https://tenor.googleapis.com/v2/categories", params=params)
return resp.json().get("tags", [])Workflow
- Get the search query from the user
- Search Tenor with the query
- Present top 5-10 results (title + URL) to the user
- User picks one
- Download the selected GIF to a local file
- Return the file path
Common Pitfalls
- No API key — Without a Tenor API key, all requests fail. Get one at https://developers.google.com/tenor/guides/quickstart (free).
- Content filter — Tenor returns NSFW content by default if no filter is set. Use
contentfilter=mediumorcontentfilter=highto keep results safe. - Rate limits — Tenor's free tier allows ~100 requests per minute. For normal use this is plenty.
- GIF size — Full GIFs can be 5-20 MB. If you need smaller files, use the
tinygifornanogifmedia format instead ofgif. - API version — Tenor has v1 and v2 APIs. v2 is current. v1 is deprecated but still works. Always use
tenor.googleapis.com/v2/. - Attribution — Tenor doesn't require attribution, but linking back to the Tenor page is good practice.
Verification Checklist
TENOR_API_KEYis set and a test search returns results, not an auth errorcontentfilterset tomediumorhighbefore showing results to the user- Downloaded file is a valid, non-zero-size GIF at the expected path
- Media format chosen (
gifvstinygif/nanogif) matches the size constraint the use case needs
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

