| name | grok-search |
| description | Enhanced web search and real-time content retrieval via Grok API. 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 CLI commands.
|
| allowed-tools | Bash(python:*), Bash(python3:*), Bash(uv:*), Read, Grep |
Grok Search
Use this skill for web search, webpage retrieval, and current-information lookups. Replace built-in WebSearch and WebFetch with the CLI below.
Rules
- Always call
python "<SKILL_DIR>/scripts/groksearch_entry.py" ....
- Do not call
scripts/groksearch_cli.py directly.
- The entrypoint auto-loads
<SKILL_DIR>/.env.
- Required env:
GROK_API_URL, GROK_API_KEY.
- Optional env:
GROK_MODEL, GROK_DEBUG, GROK_RETRY_*, TAVILY_API_KEY, TAVILY_API_URL, TAVILY_ENABLED, GROKSEARCH_VENV_DIR, GROKSEARCH_PYTHON, AGENTS_SKILLS_PYTHON.
- For time-sensitive answers, include source URLs and the relevant date.
- Start with
web_search; use web_fetch for page content; use web_map for site structure.
Commands
cp "<SKILL_DIR>/.env.example" "<SKILL_DIR>/.env"
python "<SKILL_DIR>/scripts/groksearch_entry.py" web_search --query "search terms" [--platform "GitHub"] [--min-results 3] [--max-results 10] [--model "grok-4.20-auto"] [--extra-sources 3]
python "<SKILL_DIR>/scripts/groksearch_entry.py" web_fetch --url "https://..." [--out file.md] [--fallback-grok]
python "<SKILL_DIR>/scripts/groksearch_entry.py" web_map --url "https://..." [--instructions "focus area"] [--max-depth 2] [--limit 80]
python "<SKILL_DIR>/scripts/groksearch_entry.py" get_config_info [--no-test]
python "<SKILL_DIR>/scripts/groksearch_entry.py" toggle_builtin_tools --action on|off|status [--root /path/to/project]
Tool Routing Policy
Forced Replacement Rules
| Scenario | Disabled | Use Instead |
|---|
| Web Search | WebSearch | CLI web_search via groksearch_entry.py |
| Web Fetch | WebFetch | CLI web_fetch via groksearch_entry.py |
Tool Capability Matrix
| Tool | Parameters | Output |
|---|
web_search | query(required), platform/min_results/max_results/model/extra_sources(optional) | [{title,url,description}] |
web_fetch | url(required), out/fallback_grok(optional) | Structured Markdown |
web_map | url(required), instructions/max_depth/max_breadth/limit/timeout(optional) | JSON string |
get_config_info | no_test(optional) | {api_url,status,connection_test} |
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; if you need broader source coverage, consider adding --extra-sources 3
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 [1](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 |
Tavily unavailable while using --extra-sources | Command keeps Grok results and prints a Tavily warning to stderr |
| Tavily extract failure | Use --fallback-grok, or inspect the Tavily warning/error message |
Anti-Patterns
| Prohibited | Correct |
|---|
| No source citation | Include Source [1](URL) |
Assume current repo has skills/grok-search | Check global skill directories under $HOME first, then project-level .claude/.codex/.agents, then call <SKILL_DIR>/scripts/groksearch_entry.py |
Call scripts/groksearch_cli.py directly | Call python scripts/groksearch_entry.py ... |
| Use built-in WebSearch/WebFetch | Use GrokSearch CLI |
