Skip to content

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

Closed
MattMaximo wants to merge 1 commit into
NousResearch:mainfrom
MattMaximo:feat/grok-skill
Closed

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

Conversation

@MattMaximo

Copy link
Copy Markdown
Contributor

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

- Headless `-p` one-shots (preferred)
- Interactive TUI via pty + tmux
- Session resume, background tasks, structured JSON output
- PR review and parallel worktree patterns
- Auth via SuperGrok / X Premium+ (`grok login`)
- Full pitfalls and config notes
@alt-glitch alt-glitch added type/feature New feature or request tool/skills Skills system (list, view, manage) P3 Low — cosmetic, nice to have labels May 29, 2026
@alt-glitch

Copy link
Copy Markdown
Collaborator

Resubmission of closed #34040. New grok skill for xAI Grok Build CLI delegation.

@teknium1

Copy link
Copy Markdown
Contributor

Merged via #34582 as an optional skill (optional-skills/autonomous-ai-agents/grok). Your commit was cherry-picked onto current main with your authorship preserved in git log. Verified every flag/command against the x.ai docs — all accurate. Thanks Matt!

@teknium1 teknium1 closed this May 29, 2026
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