Agent skill

Gif Search

Search and fetch Tenor GIFs (free Tenor API key required). An agent skill from taracodlabs/aiden.

Apache-2.0Auto-check passed

Install Gif Search

skills CLI

$ npx skills add taracodlabs/aiden --skill gif-search -a claude-code

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

GitHub CLI

$ gh skill install taracodlabs/aiden 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/taracodlabs/aiden.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/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/

Paste into Claude Code

Install the "gif-search" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/gif-search into .claude/skills/gif-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gif-search", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/taracodlabs/aiden/tree/main/skills/gif-search

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add taracodlabs/aiden --skill gif-search -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden gif-search --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/gif-search .agents/skills/gif-search && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "gif-search" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/gif-search into .agents/skills/gif-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gif-search", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add taracodlabs/aiden --skill gif-search -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden gif-search --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/gif-search .cursor/skills/gif-search && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "gif-search" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/gif-search into .cursor/skills/gif-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gif-search", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/taracodlabs/aiden.git --path skills/gif-search

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add taracodlabs/aiden --skill gif-search -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden gif-search --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/gif-search .gemini/skills/gif-search && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "gif-search" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/gif-search into .gemini/skills/gif-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gif-search", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install taracodlabs/aiden gif-search

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add taracodlabs/aiden --skill gif-search -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/gif-search .github/skills/gif-search && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "gif-search" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/gif-search into .github/skills/gif-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gif-search", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add taracodlabs/aiden --skill gif-search -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install taracodlabs/aiden gif-search --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/taracodlabs/aiden.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/gif-search .opencode/skills/gif-search && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "gif-search" agent skill from https://github.com/taracodlabs/aiden/tree/main/skills/gif-search into .opencode/skills/gif-search/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gif-search", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: gif-search
GitHub stars: 852
Token cost: ~957 tokens
SKILL.md length: 258 words
Files: 2
Skills in repo: 63
Repo updated: Sep 13, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Search and fetch Tenor GIFs (free Tenor API key required). An agent skill from taracodlabs/aiden.

Works in 6 steps: Search GIFs with PowerShell (no API key… → Search GIFs with Python → Get trending GIFs → …
SKILL.md covers When to Use, How to Use, Examples and Cautions
Reaches tenor.googleapis.com and media.tenor.com; needs TENOR_API_KEY

What it does

Gif Search is an agent skill from taracodlabs/aiden. Search and fetch Tenor GIFs (free Tenor API key required)

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `skill.json`).

The repository describes itself as: Aiden — an autonomous AI agent and work engine built solo. It can operate your browser, terminal, files, apps, APIs, skills and tools, remember context, recover from failures… The licence is Apache-2.0.

Example prompts

“/gif-search”

Requirements

Python 3
A credential in TENOR_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

Search GIFs with PowerShell (no API key needed)
Search GIFs with Python
Get trending GIFs
Download a GIF to disk
Get a GIF by category (reaction types)
Use your own Tenor API key (higher rate limits)

What it can do on your machine

Read from SKILL.md and the folder at commit 3704204. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are powershell and python).
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
- media.tenor.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 957 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 258 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 taracodlabs/aiden at commit 3704204, republished under its Apache-2.0 licence (© taracodlabs). 258 words, ~957 tokens.

Download SKILL.mdSave it as .claude/skills/gif-search/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: gif-search
description: Search and fetch Tenor GIFs (free Tenor API key required)
category: media
version: 1.0.1
origin: aiden
license: Apache-2.0
tags: gif, tenor, giphy, search, media, animation, image, reaction, fun

GIF Search via Tenor

Search and fetch GIFs using the Tenor API. Obtain a free API key at https://developers.google.com/tenor/guides/quickstart (takes 2 minutes) and set it as the TENOR_API_KEY environment variable. All examples below use $env:TENOR_API_KEY (PowerShell) or os.environ["TENOR_API_KEY"] (Python).

When to Use

User wants to find a GIF for a given mood, reaction, or topic
User wants to share a GIF URL in a chat or document
User wants to download a GIF file locally
User wants to embed a GIF in a web page or email

How to Use

1. Search GIFs with PowerShell (no API key needed)

powershell

function Search-Gif($query, $limit = 5) {
  $q    = [Uri]::EscapeDataString($query)
  $url  = "https://tenor.googleapis.com/v2/search?q=$q&limit=$limit&key=$env:TENOR_API_KEY"
  $resp = Invoke-RestMethod -Uri $url
  $resp.results | ForEach-Object {
    [PSCustomObject]@{
      Title    = $_.title
      GifUrl   = $_.media_formats.gif.url
      PreviewUrl = $_.media_formats.tinygif.url
    }
  }
}

# Usage
Search-Gif "excited celebration" | Format-Table -AutoSize

2. Search GIFs with Python

python

import requests, urllib.parse

def search_gif(query, limit=5, api_key=None):
  api_key = api_key or os.environ.get("TENOR_API_KEY", "")
  params = {"q": query, "limit": limit, "key": api_key}
  resp   = requests.get("https://tenor.googleapis.com/v2/search", params=params)
  resp.raise_for_status()
  results = resp.json().get("results", [])
  return [{"title": r["title"], "url": r["media_formats"]["gif"]["url"]} for r in results]

gifs = search_gif("happy dancing")
for g in gifs:
  print(g["title"])
  print(g["url"])
  print()

powershell

$url  = "https://tenor.googleapis.com/v2/featured?limit=10&key=$env:TENOR_API_KEY"
$resp = Invoke-RestMethod -Uri $url
$resp.results | Select-Object title, @{N="url";E={$_.media_formats.gif.url}}

