How do I install the Xai skill?

Run npx skillmds add modbender/xai 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.

What does the Xai skill do?

Chat with Grok models via xAI API. Supports Grok-3, Grok-3-mini, vision, and more. It is listed under Integrations & APIs on SkillMD.

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Xai?

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.

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

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

Xai by modbender — Agent Skill

Name: Xai
Rating: 4.2 (5 reviews)
Author: modbender

File contents

xAI / Grok

Chat with xAI's Grok models. Supports text and vision.

Setup

export XAI_API_KEY="xai-YOUR-KEY"

Get your API key at: https://console.x.ai

Commands

Chat with Grok

node {baseDir}/scripts/chat.js "What is the meaning of life?"

Use a specific model

node {baseDir}/scripts/chat.js --model grok-3-mini "Quick question: 2+2?"

Vision (analyze images)

node {baseDir}/scripts/chat.js --image /path/to/image.jpg "What's in this image?"

🔍 Search X/Twitter (Real-time!)

node {baseDir}/scripts/search-x.js "Remotion video framework"
node {baseDir}/scripts/search-x.js --days 7 "Claude AI tips"
node {baseDir}/scripts/search-x.js --handles @remotion_dev "updates"

Uses xAI Responses API with x_search tool for real X posts with citations.

List available models

node {baseDir}/scripts/models.js

Available Models

grok-3 - Most capable, best for complex tasks
grok-3-mini - Fast and efficient
grok-3-fast - Optimized for speed
grok-2-vision-1212 - Vision model for image understanding

Example Usage

User: "Ask Grok what it thinks about AI safety" Action: Run chat.js with the prompt

User: "Use Grok to analyze this image" (with attached image) Action: Run chat.js with --image flag

User: "What Grok models are available?" Action: Run models.js

API Reference

xAI API Docs: https://docs.x.ai/api

Environment Variables

XAI_API_KEY - Your xAI API key (required)
XAI_MODEL - Default model (optional, defaults to grok-3)

Security & Permissions

What this skill does:

Sends chat prompts to xAI's API at api.x.ai
Vision mode sends images to xAI for analysis
scripts/models.js lists available models (read-only)

What this skill does NOT do:

Does not read arbitrary local files — --image only accepts files with image extensions (.jpg, .jpeg, .png, .gif, .webp)
Does not read config files or access the filesystem beyond the specified image path
Does not store conversation history or logs
Does not send credentials to any endpoint other than api.x.ai
Cannot be invoked autonomously by the agent (disable-model-invocation: true)

Bundled scripts: scripts/chat.js (chat), scripts/models.js (list models), scripts/search-x.js (X search)

Review scripts before first use to verify behavior.

---name: xaidescription: Chat with Grok models via xAI API. Supports Grok-3, Grok-3-mini, vision, and more.--- # xAI / Grok Chat with xAI's Grok models. Supports text and vision. ## Setup ```bash export XAI_API_KEY="xai-YOUR-KEY" ``` Get your API key at: https://console.x.ai ## Commands ### Chat with Grok ```bash node {baseDir}/scripts/chat.js "What is the meaning of life?" ``` ### Use a specific model ```bash node {baseDir}/scripts/chat.js --model grok-3-mini "Quick question: 2+2?" ``` ### Vision (analyze images) ```bash node {baseDir}/scripts/chat.js --image /path/to/image.jpg "What's in this image?" ``` ### 🔍 Search X/Twitter (Real-time!) ```bash node {baseDir}/scripts/search-x.js "Remotion video framework" node {baseDir}/scripts/search-x.js --days 7 "Claude AI tips" node {baseDir}/scripts/search-x.js --handles @remotion_dev "updates" ``` Uses xAI Responses API with x_search tool for real X posts with citations. ### List available models ```bash node {baseDir}/scripts/models.js ``` ## Available Models - `grok-3` - Most capable, best for complex tasks - `grok-3-mini` - Fast and efficient - `grok-3-fast` - Optimized for speed - `grok-2-vision-1212` - Vision model for image understanding ## Example Usage **User:** "Ask Grok what it thinks about AI safety" **Action:** Run chat.js with the prompt **User:** "Use Grok to analyze this image" (with attached image) **Action:** Run chat.js with --image flag **User:** "What Grok models are available?" **Action:** Run models.js ## API Reference xAI API Docs: https://docs.x.ai/api ## Environment Variables - `XAI_API_KEY` - Your xAI API key (required) - `XAI_MODEL` - Default model (optional, defaults to grok-3) ## Security & Permissions **What this skill does:** - Sends chat prompts to xAI's API at `api.x.ai` - Vision mode sends images to xAI for analysis - `scripts/models.js` lists available models (read-only) **What this skill does NOT do:** - Does not read arbitrary local files — `--image` only accepts files with image extensions (`.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`) - Does not read config files or access the filesystem beyond the specified image path - Does not store conversation history or logs - Does not send credentials to any endpoint other than `api.x.ai` - Cannot be invoked autonomously by the agent (`disable-model-invocation: true`) **Bundled scripts:** `scripts/chat.js` (chat), `scripts/models.js` (list models), `scripts/search-x.js` (X search) Review scripts before first use to verify behavior.

Frequently asked questions