grok-searchlisted

# Grok Search Real-time web + X (Twitter) search powered by xAI's Grok agentic search tools. Grok does the searching server-side and returns ranked results with citations. This is a **deliberate, on-demand** capability — it does **not** change your default web search backend. Use it when Grok's real-time reach or native access to X/Twitter is what the moment calls for; keep using the normal `web_search` tool for everything else. ## When to load Load this skill when: - The user says "use Grok to search", "ask Grok", "search X / Twitter", or names Grok/X explicitly for a lookup. - The request is **real-time / breaking** ("what's happening with X right now", "latest reactions to Y") where a general index lags. - The request is **X/Twitter-native** ("what are people posting about Z", "what's the sentiment on X about W", "find the thread where…"). Do **not** reach for this for ordinary web research — the default `web_search` provider is better for general-purpose, index-backed queries and does not carry Grok's per-call cost. ## Prerequisites - `XAI_API_KEY` set in the profile's `~/.hermes/.env` (an xAI developer key from the xAI console). The script also accepts `--api-key`, but **prefer the env var** — a key on the command line lands in shell history and process listings. - Python 3 (stdlib only — no packages to install). If the key is missing, the script exits with a clear JSON error; tell the user a key is needed and stop, don't fall back silently. ## Usage