用途：grok-search 通过本地 CLI 按查询检索当前公开网页（web）或 X 帖子（x），属于查询式发现工具；若要阅读或总结用户已有的 Web 或 X URL，应改用 URL 阅读器。
主要能力：每次调用只执行一次搜索。web 与 x 各返回单个 JSON 对象，包含 answer（规范化搜索结果）、sources（按 URL 去重、按首次出现顺序排列的引用，不是相关度排名）和 warnings（降级证据条件，如 invalid_citations_ignored、missing_citations，出现时结果仍可用）。
使用方式：先确认 grok-search 在 PATH 中可解析，否则停止并告知用户安装：curl -fsSL https://github.com/patrick-fu/grok-search-cli/releases/latest/download/install.sh | bash，不要主动运行安装脚本。查询通过 stdin 传入，如 printf '%s' "$query" | grok-search web 或 printf '%s' "$query" | grok-search x；仅简单单行查询可用单个位置参数。按需添加过滤器：web 支持 --allow-domain / --exclude-domain（互斥）；x 支持 --allow-handle / --exclude-handle（互斥）和 --from / --to YYYY-MM-DD，且 from 不得晚于 to。显式 --model 始终生效、只发送一次，不会静默替换；未指定时默认 grok-4.6，其他共享参数见 grok-search help。
失败处理：非零退出时在 stdout 输出 JSON 错误对象，含 error.code、error.message、error.retryable 及可选 error.http_status。退出码：0 成功、2 用法、3 认证、4 传输/提供方、70 内部。认证错误为退出码 3，应提示用户运行 grok login，未经明确同意不要代为执行。仅当用户要求更新时运行 grok-search update，搜索期间不检查更新。
限制：非官方工具，未获 xAI 认可，风险由用户承担；CLI 只读复用 Grok Build 凭据存储，不刷新也不暴露；仅限搜索，无聊天、代理、MCP 或媒体生成；不得作为共享服务运行。安装此技能不会安装二进制文件。