How do I install the Grok Research skill?

Run npx skillmds@latest add majiayu000/grok-research in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Grok Research safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Grok Research?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Grok Research free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Grok Research?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Grok Research by majiayu000 — Agent Skill

Name: Grok Research
Rating: 4.666666666666667 (3 reviews)
Author: majiayu000

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).

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

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

Export the API key:

export OPENROUTER_API_KEY="..."

Run the script:

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)

Clarify the goal: “do you want an executive summary or a decision-making report?”
Ask for constraints: country/language, time window (last 24/72h), and any specific claims to verify.
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.
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

---name: grok-researchdescription: 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).--- # 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="..." ``` 2) 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`

Frequently asked questions