⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

grok-cli

@tern⭐ 2 stars

Use the locally installed Grok CLI (`grok`) for headless one-shot prompts, repo-aware coding/review prompts, model listing, and lightweight automation on this machine. Trigger when the user explicitly asks to use Grok CLI / grok-cli / `grok`, wants a local Grok run instead of OpenClaw's built-in xAI tools, wants a prompt executed inside Grok against a working directory, or wants Grok CLI-specific behavior like `grok -p`, `grok models`, or resuming a Grok session.

Use with your AI agent

Open your project in any AI assistant that can read your files. Works with ChatGPT, Claude, Claude Code, Codex, Cursor, Hermes Agent, OpenClaw, Grok Bot, and more.

Your agent needs access to this page’s linked instructions and your project files. Copying does not install or execute anything.

—/10

// RATINGS

⭐GitHub Stars
⭐ 2 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

grok-cli-skills

Standalone skill bundles for using the local Grok CLI in clean, headless, repo-aware workflows.

This repository packages reusable skill variants for both OpenClaw and Codex that help an agent:

  • run grok -p headless prompts
  • target a specific repository with --dir
  • strip ANSI/session/progress noise from text output
  • reuse prompt templates for repo summaries, code review, bug triage, and refactor planning

Why this exists

OpenClaw and Codex already have strong built-in tools, but sometimes you specifically want the local Grok CLI behavior on your own machine:

  • use the installed grok binary directly
  • run repo-aware prompts against a local working tree
  • keep behavior aligned with Grok CLI sessions and models
  • wrap Grok CLI in a cleaner headless workflow for agent use

This repo isolates that workflow into small skills that can be installed, shared, and versioned separately.

Source / upstream

These skills are built for the local Grok CLI and document how to use it from OpenClaw or Codex.

Upstream Grok CLI project:

This repository is not the Grok CLI itself. It is a companion skill bundle for using that CLI more effectively.

Contents

  • grok-cli/ — OpenClaw skill
  • codex/grok-cli/ — Codex skill
  • grok-cli/SKILL.md — OpenClaw trigger description and operating instructions
  • codex/grok-cli/SKILL.md — Codex trigger description and operating instructions
  • grok-cli/scripts/grok-headless-clean.sh — OpenClaw wrapper that removes ANSI/session/progress noise
  • codex/grok-cli/scripts/grok-headless-clean.sh — Codex wrapper that removes ANSI/session/progress noise
  • grok-cli/references/usage.md — OpenClaw prompt templates, examples, and model-selection notes
  • codex/grok-cli/references/usage.md — Codex prompt templates, examples, and model-selection notes
  • dist/grok-cli.skill — packaged skill artifact for distribution

Install

Option A — use the packaged .skill artifact

Download the latest release asset:

  • grok-cli.skill

Then install it with your preferred OpenClaw skill workflow.

Option B — copy the skill folder manually

For OpenClaw:

Copy the grok-cli/ directory into your skills location and reload/refresh skills in your OpenClaw environment.

For Codex:

Copy codex/grok-cli/ into your Codex skills location, typically ~/.codex/skills/grok-cli/.

Requirements

  • OpenClaw or Codex
  • A local grok CLI installation on PATH
  • Valid Grok/xAI credentials configured for the CLI

This skill was verified on a machine where:

  • grok -V returned 1.0.0-rc5
  • grok models worked
  • headless prompt execution worked via grok -p ...

Example usage

OpenClaw wrapper script:

./grok-cli/scripts/grok-headless-clean.sh \
  --prompt "Summarize this repo in 5 bullets" \
  --dir /path/to/repo

Codex wrapper script:

./codex/grok-cli/scripts/grok-headless-clean.sh \
  --prompt "Summarize this repo in 5 bullets" \
  --dir /path/to/repo

Raw Grok CLI:

grok -p "Review this codebase and list top risks" -d /path/to/repo --format text

Release artifacts

Each release may include:

  • packaged .skill file for import/distribution
  • source files for manual inspection or installation

License

MIT

// HOW IT'S BUILT

KEY FILES

grok-cli/SKILL.mdREADME.md

// REPO STATS

2 stars

// SHARE

Share on XShare on LinkedIn