Basic Invocation
The/grok-x skill gives you real-time X intelligence directly inside Claude Code. The most basic way to use it is:
Make sure you’ve completed the installation and added your xAI API key to
~/.claude/settings.json before proceeding.Your First Query
Ask a simple question
Start with a basic X search to see what’s happening:Grok uses its native
x_search tool to query the live X platform and returns a structured analysis.Monitor a specific account
Track what a particular user is posting about:The
--handles flag focuses exclusively on specific accounts (up to 10). The @ symbol is optional.Common Patterns
Quick Lookup
For simple, fast queries, use the--fast flag to select grok-4-1-fast-non-reasoning:
Date Range Search
Filter posts by date using--from and --to:
YYYY-MM-DD format.
Monitor Multiple Accounts
Track up to 10 specific accounts in one query:@ is optional.
Exclude Noise
Filter out specific accounts you don’t want to see:You cannot combine
--handles and --exclude in the same query. This is an xAI API limitation.Expected Output Format
By default,/grok-x returns streaming text analysis with inline citations:
Example: Handle Monitoring
Query:@atrupar — Weekly Summary (Feb 25 – Mar 4, 2026) Aaron Rupar posted 34 times this week, with a sharp focus on Congressional hearings and White House press briefings. Video content accounted for 22 of 34 posts. Notable posts:“Watching the press secretary explain why the administration doesn’t consider this a constitutional crisis is genuinely surreal.” — Feb 26, 2026 · 41K likes · 18K repostsEngagement trend: Repost-to-like ratio averaged 0.44 this week, above his 90-day baseline of 0.31 — indicating unusually high amplification of his content.
Next Steps
Tool Combinations
Learn how to combine X search with web search, data analysis, and structured extraction
Model Selection
Choose the right model for your use case: fast, default, or deep reasoning