SKILL.md
readonly只读
name
gifgrep
description
使用命令行/TUI搜索GIF提供商,下载结果,并提取静态帧或拼图。
gifgrep
使用 gifgrep 搜索GIF提供商(Tenor/Giphy),在TUI中浏览,下载结果,并提取静态帧或拼图。
GIF-Grab(gifgrep工作流)
- 搜索 -> 预览 -> 下载 -> 提取(静态帧/拼图),便于快速查看和分享。
快速开始
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 url
TUI + 预览
- TUI:
gifgrep tui "query" - CLI静态帧预览:
--thumbs(仅Kitty/Ghostty;静态帧)
下载 + 显示
--download保存到~/Downloads--reveal在Finder中显示最后下载的文件
静态帧 + 拼图
gifgrep still ./clip.gif --at 1.5s -o still.pnggifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png- 拼图 = 采样帧的单个PNG网格(非常适合快速查看、文档、PR、聊天)。
- 调整:
--frames(数量),--cols(网格宽度),--padding(间距)。
提供商
--source auto|tenor|giphyGIPHY_API_KEY对于--source giphy是必需的TENOR_API_KEY可选(如果未设置,则使用Tenor演示密钥)
输出
--json输出结果数组(id、title、url、preview_url、tags、width、height)--format用于管道友好的字段(例如url)
GIF资产管理
- 在推荐或使用动画GIF URL之前,请验证其解析成功,具有
Content-Type: image/gif,并且实际上是动画(多帧或循环元数据;例如使用file、identify或小脚本检查)。 - 记录资产的归属/许可/来源URL。
- 当需要本地资产时,不要热链接:将其下载/复制到项目中并引用本地文件。
环境调整
GIFGREP_SOFTWARE_ANIM=1强制软件动画GIFGREP_CELL_ASPECT=0.5调整预览几何






