version: "1.0.1" name: grok-search description: | Enhanced web search and real-time content retrieval via Grok API with forced tool routing. Use when: (1) Web search / information retrieval / fact-checking, (2) Webpage content extraction / URL parsing, (3) Breaking knowledge cutoff limits for current information, (4) Real-time news and technical documentation, (5) Multi-source information aggregation. Triggers: "search for", "find information about", "latest news", "current", "fetch webpage", "get content from URL". IMPORTANT: This skill REPLACES built-in WebSearch/WebFetch with Grok Search tools.

Grok Search

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

Implementation Layout

• scripts/groksearch_cli.py - CLI entrypoint and compatibility facade
• scripts/groksearch/ - internal modules for config, HTTP retry, Grok provider, Tavily calls, formatting, and commands

Execution Methods

Run scripts/groksearch_cli.py via Bash:

# Prerequisites: pip install httpx tenacity
# Environment: GROK_API_URL, GROK_API_KEY (required); TAVILY_API_KEY (optional)
 
# Web search (Grok only)
python scripts/groksearch_cli.py web_search --query "search terms" [--platform "GitHub"] [--min-results 3] [--max-results 10]
 
# Web search with Tavily extra sources (parallel + URL-deduplicated merge)
python scripts/groksearch_cli.py web_search --query "..." --extra-sources 5
 
# Fetch webpage (default: Grok)
python scripts/groksearch_cli.py web_fetch --url "https://..." [--out file.md]
 
# Fetch via Tavily extract endpoint
python scripts/groksearch_cli.py web_fetch --url "https://..." --via tavily
 
# Map a website's structure (Tavily)
python scripts/groksearch_cli.py web_map --url "https://docs.example.com" [--instructions "API only"] [--max-depth 2] [--max-breadth 20] [--limit 50] [--timeout 150]
 
# 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

Tool Capability Matrix

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

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

Phase 3: Result Synthesis

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

Error Handling

Anti-Patterns