skills/gifgrep/SKILL.md
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
npx skillsauth add Bitterbot-AI/bitterbot-desktop gifgrepInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Use gifgrep to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.
GIF-Grab (gifgrep workflow)
Quick start
gifgrep cats --max 5gifgrep cats --format url | head -n 5gifgrep search --json cats | jq '.[0].url'gifgrep tui "office handshake"gifgrep cats --download --max 1 --format urlTUI + previews
gifgrep tui "query"--thumbs (Kitty/Ghostty only; still frame)Download + reveal
--download saves to ~/Downloads--reveal shows the last download in FinderStills + sheets
gifgrep still ./clip.gif --at 1.5s -o still.pnggifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png--frames (count), --cols (grid width), --padding (spacing).Providers
--source auto|tenor|giphyGIPHY_API_KEY required for --source giphyTENOR_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 animationGIFGREP_CELL_ASPECT=0.5 to tweak preview geometrydevelopment
When the agent calls memory_search with a relationship-shaped query ("who did I talk to about X"), redirect to the knowledge_graph backend where it will actually find the answer.
testing
Forces a memory_search before the agent sends a message containing a factual assertion that has not yet been grounded this turn. Closes the citation-rate gap from ~40% to ~90%+.
business
Enforces PROTOCOLS.md "stay quiet in group chats" deterministically. Blocks outbound messages in Discord/Telegram/Slack/etc group channels when the bot was not @mentioned and recently spoke.
development
When the agent's epistemic state (GCCRF) indicates low empowerment and falling certainty, hedges out confident absolutes ("definitely", "always", "100%") in outgoing messages.