Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
Delegate bounded tasks to Grok Build from a supervising agent such as Codex.
Install Grok CLI
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add scarletkc/agents --skill grok-cli -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install scarletkc/agents grok-cli --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/scarletkc/agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/grok-cli .claude/skills/grok-cli && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "grok-cli" agent skill from https://github.com/scarletkc/agents/tree/main/skills/grok-cli into .claude/skills/grok-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grok-cli", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/scarletkc/agents/tree/main/skills/grok-cliType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add scarletkc/agents --skill grok-cli -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install scarletkc/agents grok-cli --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/scarletkc/agents.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/grok-cli .agents/skills/grok-cli && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "grok-cli" agent skill from https://github.com/scarletkc/agents/tree/main/skills/grok-cli into .agents/skills/grok-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grok-cli", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add scarletkc/agents --skill grok-cli -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install scarletkc/agents grok-cli --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/scarletkc/agents.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/grok-cli .cursor/skills/grok-cli && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "grok-cli" agent skill from https://github.com/scarletkc/agents/tree/main/skills/grok-cli into .cursor/skills/grok-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grok-cli", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/scarletkc/agents.git --path skills/grok-cli--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add scarletkc/agents --skill grok-cli -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install scarletkc/agents grok-cli --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/scarletkc/agents.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/grok-cli .gemini/skills/grok-cli && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "grok-cli" agent skill from https://github.com/scarletkc/agents/tree/main/skills/grok-cli into .gemini/skills/grok-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grok-cli", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install scarletkc/agents grok-cliInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add scarletkc/agents --skill grok-cli -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/scarletkc/agents.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/grok-cli .github/skills/grok-cli && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "grok-cli" agent skill from https://github.com/scarletkc/agents/tree/main/skills/grok-cli into .github/skills/grok-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grok-cli", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add scarletkc/agents --skill grok-cli -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install scarletkc/agents grok-cli --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/scarletkc/agents.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/grok-cli .opencode/skills/grok-cli && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "grok-cli" agent skill from https://github.com/scarletkc/agents/tree/main/skills/grok-cli into .opencode/skills/grok-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "grok-cli", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
grok-cli- GitHub stars
- 224
- Token cost
- ~1.5k tokens
- SKILL.md length
- 703 words
- Files
- 6 (incl. scripts, references)
- Skills in repo
- 11
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Delegate bounded tasks to Grok Build from a supervising agent such as Codex.
- The user asks Grok to investigate
- SKILL.md covers Delegate a task, Configuration and permissions and Supervise the result
- Runs Python scripts from its folder; calls python and uv
- Provide another perspective
What it does
Grok CLI is an agent skill from scarletkc/agents. Delegate bounded tasks to Grok Build from a supervising agent such as Codex. Use when the user asks Grok to investigate, review, implement, or provide another perspective, or when a distinct coding agent would materially help. Includes a background ACP client for progress, follow-up prompts, permissions, and cancellation.
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including scripts and reference files (for example `references/client.md`, `scripts/acp_client.py` and `scripts/agent_task_runtime.py`).
It sits in Development. The repository describes itself as: Shared standards and reusable skills for Claude Code, Codex CLI, and other AI coding agents. The licence is Apache-2.0.
When your agent uses it
- The user asks Grok to investigate
- Provide another perspective
- A distinct coding agent would materially help
Example prompts
- “/grok-cli”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit eb55005. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 4 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
pythonuv
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Grok CLI loads about 1.5k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 703 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: warnings
The automated check found patterns that need a careful read before installing.
- WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:68
lt can be checked. Make routine choices without asking the user:
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from scarletkc/agents at commit eb55005, republished under its Apache-2.0 licence (© scarletkc). 703 words, ~1,463 tokens.
Download SKILL.mdSave it as
.claude/skills/grok-cli/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.- name
- grok-cli
- description
- Delegate bounded tasks to Grok Build from a supervising agent such as Codex. Use when the user asks Grok to investigate, review, implement, or provide another perspective, or when a distinct coding agent would materially help. Includes a background ACP client for progress, follow-up prompts, permissions, and cancellation.
- license
- Apache-2.0
- metadata.author
- scarletkc
- metadata.source
- https://github.com/scarletkc/agents
- metadata.summary
- Delegate work to Grok Build, keep its session for follow-ups, and inspect results while the supervising agent continues working.
Grok CLI
Use Grok Build as a separate coding agent on the same machine. The bundled
client launches grok agent --no-leader stdio, keeps its ACP session open,
and returns a task ID immediately. This is an external task: it does not
appear in Codex's native spawn_agent tree or inherit its conversation.
Grok Build must already be installed and configured. Use the project's
Python 3.12+ interpreter to run scripts/grok.py; the
client uses only the standard library. If the project has no interpreter,
uv run --python 3.12 <script> ... also works. Resolve the script relative
to this installed skill, not the repository being investigated.
Delegate a task
Give Grok the goal, absolute working directory, relevant files and evidence, scope boundaries, and the check that proves completion. It cannot see the conversation that led to the assignment. Keep independent work with the supervising agent while Grok runs.
Use a UTF-8 prompt file for substantial instructions. In these examples,
<script> is the absolute path to this skill's scripts/grok.py:
python <script> start --cwd <absolute-project-path> --prompt-file <task-file>
python <script> wait <task_id> --timeout 30
python <script> status <task_id>
python <script> reply <task_id> --prompt-file <follow-up-file>
python <script> cancel <task_id>
python <script> close <task_id>Retain the returned task_id. Use wait when there is no independent work
left; its timeout returns the current state without cancelling the task.
Use reply after the current turn finishes to continue the same Grok
session. A running turn must finish or acknowledge cancellation before a
follow-up is accepted. Close the task once no more follow-ups are needed.
The helper's --help is the command reference. For output fields, storage,
timeouts, and troubleshooting, read references/client.md.
Configuration and permissions
Inherit Grok's model, authentication, and permission configuration unless the task requires a specific override. Subscription login, API keys, and configured providers are Grok's concern; do not change the user's configuration or choose another authentication route to get past a failure. The helper uses Grok's advertised noninteractive default authentication method when available. Interactive authentication is completed separately through Grok itself.
start --model, --effort, --permission-mode, and --sandbox are
per-task overrides. Omit them when no override is needed. Do not use a
permission bypass merely to avoid handling an approval request.
Choose --effort for the delegated task. Honor the user's explicit choice;
otherwise weigh complexity, the cost of an incorrect result, and how easily
the result can be checked. Make routine choices without asking the user:
- Simple chat, rewriting, or mechanical work can use a lower effort level.
- Ordinary implementation and analysis generally suit a middle level.
- Difficult debugging and consequential code review may justify a higher level.
These are starting points, not fixed task-to-level rules. Use only levels
known to be supported by the selected model. When support or the appropriate
level is uncertain, omit --effort and inherit Grok's configured value.
Show full SKILL.md (274 more words)Show less
Match permissions to the authorized work. Preserve read-only restrictions for read-only assignments; allow the necessary file edits and checks for an authorized implementation within its scope. Task complexity and reasoning effort do not expand that authorization.
When status is needs_approval, inspect pending_permissions and answer
the relevant request with:
python <script> permission <task_id> --request-id <request_id> --option-id <optionId>Select an option Grok actually offered. Approve actions already covered by the user's assignment; prefer a single-use approval. Decisions beyond that scope stay with the user. Configured Grok allow rules can execute tools without producing an ACP approval request. A read-only task prompt or refusing an ACP request is not an OS sandbox; Codex's sandbox does not configure Grok's. Do not promise enforced isolation without verifying Grok's sandbox on the target platform.
Supervise the result
Avoid simultaneous edits to the same files. Use a separate worktree when
both agents need to edit overlapping code, and pass its absolute path as
--cwd; the helper does not create worktrees.
Read status, closed, stop_reason, and error together. A returned
task ID means the worker started, not that Grok authenticated or finished.
completed means Grok ended its turn, not that its claims were verified.
Inspect the actual diff or cited evidence and run the relevant checks.
If Grok is unavailable or an installation, configuration, authentication, tool, or process failure blocks the task, explicitly tell the user what failed and which work remains incomplete. Inspect any partial result before retrying. Do not silently substitute your own work, another agent, or another provider for the requested Grok task. Report what Grok contributed and what the supervising agent verified. Committing, publishing, and other external actions keep the authorization boundaries of the original task.
© scarletkc, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 5 other files (scripts, references) in skills/grok-cli of scarletkc/agents.
- SKILL.md
- references/client.md
- scripts/acp_client.py
- scripts/agent_task_runtime.py
- scripts/grok.py
- scripts/windows_job.py
Open the folder on GitHubat commit eb55005
Compare with similar skills
Grok CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Grok CLI this skillscarletkc/agents | 224 | — | ~1.5k | Automated safety check: Warn | Apache-2.0 | |
| Finishing a Development Branchobra/superpowers | 296k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Typescript Advanced Typesrolling-scopes/rsschool-app | 10k | 24 repos | ~4.2k | Automated safety check: Pass | MPL-2.0 | |
| PR Babysitteropeninterpreter/openinterpreter | 69k | 3 repos | ~4.2k | Automated safety check: Pass | Apache-2.0 | |
| Code Review ChecklistshareAI-lab/learn-claude-code | 78k | 5 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Greplooponyx-dot-app/onyx | 32k | 4 repos | ~3.3k | Automated safety check: Pass | MIT |
Similar skills
Typescript Advanced Types
rolling-scopes/rsschool-app
Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.
PR Babysitter
openinterpreter/openinterpreter
Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.
Code Review Checklist
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
Greploop
onyx-dot-app/onyx
Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.
Guidelines
akash-network/node
Behavioral guidelines to reduce common LLM coding mistakes. An agent skill from akash-network/node.
More from scarletkc/agents
All 11 skills in this repoAntigravity CLI
scarletkc/agents
Delegate bounded investigation, review, or implementation tasks to Antigravity CLI from a supervising agent.
Talk Like Scarletkc
scarletkc/agents
按 scarletkc 本人的自然表达习惯代写、改写、润色和翻译文本，适用于推文、评论、聊天消息、模型或工具体验文、项目介绍、GitHub 文本和正式通信。用户要求撰写可直接使用的成稿、去除 AI 腔，或在翻译中保留本人语气和立场时使用，无需明确点名本 skill。单纯的事实问答、技术分析、代码审查和任务讨论不触发。
Ask To Plan
scarletkc/agents
Guide a user from an unclear idea to an actionable plan through the agent harness's native ask tool and clickable choices.
Codex CLI
scarletkc/agents
When handing work to the Codex CLI earns its cost, and how to size the run: second-model review, bounded implementation hand-offs, sandbox permissions, model and reasoning effort.
Marketing Copy
scarletkc/agents
Write outbound promotional copy for a product or project: launch and update posts for community platforms and social media, store page descriptions and short blurbs, landing page headlines and calls…
Scoped Change
scarletkc/agents
Judgment rules for locating the correct boundary of a requested change: staying inert outside it while completing every required site inside it.
Related
Categories
Questions about Grok CLI
What does Grok CLI do?
Delegate bounded tasks to Grok Build from a supervising agent such as Codex. Grok CLI is an agent skill from scarletkc/agents. Delegate bounded tasks to Grok Build from a supervising agent such as Codex.
When should I use Grok CLI?
Grok CLI fits situations like: the user asks Grok to investigate; provide another perspective; A distinct coding agent would materially help.
How do I install Grok CLI in Claude Code?
Run `npx skills add scarletkc/agents --skill grok-cli -a claude-code`. Or copy the skill folder (skills/grok-cli in scarletkc/agents) into .claude/skills/grok-cli in your project. Claude Code loads it when a task matches its description.
How do I install Grok CLI in Codex?
Run `npx skills add scarletkc/agents --skill grok-cli -a codex`. Or copy the skill folder (skills/grok-cli in scarletkc/agents) into .agents/skills/grok-cli in your project. Codex loads it when a task matches its description.
Can I use Grok CLI in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add scarletkc/agents --skill grok-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/grok-cli, .gemini/skills/grok-cli, .github/skills/grok-cli and .opencode/skills/grok-cli in your project.
What does Grok CLI need to run?
Going by SKILL.md and its folder, Grok CLI needs Python for the scripts in its folder and the command-line tools its instructions call (python and uv). Our summary lists: Python 3.
Does Grok CLI access the network?
SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Is Grok CLI safe to install?
Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Grok CLI use?
Grok CLI is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Grok CLI use?
About 1.5k tokens (SKILL.md is roughly 5.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.2k tokens, read only when the agent opens those files.
What are the alternatives to Grok CLI?
Skills that share tags, products or a category with Grok CLI: Finishing a Development Branch (obra/superpowers, 296k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars), PR Babysitter (openinterpreter/openinterpreter, 69k stars) and Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Grok CLI?
scarletkc (a GitHub user) maintains it in scarletkc/agents, which has 224 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 21, 2026.
Source: scarletkc/agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.