xAI Grok Integration with Agentic Tool Calling

This skill enables Claude to delegate queries to xAI's Grok model with powerful agentic capabilities including real-time X (Twitter) search, web browsing, and code execution.

When to Use This Skill

Use this skill when:

• User explicitly asks to use Grok or xAI

• User needs real-time X (Twitter) search - finding tweets, users, trends

• User requests "another opinion" or "alternative perspective"

• Query requires very recent information or current events

• User wants social media analysis or Twitter/X insights

• Task benefits from Grok's unique training and perspective

• Complex research requiring multiple tools (web search + code + Twitter)

Core Capabilities

1. X (Twitter) Search

• Semantic and keyword search across X posts, users, and threads

• User search by name or handle

• Thread fetching for full conversation context

• Real-time data from the X platform

2. Web Search

• Real-time search across the internet

• Browse web pages and extract content

3. Code Execution

• Write and execute Python code

• Data analysis and complex computations

• Generate visualizations and process data

4. Agentic Orchestration

• Server-side tool calling - Grok autonomously decides which tools to use

• Multi-step reasoning - Combines multiple tools to answer complex queries

• Streaming mode - Real-time progress and observability (always used per xAI recommendation)

• Citations - Full traceability of information sources

Usage

The skill uses a modern Typer-based CLI at .claude/skills/xai-grok/src/grok.py :

Basic Usage (X Search + Web Search enabled by default)

python3 grok.py "Find recent tweets from Israeli tech nano-influencers"

With All Tools Including Code Execution

python3 grok.py "Analyze tech trends with charts" --enable-code-execution

Get Help

python grok.py --help

Twitter/X Search Examples

Find specific users

python3 grok.py "Who are the top Israeli tech influencers on X?"

Search for recent tweets

python3 grok.py "Latest tweets about Israeli startups"

Analyze trends

python3 grok.py "What are Israeli tech companies tweeting about today?"

Use fast model with custom temperature (short options)

python3 grok.py "Recent AI tweets" -m grok-4-fast-reasoning -t 0.5

Disable Specific Tools

Only X search, no web search

python3 grok.py "Find tweets" --disable-web-search

Only web search, no X search

python3 grok.py "Latest news" --disable-x-search

No tools (basic chat)

python3 grok.py "Explain AI" --disable-all-tools

Available Options

--model, -m # Model selection (default: grok-4) --temperature, -t # Temperature for response generation (default: 0.3) --disable-x-search # Disable X (Twitter) search (enabled by default) --disable-web-search # Disable web search (enabled by default) --enable-code-execution # Enable Python code execution (opt-in) --disable-all-tools # Disable all tools (basic chat mode) --show-citations # Show source URLs (default: enabled) --no-show-citations # Hide source URLs --show-usage # Show token usage statistics --show-tool-calls # Show real-time tool calls --install-completion # Install shell completion for the current shell --show-completion # Show completion script for customization

Available Grok 4 Models

• grok-4

• Highest quality model, 256k context [DEFAULT]

• grok-4-fast-reasoning

• Cost-efficient with reasoning, 2M context

• grok-4-fast-non-reasoning

• Cost-efficient without reasoning, 2M context

Requirements

• XAI_API_KEY environment variable in project's .env file

How It Works

When you invoke this skill with tools enabled, Grok uses agentic tool calling:

• Analyzes your query to understand what information is needed

• Autonomously selects tools - decides whether to search X, browse web, execute code, or combine multiple approaches

• Executes tools server-side - no need for you to handle tool responses

• Iterates and refines - uses tool results to make better decisions

• Returns comprehensive answer with citations and sources

This means a single query like "What are Israeli tech companies tweeting about and how does it compare to global trends?" can automatically:

• Search X for Israeli tech company tweets

• Search the web for global tech trends

• Execute Python code to analyze patterns

• Synthesize everything into a comprehensive answer

Output

The script provides:

• Streaming responses with real-time progress

• Citations - URLs of all sources Grok used

• Tool call visibility - See which tools Grok invoked (optional)

• Token usage - Detailed cost tracking (optional)

• Professional CLI - Rich formatted help text with boxed sections

• Shell completion - Tab completion support for all commands and options

Notes

• Typer-powered CLI provides a modern, user-friendly interface with rich formatting

• Grok responses are clearly indicated in output

• X search provides real-time data from the Twitter/X platform

• Citations show full traceability of information sources

• This is a supplementary tool; Claude remains the primary assistant

• API usage incurs costs on the user's xAI account

• Streaming mode is always used for agentic workflows (per xAI strong recommendation)

• Image/video understanding is not supported in this implementation