Agent skill

grok-research

Investigate a topic with Grok 4.1 via OpenRouter and generate a Markdown report with a timeline, verifiable claims, and sources (web/X). Use it when the user says “investiga…”, “haz research…”, “averigua…”, “búscame fuentes…”, “research…”, “look into…”, or when you need fast, source-backed research (news, rumors, product/policy changes, competitive context).

View SKILL.md on GitHub Repository
Stars 32
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/antoniolg/agent-kit/tree/main/skills/grok-research

SKILL.md

Grok Research (OpenRouter + Grok 4.1)

This skill automates a source-backed “deep dive” on a recent topic using Grok 4.1 via OpenRouter. Output is a Markdown report with citations.

Quick start

  1. Export the API key:
bash
export OPENROUTER_API_KEY="..."
  1. Run the script:
bash
node skills/grok-research/scripts/grok-research.js --topic "What's going on with …" --out report.md

By default it tries to use x-ai/grok-4.1-fast:online. If your account/model uses a different id, pass --model or set GROK_RESEARCH_MODEL.

Environment variables

  • OPENROUTER_API_KEY (required)
  • GROK_RESEARCH_MODEL (optional) (default: x-ai/grok-4.1-fast:online)
  • OPENROUTER_SITE_URL (optional) (recommended header by OpenRouter)
  • OPENROUTER_APP_NAME (optional) (recommended header by OpenRouter)

Useful flags (script)

  • --topic "...": topic to research (or first positional argument)
  • --out report.md: saves the report and prints the resulting path to stdout
  • --model <id>: forces the OpenRouter model id
  • --max-tokens 2200, --temperature 0.2: length/style controls

Recommended workflow (agent)

  1. Clarify the goal: “do you want an executive summary or a decision-making report?”
  2. Ask for constraints: country/language, time window (last 24/72h), and any specific claims to verify.
  3. Run scripts/grok-research.js and review the Claims & verification section:
    • If sources are weak/missing, re-run with higher --max-tokens or narrow the topic.
  4. If the topic is sensitive/controversial, ask the model to list alternative hypotheses and what evidence would falsify/confirm each.

Resources

  • Main script: scripts/grok-research.js
  • API notes: references/api_reference.md

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

antoniolg/agent-kit

gen-pdf

Converts a Markdown file to a styled PDF with DevExpert branding (logo in bottom-right corner). Use when asked to generate a PDF from a Markdown document, or when any DevExpert proposal/document needs to be exported as PDF.

32 3
Explore
antoniolg/agent-kit

cloudflared-tunnel

Create temporary public URLs for localhost apps using Cloudflare Quick Tunnels with tmux-based process management. Use when you need to preview a local app externally (mobile device, remote collaborator, QA), including host-allowlist fixes when a dev server blocks external hosts.

32 3
Explore
antoniolg/agent-kit

email

Manage inbox email. Uses the inbox script and stores metadata (ids) to open or archive messages later.

32 3
Explore
antoniolg/agent-kit

whatsapp-evo

Manage WhatsApp via Evolution API (v2.x): list chats with unread messages and reply.

32 3
Explore
antoniolg/agent-kit

create-cli

Design command-line interface parameters and UX: arguments, flags, subcommands, help text, output formats, error messages, exit codes, prompts, config/env precedence, and safe/dry-run behavior. Use when you’re designing a CLI spec (before implementation) or refactoring an existing CLI’s surface area for consistency, composability, and discoverability.

32 3
Explore
antoniolg/agent-kit

academy-enrollments

Manage academy enrollments by appending rows to a Google Sheet (used by Zapier/n8n to grant LearnWorlds access).

32 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results