Skip to content

feat(skills): add grok skill for xAI Grok Build CLI - #34040

Closed
boobutler wants to merge 1 commit into
NousResearch:mainfrom
boobutler:skill/grok-build
Closed

feat(skills): add grok skill for xAI Grok Build CLI#34040
boobutler wants to merge 1 commit into
NousResearch:mainfrom
boobutler:skill/grok-build

Conversation

@boobutler

Copy link
Copy Markdown

Summary

Adds a grok skill under skills/autonomous-ai-agents/, a third coding-agent orchestration guide alongside codex and claude-code. It teaches Hermes to delegate coding tasks to Grok Build (xAI's grok CLI).

Invoked as the /grok slash command (skill name → slug).

Auth

Built around the SuperGrok / X Premium+ subscription path (grok login → browser OAuth → ~/.grok/auth.json) as primary, with XAI_API_KEY documented only as a fallback.

What it covers

  • Install: npm install -g @xai-official/grok preferred (avoids the Cloudflare-walled x.ai host).
  • Headless (-p) one-shots as the preferred mode — the analog of claude -p / codex exec.
  • Interactive TUI via pty=true + tmux for multi-turn work.
  • --output-format json parsing, named-session resume (-s/-r/-c), background long-tasks via the process tool.
  • PR review (quick + clone-to-temp) and parallel worktree issue-fixing patterns.
  • Read-only audit → markdown note pattern (omit --always-approve).
  • ~/.grok/config.toml reference.
  • Pitfalls: subscription-gated auth, Hermes' xAI x_search auth ≠ the grok CLI's auth, always pass --no-auto-update in automation, --always-approve as the autonomous-build switch, --no-alt-screen for inline TUI.

Notes

  • No git repo required for Grok (unlike Codex), and it auto-reads CLAUDE.md / .claude/ / AGENTS.md with zero config.
  • Single new file: skills/autonomous-ai-agents/grok/SKILL.md. No code changes; skills are directory-scanned so no manifest update needed.

Adds a third coding-agent orchestration skill alongside codex and
claude-code. Built around SuperGrok / X Premium+ login (grok login)
as the primary auth path, with XAI_API_KEY as a documented fallback.

Covers headless (-p) one-shots, interactive TUI via tmux, --output-format
json parsing, session resume, background long-tasks, PR review and
parallel worktree patterns, plus pitfalls (auth subscription gating,
--no-auto-update in automation, Hermes xAI auth vs grok CLI auth).
@alt-glitch alt-glitch added type/feature New feature or request P3 Low — cosmetic, nice to have tool/skills Skills system (list, view, manage) labels May 28, 2026
@boobutler

Copy link
Copy Markdown
Author

Closing — recreated from my personal GitHub account.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low — cosmetic, nice to have tool/skills Skills system (list, view, manage) type/feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants