Data
Skill
/grok-skill
Search and analyze X (Twitter) using xAI Grok 4 via OpenRouter with Live Search. Trigger on prompts that explicitly or implicitly ask to "search Twitter/X", "what's trending", "tweets from @handle", "hashtag #…", "what are people saying", or that require tweet-level
Install
$ npx -y skills add mikedemarais/grok-skill --skill grok-skill --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/grok-skill
Context preview
The summary Claude sees to decide when to auto-load this skill.
Search and analyze X (Twitter) using xAI Grok 4 via OpenRouter with Live Search. Trigger on prompts that explicitly or implicitly ask to "search Twitter/X", "what's trending", "tweets from @handle", "hashtag #…", "what are people saying", or that require tweet-level
SKILL.md
grok-skill.SKILL.mdname: grok-skill
description: >
Search and analyze X (Twitter) using xAI Grok 4 via OpenRouter with Live Search.
Trigger on prompts that explicitly or implicitly ask to "search Twitter/X", "what's
trending", "tweets from @handle", "hashtag #…", "what are people saying", or
that require tweet-level activity/engagement from X.
Grok 4 — X/Twitter Live Search Skill
Prerequisites
- **OpenRouter API key** required (set as `OPENROUTER_API_KEY` environment variable)
- Get your key at [openrouter.ai](https://openrouter.ai)
- Bun runtime installed
When to use
Use this Skill whenever the user asks for trends, activity, examples, or evidence **from X/Twitter**:
- "search twitter|x for <query>"
- "what's trending on X"
- "top tweets/threads/hashtags about <topic>"
- "what are people saying about <project>"
- "tweets from @handle", "compare @a vs @b"
How to run (Claude should execute these)
- Minimal:
bun scripts/grok.ts --q "<query>"
- One-off with inline API key:
OPENROUTER_API_KEY="sk-or-..." bun scripts/grok.ts --q "<query>"
- With handles and date window (YYYY-MM-DD):
bun scripts/grok.ts \
--q "<topic or question>" \
--mode on \
--include "@OpenAI" "@AnthropicAI" \
--from "2025-11-01" --to "2025-11-07" \
--min-faves 50 --min-views 0 \
--max 12- Output is concise JSON: `summary`, `citations` (tweet URLs), and `usage`. Paste a short synthesis with linked tweets.
Defaults & notes
- Live Search `mode` defaults to `auto`; use `on` for explicit "search X now".
- If user gives handles, pass them via `--include` (or `--exclude`).
- Use `--from/--to` for time-bounded asks; if unspecified, do not assume dates.
- Keep `--max` modest (8–20) for cost/latency; raise only if sparse.
- `--include` and `--exclude` are **mutually exclusive**.
- Do **not** claim access to private/protected content. Prefer links over long quotes.
Troubleshooting
- Sparse results → increase `--max` or relax filters; consider removing handles.
- Missing links → they're in `citations` of the JSON output; share the URLs.
Read more
name: grok-skill description: > Search and analyze X (Twitter) using xAI Grok 4 via OpenRouter with Live Search. Trigger on prompts that explicitly or implicitly ask to "search Twitter/X", "what's trending", "tweets from @handle", "hashtag #…", "what are people saying", or that require tweet-level activity/engagement from X.
Grok 4 — X/Twitter Live Search Skill
Prerequisites
- **OpenRouter API key** required (set as `OPENROUTER_API_KEY` environment variable)
- Get your key at [openrouter.ai](https://openrouter.ai)
- Bun runtime installed
When to use
Use this Skill whenever the user asks for trends, activity, examples, or evidence **from X/Twitter**:
- "search twitter|x for <query>"
- "what's trending on X"
- "top tweets/threads/hashtags about <topic>"
- "what are people saying about <project>"
- "tweets from @handle", "compare @a vs @b"
How to run (Claude should execute these)
- Minimal:
bun scripts/grok.ts --q "<query>"
- One-off with inline API key:
OPENROUTER_API_KEY="sk-or-..." bun scripts/grok.ts --q "<query>"
- With handles and date window (YYYY-MM-DD):
bun scripts/grok.ts \
--q "<topic or question>" \
--mode on \
--include "@OpenAI" "@AnthropicAI" \
--from "2025-11-01" --to "2025-11-07" \
--min-faves 50 --min-views 0 \
--max 12- Output is concise JSON: `summary`, `citations` (tweet URLs), and `usage`. Paste a short synthesis with linked tweets.
Defaults & notes
- Live Search `mode` defaults to `auto`; use `on` for explicit "search X now".
- If user gives handles, pass them via `--include` (or `--exclude`).
- Use `--from/--to` for time-bounded asks; if unspecified, do not assume dates.
- Keep `--max` modest (8–20) for cost/latency; raise only if sparse.
- `--include` and `--exclude` are **mutually exclusive**.
- Do **not** claim access to private/protected content. Prefer links over long quotes.
Troubleshooting
- Sparse results → increase `--max` or relax filters; consider removing handles.
- Missing links → they're in `citations` of the JSON output; share the URLs.
Ships withgrok-skill
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.
Get the whole plugin
Stats
18
Stars
1
Forks
Quiet
Maintenance
TypeScript
Language
MIT
License
10mo ago
Last commit
10mo ago
Created
Repo: mikedemarais/grok-skill