skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
connorads/dotfiles71 installs

groksearch

Search X and the web using Grok (xAI) API, then summarise results with top sources.

How do I install this agent skill?

npx skills add https://github.com/connorads/dotfiles --skill groksearch
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubwarn

    This skill searches the web and X (Twitter) using the xAI API. It is susceptible to indirect prompt injection from untrusted search results and involves local command execution for its operations.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · No issues

  • Runlayerwarn

    3/3 files flagged

What does this agent skill do?

groksearch

Search X and the web using Grok's server-side tools and return a concise summary with top sources.

This skill uses Grok's own x_search and web_search tools (not Claude WebSearch).

Usage

Run the script using absolute path (do NOT cd to the skill directory first):

uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query"

Common options

# X + Web (default)
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --sources both

# X only
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --sources x

# Web only
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --sources web

# Last 14 days
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --days 14

# Explicit date range
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --from-date 2026-01-01 --to-date 2026-01-31

# No date filtering
uv run ~/.claude/skills/groksearch/scripts/groksearch.py "your query" --no-date

API Key

Provide the xAI API key in one of these ways (highest priority first):

  1. --api-key argument
  2. XAI_API_KEY environment variable
  3. ~/.config/groksearch/.env file

Example config file:

mkdir -p ~/.config/groksearch
cat > ~/.config/groksearch/.env << 'EOF'
XAI_API_KEY=
EOF
chmod 600 ~/.config/groksearch/.env

Output

The script prints:

  • Query, sources, and date range
  • A concise summary with key points
  • A short list of top source URLs (from Grok citations)

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/connorads/dotfiles/groksearch">View groksearch on skillZs</a>