4. Download a GIF to disk

powershell

$gifUrl   = "https://media.tenor.com/your-gif.gif"
$outPath  = "C:\Users\<you>\Downloads\reaction.gif"
Invoke-WebRequest -Uri $gifUrl -OutFile $outPath
Write-Host "Downloaded: $outPath"

5. Get a GIF by category (reaction types)

powershell

# Categories: happy, sad, angry, love, funny, wow, thumbsup, facepalm, etc.
$category = "facepalm"
Search-Gif $category -limit 3 | Select-Object GifUrl

6. Use your own Tenor API key (higher rate limits)

powershell

$env:TENOR_API_KEY = "your_api_key_here"

function Search-Gif($query, $limit = 5) {
  $q   = [Uri]::EscapeDataString($query)
  $url = "https://tenor.googleapis.com/v2/search?q=$q&limit=$limit&key=$env:TENOR_API_KEY"
  (Invoke-RestMethod -Uri $url).results | Select-Object title, @{N="url";E={$_.media_formats.gif.url}}
}

Examples

"Find me a GIF for when tests are passing" → Use step 2 with query "success celebration cheering" and return the top result URL.

"What are trending GIFs right now?" → Use step 3 to fetch featured/trending GIFs.

"Download the first result for 'thumbs up'" → Use step 1 to search, then step 4 to download the GifUrl of the first result.

Cautions

The demo API key used in examples has low rate limits — register your own free key for production use
Tenor GIF URLs are CDN links and may not be permanently stable — don't store them long-term
GIF files can be large (1-20 MB) — check size before downloading in bulk
Always attribute Tenor as the source when displaying GIFs publicly

Files

SKILL.md and 1 other file in skills/gif-search of taracodlabs/aiden.

SKILL.md
skill.json

Open the folder on GitHubat commit 3704204

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
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Gif Search this skilltaracodlabs/aiden	852	—	~957	Automated safety check: Pass	Apache-2.0	28 days ago
Gif SearchNousResearch/hermes-agent	253k	1 repos	~680	Automated safety check: Notes	MIT	today
Requirementsrizsotto/Bear	6.5k	—	~2k	Automated safety check: Pass	GPL-3.0	3 days ago
Slack GIF Creatoranthropics/skills	180k	29 repos	~2k	Automated safety check: Pass	Apache-2.0	yesterday
LobeHub Data Fetching Layerslobehub/lobehub	83k	—	~1.8k	Automated safety check: Pass	Custom licence	today
Slack Gif Creatornexu-io/open-design	100k	—	~316	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

Gif Search
NousResearch/hermes-agent
Search/download GIFs from Tenor via curl + jq. An agent skill from NousResearch/hermes-agent.
253k GitHub starsUsed in 1 repo~680 tokens
Auto-check: notes
Requirements
rizsotto/Bear
Write, modify, or review a requirement file under docs/requirements -- pick the single owning file, keep the text contract-only, name IDs so they need no explanation, and verify cross-references and…
6.5k GitHub stars~2k tokensUpdated 3 days ago
Testing & QAAuto-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
LobeHub Data Fetching Layers
lobehub/lobehub
Explains how LobeHub client code fetches data through services, SWR store hooks and cache keys, and when to avoid useEffect fetching or duplicated state.
83k GitHub stars~1.8k tokensUpdated today
Frontend & DesignAuto-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
Gif Sticker Maker
nexu-io/open-design
Convert photos into animated GIF stickers in Funko Pop / Pop Mart style via the MiniMax API.
100k GitHub stars~305 tokensUpdated yesterday
Media & CreativeAuto-check passed

Questions about Gif Search

What does Gif Search do?

Search and fetch Tenor GIFs (free Tenor API key required). An agent skill from taracodlabs/aiden. Gif Search is an agent skill from taracodlabs/aiden.

How do I install Gif Search in Claude Code?

Run `npx skills add taracodlabs/aiden --skill gif-search -a claude-code`. Or copy the skill folder (skills/gif-search in taracodlabs/aiden) 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 taracodlabs/aiden --skill gif-search -a codex`. Or copy the skill folder (skills/gif-search in taracodlabs/aiden) 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 taracodlabs/aiden --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 credentials named TENOR_API_KEY. Our summary lists: Python 3; A credential in TENOR_API_KEY.

Does Gif Search access the network?

SKILL.md names 3 domains. In commands or code: tenor.googleapis.com and media.tenor.com; the agent is likely to contact these 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 no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Gif Search use?

Gif Search is published under the Apache-2.0 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 957 tokens (SKILL.md is roughly 3.8k 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: Gif Search (NousResearch/hermes-agent, 253k stars), Requirements (rizsotto/Bear, 6.5k stars), Slack GIF Creator (anthropics/skills, 180k stars) and LobeHub Data Fetching Layers (lobehub/lobehub, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gif Search?

taracodlabs (a GitHub organization) maintains it in taracodlabs/aiden, which has 852 GitHub stars. The repository holds 63 skills in this directory. The repository was last updated on September 13, 2026.

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

Install Gif Search

Facts

At a glance

What it does

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

GIF Search via Tenor

When to Use

How to Use

1. Search GIFs with PowerShell (no API key needed)

2. Search GIFs with Python

3. Get trending GIFs

4. Download a GIF to disk

5. Get a GIF by category (reaction types)

6. Use your own Tenor API key (higher rate limits)

Examples

Cautions

Files

Compare with similar skills

Similar skills

More from taracodlabs/aiden

Questions about Gif Search