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.

x-search

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.