Skip to content

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

Merged
teknium1 merged 3 commits into
mainfrom
hermes/hermes-59775f96
May 29, 2026
Merged

feat(skills): add optional grok skill for xAI Grok Build CLI#34582
teknium1 merged 3 commits into
mainfrom
hermes/hermes-59775f96

Conversation

@teknium1

Copy link
Copy Markdown
Contributor

Summary

Adds an optional grok skill — the third coding-agent orchestrator alongside codex and claude-code, teaching Hermes to delegate coding tasks to xAI's Grok Build CLI (the grok command).

Salvages #34060 by @MattMaximo. Placed in optional-skills/autonomous-ai-agents/ (next to openhands/blackbox) rather than bundled.

Changes

  • optional-skills/autonomous-ai-agents/grok/SKILL.md: headless -p one-shots, interactive PTY+tmux, ACP (grok agent stdio), PR-review + parallel-worktree patterns, ~/.grok/config.toml reference, pitfalls. Frames every invocation through Hermes' terminal/process tools like the sibling skills.
  • Frontmatter polish: optional placement, description tightened 165 → 54 chars, version 1.0.0 → 0.1.0, author credits Matt Maximo first.
  • Docs: regenerated catalog row + sidebar entry + auto-gen page (scoped to grok only).

Validation

Verified every documented flag/command against x.ai docs (-p/--single, -s/-r/-c, --cwd, --output-format, --always-approve, --no-alt-screen, --no-auto-update, grok agent stdio, grok inspect, permission_mode in ~/.grok/config.toml) — all real, no fabrication. npm package @xai-official/grok confirmed live (v0.2.11).

Before After
Placement bundled skills/ optional optional-skills/
Description 165 chars 54 chars
Author Hermes Agent Matt Maximo (MattMaximo), Hermes Agent

Infographic

grok-skill

MattMaximo and others added 3 commits May 29, 2026 04:11
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
@teknium1
teknium1 merged commit d6f2bda into main May 29, 2026
17 checks passed
@teknium1
teknium1 deleted the hermes/hermes-59775f96 branch May 29, 2026 11:49
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