x-search

name: x-search description: Use when searching X/Twitter posts, profiles, threads, reactions, rumors, or current discussion by delegating the lookup to Hermes Agent with its built-in x_search tool. Triggers on "X で検索", "ツイート検索", "X で何て言われてる", "search X for", "what's the buzz on X about", and @handle recent-post lookups.

Delegate X (Twitter) search to Hermes Agent's x_search toolset. This is the required path for search-only X/Twitter lookups, current-discussion checks, profile/post discovery, reactions, rumors, and X-based summaries.

Never use xurl for X/Twitter search or discovery. xurl is only for explicit account operations or known-post/API operations when the user specifically asks for them.

Required Command Shape

Run Hermes in oneshot mode with only the x_search toolset enabled:

~/.local/bin/hermes -t x_search -z '<prompt>'

This root-level -z / --oneshot form prints only the final response text. Do not omit -t x_search; otherwise Hermes may choose non-X tools or the xurl skill.

Prompt Template

The prompt must constrain Hermes to x_search and forbid xurl:

Use x_search to search X/Twitter for: <query>.
Do not use xurl. Do not use web_search or browser tools.
If the request includes @handles, use allowed_x_handles where appropriate.
If the request includes dates, apply from_date/to_date in YYYY-MM-DD.
Return: concise findings, notable posts/accounts, and source URLs/citations.

Handling User Filters

Translate natural-language filters into the prompt before calling Hermes:

@handle filters to include -> tell Hermes to use allowed_x_handles.
Explicit exclusions -> tell Hermes to use excluded_x_handles.
Relative dates such as "today", "yesterday", "this week", "今日", or "今週" -> resolve to exact YYYY-MM-DD dates before calling Hermes.
Media-bearing posts -> ask Hermes to enable image or video understanding only when relevant.

Keep the initial query narrow. If results are too broad, run a second Hermes query with tighter terms or date bounds rather than expanding the toolset.

Reporting Back To The User

Summarize Hermes output in the user's language.
Include direct X post URLs or citations when Hermes provides them. Do not synthesize URLs.
If Hermes reports missing xAI credentials or unavailable x_search, tell the user to run:
```
~/.local/bin/hermes auth add xai-oauth
```
Then stop. Do not inspect credential files and do not fall back to xurl, web search, or browser-based X readers.

What This Skill Is Not

Not for fetching a known X URL's contents.
Not for general web search.
Not for posting to X.