Grok Skill

grok-skill

[](https://bun.sh) [](https://www.typescriptlang.org/) [](https://openrouter.ai) [](LICENSE)

A Claude Code Skill that routes X/Twitter queries to xAI **Grok 4** via **OpenRouter** with **Live Search** turned on and scoped to the **X** source.

Features

• Live Search - Real-time X/Twitter data via Grok 4's Live Search
• Handle Filtering - Multi-value --include / --exclude for targeted searches
• Date Range Queries - Time-bounded searches with calendar validation
• Engagement Filters - Filter by favorites and views
• Network Resilience - Automatic retries with exponential backoff
• Citation Extraction - Tweet URLs with fallback parsing
• Production Ready - Comprehensive error handling and validation

Quick Start

# 1. Set your OpenRouter API key
export OPENROUTER_API_KEY="sk-or-..."

# 2. Run a query (assumes Bun is installed)
bun scripts/grok.ts --q "what's trending on X about AI?"

That's it! The script returns JSON with summary, citations, and usage stats.

Install

1. Get an OpenRouter API Key

Sign up at [openrouter.ai](https://openrouter.ai) and create an API key.

2. Set Environment Variable

# Set your OpenRouter key
export OPENROUTER_API_KEY="sk-or-..."

# Verify it's set
echo "$OPENROUTER_API_KEY"

# To persist across sessions, add to your shell profile:
echo 'export OPENROUTER_API_KEY="sk-or-..."' >> ~/.zshrc
source ~/.zshrc

3. Install Bun (if needed)

# macOS/Linux
brew install bun || curl -fsSL https://bun.sh/install | bash

# Windows
powershell -c "irm bun.sh/install.ps1|iex"

4. Clone and Setup

# Clone to Claude Code skills directory
git