Agent skill · software engineering · nousresearch
grok
Delegate coding to xAI Grok Build CLI (features, PRs).
Why this skill is useful
Adds executable scripts for automating coding tasks with Grok Build CLI that extend the AI's capabilities beyond standard coding knowledge.
What it needs
Requires npm installed locally. Requires xai account access. About 8k tokens when loaded. Last updated 2026-08-07. 226,679 stars on the source repository.
What this skill does
Grok Build CLI — Hermes Orchestration Guide Delegate coding tasks to Grok Build (xAI's autonomous coding agent CLI, the grok command) via the Hermes terminal. Grok can read files, write code, run shell commands, spawn subagents, and manage git workflows. It runs three ways: an interactive TUI, headless (-p), and as an ACP agent over JSON-RPC. This is the third sibling to codex and claude-code. The orchestration pattern is nearly identical — prefer headless -p for one-shots, use a PTY for interactive sessions. When to use Building features Refactoring PR reviews Batch issue fixing Any task where you'd otherwise reach for Codex / Claude Code but want Grok Prerequisites Install (preferred): npm install -g @xai-official/grok The official installer curl -fsSL https://x.ai/cli/install.sh bash also works, but the x.ai host is Cloudflare-walled in some environments. The npm path avoids that dependency entirely. Auth — SuperGrok / X Premium+ subscription (primary path): Run grok login once → opens a browser for OAuth → token cached in ~/.grok/auth.json. This uses your SuperGrok or X Premium+ subscription (no per-token API billing). Check sign-in state by looking for ~/.grok/auth.json, or run a cheap headless smoke test: grok --no-auto-update -p "Say ok." In the TUI, /logout signs out and /login (or relaunching) signs back in. No git repo required — unlike Codex, Grok runs fine outside a git directory (good for scratch/throwaway tasks). Claude Code / AGENTS.md compatible with zero config — Grok auto-reads CLAUDE.md, .claude/ (skills, agents, MCPs, hooks, rules), and the AGENTS.md family. Existing project context just works. API-key fallback (not the default for this user): Grok also supports setting the XAIAPIKEY environment variable for pay-as-you-go billing via api.x.ai. Only use this if grok login / SuperGrok auth is unavailable. The subscription path (grok login) is the intended setup here. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/grok