← Back to Skills Marketplace
utromaya-code

Gifgrep

by utromaya-code · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
126
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install gif-search-cli
Description
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
README (SKILL.md)

gifgrep

Use gifgrep to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.

GIF-Grab (gifgrep workflow)

  • Search → preview → download → extract (still/sheet) for fast review and sharing.

Quick start

  • gifgrep cats --max 5
  • gifgrep cats --format url | head -n 5
  • gifgrep search --json cats | jq '.[0].url'
  • gifgrep tui "office handshake"
  • gifgrep cats --download --max 1 --format url

TUI + previews

  • TUI: gifgrep tui "query"
  • CLI still previews: --thumbs (Kitty/Ghostty only; still frame)

Download + reveal

  • --download saves to ~/Downloads
  • --reveal shows the last download in Finder

Stills + sheets

  • gifgrep still ./clip.gif --at 1.5s -o still.png
  • gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png
  • Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
  • Tune: --frames (count), --cols (grid width), --padding (spacing).

Providers

  • --source auto|tenor|giphy
  • GIPHY_API_KEY required for --source giphy
  • TENOR_API_KEY optional (Tenor demo key used if unset)

Output

  • --json prints an array of results (id, title, url, preview_url, tags, width, height)
  • --format for pipe-friendly fields (e.g., url)

Environment tweaks

  • GIFGREP_SOFTWARE_ANIM=1 to force software animation
  • GIFGREP_CELL_ASPECT=0.5 to tweak preview geometry
Usage Guidance
This skill appears to be a thin wrapper around the gifgrep CLI and the install sources look legitimate (Homebrew + Go). However: (1) SKILL.md references GIPHY_API_KEY and TENOR_API_KEY but the registry metadata does not declare them — expect the tool to ask for or require those keys at runtime if you use the Giphy/Tenor sources. (2) Verify the Homebrew tap (steipete/tap) and the Go module repo (github.com/steipete/gifgrep) yourself before installing to ensure you trust the upstream project. (3) Be aware downloads are saved to ~/Downloads and the tool can open Finder to reveal files — grant only the filesystem access you are comfortable with. (4) Because this is instruction-only (no code bundled), the registry scanner had nothing to analyze; if you need higher assurance, inspect the upstream source code or test the binary in a sandboxed environment before providing any API keys.
Capability Analysis
Type: OpenClaw Skill Name: gif-search-cli Version: 1.0.2 The gifgrep skill is a legitimate CLI/TUI tool for searching and processing GIFs from Tenor and Giphy. The installation methods use standard package managers (Homebrew and Go), and the functionality described in SKILL.md is consistent with the tool's purpose without any indicators of data exfiltration, malicious execution, or prompt injection.
Capability Assessment
✓ Purpose & Capability
Name/description match the behavior: the skill simply invokes the gifgrep CLI to search/browse/download GIFs. The declared install methods (brew formula and Go module for github.com/steipete/gifgrep) are appropriate for delivering a gifgrep binary.
⚠ Instruction Scope
SKILL.md explicitly instructs the agent to run gifgrep commands to search, download (to ~/Downloads), reveal in Finder, and extract stills/sheets. Those actions are within the stated purpose. However, the instructions also reference environment variables (GIPHY_API_KEY required for giphy; TENOR_API_KEY optionally) and other runtime env toggles that are not listed in the skill's declared requirements — this is a mismatch and could surprise users when keys are requested or used.
✓ Install Mechanism
Installers are standard package sources: a Homebrew formula (steipete/tap/gifgrep) and a go module (github.com/steipete/gifgrep/cmd/gifgrep@latest). Neither uses arbitrary URLs or archive extraction. This is a low-risk, expected install surface for a CLI tool.
⚠ Credentials
The registry metadata lists no required environment variables, but the SKILL.md requires/mentions GIPHY_API_KEY (required for Giphy) and TENOR_API_KEY (optional). Asking for API keys for the GIF providers is proportionate to functionality, but the omission from metadata is a discrepancy that could lead to unexpected prompts or requests for secrets.
✓ Persistence & Privilege
The skill does not request always:true and is user-invocable only. It does perform file writes (saves downloads to ~/Downloads) and may call Finder to reveal files — expected behavior for a download tool and within its scope. Autonomous invocation is allowed (default) but not combined with unusual privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gif-search-cli
  3. After installation, invoke the skill by name or use /gif-search-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Version 1.0.2 of gif-search-cli - No changes detected in this release.
v1.0.0
Initial release of gifgrep – a CLI/TUI tool for searching and downloading GIFs - Search Tenor and Giphy GIF providers via CLI or TUI. - Download GIFs and extract still images or sheet grids from GIFs. - Supports previews in compatible terminals (Kitty/Ghostty). - Offers many output and formatting options, including JSON and custom fields. - Supports provider selection, API key usage, and customizable environment tweaks.
Metadata
Slug gif-search-cli
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Gifgrep?

Search GIF providers with CLI/TUI, download results, and extract stills/sheets. It is an AI Agent Skill for Claude Code / OpenClaw, with 126 downloads so far.

How do I install Gifgrep?

Run "/install gif-search-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gifgrep free?

Yes, Gifgrep is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Gifgrep support?

Gifgrep is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gifgrep?

It is built and maintained by utromaya-code (@utromaya-code); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments