agentsclimarketplace
Sign in

Grok skill

Skill mikedemarais/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 activity/engagement from X.From its SKILL.md

Install
npx -y skills add mikedemarais/grok-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

  • reads credentialsReads from 1 credential source: `OPENROUTER_API_KEY`.
  • 18 stars18 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
  • runs commandsInstructs the agent to run 3 commands, including `bun scripts/grok.ts --q "<query>"` and 2 more.

SKILL.md

2.1 KB, 503 tokens by cl100k_base, as published. Nobody here has run it

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
  • 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.

What ships with it: 5 files

29.0 KB alongside SKILL.md, 1 of them executable

scripts/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.