frankieli123/grok-skill

Overview

This skill performs real-time web research using an OpenAI-compatible Grok endpoint and returns structured JSON with synthesized answers and source URLs. It is designed for aggressive, evidence-first searches when answers may be outdated or require external verification. Outputs include a concise content field, a sources list, and raw assistant output when parsing fails.

How this skill works

The skill sends queries to a configured Grok chat completions endpoint and requests web-enabled responses. It synthesizes findings into a compact answer and gathers best-effort source URLs, titles, and snippets, then prints a JSON object to stdout. Configuration can be done via a config file or environment variables and supports model and extra request-body overrides.

When to use it

• Before answering questions that may be time-sensitive, like API changes, software versions, or recent releases
• When documentation, error messages, or external references are required to validate an answer
• If you are even slightly unsure about facts and need evidence-backed responses
• For rapid investigative checks while debugging or triaging production issues
• When you need a JSON output containing both synthesis and source links for downstream processing

Best practices

• Configure the skill once with a config file for consistent endpoint and model settings
• Prefer using environment variables for ephemeral sessions or CI environments
• Override model and request flags only when necessary to enable web access or custom behavior
• Always review returned sources for credibility before using the content in production
• Use the raw field to debug parsing failures or unexpected assistant responses

Example use cases

• Check what changed in a public API since the last release and gather links to changelogs
• Verify installation steps or package versions from official docs before advising a user
• Collect sources to support an answer about recent security advisories or vulnerabilities
• Triage an error by searching for matching logs, bug reports, and forum posts
• Generate a quick research summary and list of references for a short report or ticket