grok-skill

🥈Silver

The grok-skill is a Claude Code Skill that routes Twitter/X prompts to Grok-4 Live Search. It benefits operations teams by automating information retrieval from XAI's Grok-4 model. The skill connects to OpenRouter API and integrates with Claude agents to streamline data access and analysis workflows.

1720Updated 1mo ago

Intermediate30min to implementautomation

Saves ~30 min per use

Quick InstallView Source

git clone https://github.com/mikedemarais/grok-skill.git

Works with:

Claude

Overview

About This Skill

grok-skill is a Claude Code Skill that connects to xAI's Grok 4 model through OpenRouter, enabling real-time searches of X/Twitter data with Live Search enabled. The skill routes natural language queries to Grok 4 and returns summaries with tweet citations, filtered by handles, engagement metrics, and date ranges. Operations teams and analysts use grok-skill to automate information retrieval workflows, accessing trending topics, sentiment analysis, and breaking news directly from X without manual browsing. The skill includes network resilience with automatic retries, comprehensive filtering options, and production-ready error handling to ensure reliable data access at scale.

How to Use

Set your OpenRouter API key as an environment variable, install Bun, then clone the skill to your Claude Code skills directory. Run queries using the grok.ts script with flags like --q for your query, --include/@handle for targeted searches, and --from/--to for date ranges. The script returns JSON output with a summary, tweet citations, and token usage metrics.

Use Cases

Monitor trending AI developments and industry announcements on X in real-time

Track crypto market sentiment and news from specific accounts with engagement filters

Automate competitive intelligence by searching for mentions of specific organizations

Gather real-time data for reports with date-bounded searches and citation tracking

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/mikedemarais/grok-skill

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

I need to use the grok-skill to search for recent discussions about [TOPIC] on Twitter/X. Please route this prompt to Grok-4 Live Search via the OpenRouter API and provide a summary of the key findings. Focus on insights relevant to [COMPANY] in the [INDUSTRY] sector.

Example Output

# Grok-4 Live Search Results for [TOPIC]

## Key Findings
- **Trending Sentiment**: The majority of discussions about [TOPIC] on Twitter/X are positive, with users praising its potential impact on [INDUSTRY].
- **Key Influencers**: Notable figures in [INDUSTRY] such as @Influencer1 and @Influencer2 have shared their insights, highlighting benefits for [COMPANY] like streamlined operations and cost savings.
- **Emerging Trends**: There is a growing interest in how [TOPIC] can integrate with existing systems, with several users discussing potential partnerships and collaborations.

## Detailed Analysis
- **User Engagement**: The topic has garnered significant engagement, with over 10,000 mentions in the last 24 hours. The engagement rate is particularly high among professionals in [INDUSTRY].
- **Geographical Distribution**: The discussions are most prevalent in regions where [COMPANY] has a strong presence, indicating a high level of local interest.
- **Actionable Insights**: Users suggest that [COMPANY] should consider investing in [TOPIC] to stay competitive and meet evolving market demands.