{"skill":{"slug":"x-ai","displayName":"xAI / Grok","summary":"Chat with Grok models via xAI API. Supports Grok-3, Grok-3-mini, vision, and more.","description":"---\nname: xai\ndescription: Chat with Grok models via xAI API. Supports Grok-3, Grok-3-mini, vision, and more.\nhomepage: https://docs.x.ai\nuser-invocable: true\ndisable-model-invocation: true\ntriggers:\n  - grok\n  - xai\n  - ask grok\nmetadata:\n  clawdbot:\n    emoji: \"🤖\"\n    primaryEnv: XAI_API_KEY\n    requires:\n      bins: [node]\n      env: [XAI_API_KEY]\n---\n\n# xAI / Grok\n\nChat with xAI's Grok models. Supports text and vision.\n\n## Setup\n\n[INSTALLATION AND USE INSTRUCTIONS](https://claude.ai/public/artifacts/5bb1d4ca-68ef-4d74-900c-d14fefa5c094)\n\n```bash\nexport XAI_API_KEY=\"xai-YOUR-KEY\"\n```\n\nGet your API key at: https://console.x.ai\n\n## Commands\n\n### Chat with Grok\n```bash\nnode {baseDir}/scripts/chat.js \"What is the meaning of life?\"\n```\n\n### Use a specific model\n```bash\nnode {baseDir}/scripts/chat.js --model grok-3-mini \"Quick question: 2+2?\"\n```\n\n### Vision (analyze images)\n```bash\nnode {baseDir}/scripts/chat.js --image /path/to/image.jpg \"What's in this image?\"\n```\n\n### 🔍 Search X/Twitter (Real-time!)\n```bash\nnode {baseDir}/scripts/search-x.js \"Remotion video framework\"\nnode {baseDir}/scripts/search-x.js --days 7 \"Claude AI tips\"\nnode {baseDir}/scripts/search-x.js --handles @remotion_dev \"updates\"\n```\n\nUses xAI Responses API with x_search tool for real X posts with citations.\n\n### List available models\n```bash\nnode {baseDir}/scripts/models.js\n```\n\n## Available Models\n\n- `grok-3` - Most capable, best for complex tasks\n- `grok-3-mini` - Fast and efficient\n- `grok-3-fast` - Optimized for speed\n- `grok-2-vision-1212` - Vision model for image understanding\n\n## Example Usage\n\n**User:** \"Ask Grok what it thinks about AI safety\"\n**Action:** Run chat.js with the prompt\n\n**User:** \"Use Grok to analyze this image\" (with attached image)\n**Action:** Run chat.js with --image flag\n\n**User:** \"What Grok models are available?\"\n**Action:** Run models.js\n\n## API Reference\n\nxAI API Docs: https://docs.x.ai/api\n\n## Environment Variables\n\n- `XAI_API_KEY` - Your xAI API key (required)\n- `XAI_MODEL` - Default model (optional, defaults to grok-3)\n\n## Security & Permissions\n\n**What this skill does:**\n- Sends chat prompts to xAI's API at `api.x.ai`\n- Vision mode sends images to xAI for analysis\n- `scripts/models.js` lists available models (read-only)\n\n**What this skill does NOT do:**\n- Does not read arbitrary local files — `--image` only accepts files with image extensions (`.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`)\n- Does not read config files or access the filesystem beyond the specified image path\n- Does not store conversation history or logs\n- Does not send credentials to any endpoint other than `api.x.ai`\n- Cannot be invoked autonomously by the agent (`disable-model-invocation: true`)\n\n**Bundled scripts:** `scripts/chat.js` (chat), `scripts/models.js` (list models), `scripts/search-x.js` (X search)\n\nReview scripts before first use to verify behavior.\n","tags":{"latest":"1.0.2"},"stats":{"comments":3,"downloads":11591,"installsAllTime":8,"installsCurrent":8,"stars":15,"versions":3},"createdAt":1771622487580,"updatedAt":1778991955035},"latestVersion":{"version":"1.0.2","createdAt":1771690964816,"changelog":"- Added a prominent link to external installation and use instructions at the top of the setup section.\n- No changes to functionality or commands; documentation update only.","license":null},"metadata":{"setup":[{"key":"XAI_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"blueberrywoodsym","userId":"s170d5vw6h65z8n14e9a17f7a9848472","displayName":"blueberrywoodsym","image":"https://avatars.githubusercontent.com/u/256029437?v=4"},"moderation":null}