Skill

grok-search

Provides web search and webpage content fetching via Grok API CLI tools, replacing built-in WebSearch/WebFetch for real-time info, news, fact-checking, and multi-source aggregation.

Python

Bash

developer-tools

Install

npx claudepluginhub joshuarweaver/cascade-code-general-misc-2 --plugin dianel555-dskills

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Enhanced web search via Grok API. Standalone CLI only (no MCP dependency).

Supporting Assets

README.mdscripts/groksearch_cli.py

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Stars64

Forks6

Last CommitJan 30, 2026

Actions

View Source View Plugin View on GitHub View README

Grok Search

Enhanced web search via Grok API. Standalone CLI only (no MCP dependency).

Execution Methods

Run scripts/groksearch_cli.py via Bash:

# Prerequisites: pip install httpx tenacity
# Environment: GROK_API_URL, GROK_API_KEY

# Web search
python scripts/groksearch_cli.py web_search --query "search terms" [--platform "GitHub"] [--min-results 3] [--max-results 10]

# Fetch webpage
python scripts/groksearch_cli.py web_fetch --url "https://..." [--out file.md]

# Check config
python scripts/groksearch_cli.py get_config_info [--no-test]

# Switch model
python scripts/groksearch_cli.py switch_model --model "grok-2-latest"

# Toggle built-in tools
python scripts/groksearch_cli.py toggle_builtin_tools --action on|off|status [--root /path/to/project]

Tool Routing Policy

Forced Replacement Rules

Scenario	Disabled	Force Use
Web Search	`WebSearch`	CLI `web_search`
Web Fetch	`WebFetch`	CLI `web_fetch`

Tool Capability Matrix

Tool	Parameters	Output
`web_search`	`query`(required), `platform`/`min_results`/`max_results`(optional)	`[{title,url,description}]`
`web_fetch`	`url`(required), `out`(optional)	Structured Markdown
`get_config_info`	`no_test`(optional)	`{api_url,status,connection_test}`
`switch_model`	`model`(required)	`{previous_model,current_model}`
`toggle_builtin_tools`	`action`(on/off/status), `root`(optional)	`{blocked,deny_list}`

Search Workflow

Phase 1: Query Construction

Intent Recognition: Broad search → web_search | Deep retrieval → web_fetch
Parameter Optimization: Set platform for specific sources, adjust result counts

Phase 2: Search Execution

Start with web_search for structured summaries
Use web_fetch on key URLs if summaries insufficient
Retry with adjusted query if first round unsatisfactory

Phase 3: Result Synthesis

Cross-reference multiple sources
Must annotate source and date for time-sensitive info
Must include source URLs: Title [<sup>1</sup>](URL)

Error Handling

Error	Recovery
Connection Failure	Run `get_config_info`, verify API URL/Key
No Results	Broaden search terms
Fetch Timeout	Try alternative sources

Anti-Patterns

Prohibited	Correct
No source citation	Include `Source [<sup>1</sup>](URL)`
Give up after one failure	Retry at least once
Use built-in WebSearch/WebFetch	Use GrokSearch tools/CLI