mcpField
G
grok-skill

grok-skill

github.com/mikedemaraisProductivity1746 installsUpdated 51w ago
Repository

About grok-skill

grok-skill is a command-line skill for searching live X/Twitter activity through Grok 4. It is intended for requests about trends, posts, accounts, and time-bounded discussions, and returns concise results with tweet citations.

Key features

  1. 01Search live X/Twitter activity
  2. 02Filter by handles and dates
  3. 03Set favorite, view, and result limits
  4. 04Return summaries with tweet citations
  5. 05Emit results as concise JSON

Use cases

  1. 01Checking current discussion of a topic
  2. 02Finding posts from specified accounts
  3. 03Comparing activity within a date range

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mikedemarais/grok-skill --skill grok-skill

After installing, type/grok-skillin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
LICENSE
README.md
CLAUDE.md
scripts/
grok.ts

Details

From the project README

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 "
  • "what's trending on X"
  • "top tweets/threads/hashtags about "
  • "what are people saying about "
  • "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.

Comments

Markdown supported