giphy-search

Search the Giphy API for GIFs and return embeddable URLs.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/astralform-ai/skills --skill giphy-search-astralform-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: giphy-search
Source: https://github.com/astralform-ai/skills/tree/main/skills/giphy-search
Command: npx skills add https://github.com/astralform-ai/skills --skill giphy-search-astralform-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding a relevant GIF to express a reaction or emotion in a conversation requires manually browsing Giphy, copying links, and verifying they are appropriate. This Skill automates that search and returns a ready-to-use GIF URL directly in the conversation. ## Core Features & Use Cases - Giphy API Search: Queries the Giphy search endpoint with a short emotional or action phrase and returns the best-matching GIF URL. - Safe Content Filtering: Always applies the rating=g parameter so results stay safe for work. - Query Guidance: Provides a mapping of common intents (celebration, disappointment, surprise) to effective search phrases. - Use Case: A user says "congrats on shipping the release!" and the assistant responds with text plus a celebration GIF fetched from Giphy. ## Quick Start Find a celebration GIF on Giphy and include its URL in your reply.

Frequently Asked Questions about giphy-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for GIFs using the Giphy API?

Send a GET request to https://api.giphy.com/v1/gifs/search with your api_key, a URL-encoded query q, a limit, and rating=g. The GIF URL is found at data[0].images.original.url in the JSON response.

What API key do I need for Giphy GIF search?

You need a GIPHY_API_KEY environment variable containing a key from the Giphy Developers portal. Without this key set, the search endpoint cannot be called.

How do I keep Giphy search results safe for work?

Always include the rating=g parameter in the search request. This restricts results to G-rated content, which is the default behavior of this Skill for every query.

What are good search queries for reaction GIFs?

Use short emotional or action phrases like "happy dance", "mind blown", "facepalm reaction", or "celebration confetti". Concise intent-based phrases return more relevant matches than long descriptive sentences.

What happens if Giphy returns no results for a query?

If no matching GIF is found, the Skill says so and asks for different keywords rather than returning an irrelevant or off-topic GIF.