Claude to grok
Skill shinpr/grok-workflows/plugins/claude-to-grok/skills/claude-to-grok
Run Claude Code Workflows (CCW) on Grok: single install path plus a runtime translation layer
npx -y skills add shinpr/grok-workflows --skill claude-to-grokAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 26 days oldThe repository was created 26 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Maps Claude Code tool, agent, and progress-tracking identifiers to Grok runtime equivalents while preserving claude-code-workflows (dev-workflows*) execution semantics. Use when running dev-workflows* on Grok, including recipe-* orchestration that needs CC→Grok translation.
SKILL.md
8.4 KB, ~2.0k tokens by cl100k_base, as published. Nobody here has run it
Claude → Grok (CCW runtime map)
Runtime invariants
- Preserve CCW execution — keep every CCW step,
[Stop]gate, handoff contract, review loop, commit cycle, and quality gate mandatory. - Translate identifiers — replace Claude Code tool/agent names with the Grok tools in the maps; keep prompt what, deliverable paths, and acceptance criteria unchanged.
- Use the required specialist — spawn exclusively the plugin-qualified CCW agent type named by the recipe (
dev-workflows-fullstack:<name>or the backend/frontend prefix). - Register progress — fulfill CCW
TaskCreate/TaskUpdateduties withtodo_write(session todos; duty-level equivalent only — see Progress tracking). - Handle runtime failures — when a mapped tool or agent cannot complete, follow the Runtime failure procedure. Map only documented equivalents.
Recipe invocation remains exclusively user-slash initiated (disable-model-invocation on recipe-*). This skill activates for translation during orchestration.
Tool name map (Claude Code → Grok)
| Claude Code (in CCW text) | Grok tool | Notes |
|---|---|---|
Agent / Task | spawn_subagent | Fresh call per phase. Then wait — see Waiting for a subagent. Use resume_from only when CCW explicitly continues the same subagent session. |
Bash | run_terminal_command | git commit, ls, verification shells |
Read | read_file | |
Write | write | New file or full overwrite |
Edit / MultiEdit | search_replace | Prefer exact old→new edits; use write when full-file write is clearer |
Grep | grep | |
Glob / LS / ListDir | list_dir + grep / run_terminal_command as needed | Discover paths via list_dir or shell only when list_dir is insufficient |
WebSearch | web_search | |
AskUserQuestion | ask_user_question | All [Stop] confirmations |
TaskCreate / TaskUpdate | todo_write | Duty equivalent — see Progress tracking |
SendMessage (resume) | spawn_subagent + resume_from | Prefer fresh spawn_subagent per CCW isolation; resume_from only when CCW continues the same session |
Orchestrator write tools: use mapped Edit/Write tools only inside specialists that CCW allows to edit.
Waiting for a subagent
CCW text says “invoke Agent and use the result”; it does not name a Grok wait API.
After spawn_subagent:
- Read the returned subagent id (or task id from the tool result).
- Call
get_command_or_subagent_outputwith that id (use a positivetimeout_mswhen waiting for completion). - WHEN the subagent is still running or the wait times out, wait again with the same id.
- WHEN it completes with a final payload, use that payload as the specialist result and continue the CCW flow (Stop, next specialist, etc.).
- WHEN it fails, is cancelled, or completes without a final payload, run the Runtime failure procedure.
Treat the spawn result as pending unless it already contains a completed final payload. spawn_subagent often runs in the background by default.
Subagent type map
Canonical form:
dev-workflows-fullstack:<agent-name>
CCW subagent_type text | Grok subagent_type |
|---|---|
requirement-analyzer | dev-workflows-fullstack:requirement-analyzer |
task-executor | dev-workflows-fullstack:task-executor |
task-executor-frontend | dev-workflows-fullstack:task-executor-frontend |
quality-fixer | dev-workflows-fullstack:quality-fixer |
quality-fixer-frontend | dev-workflows-fullstack:quality-fixer-frontend |
document-reviewer | dev-workflows-fullstack:document-reviewer |
technical-designer | dev-workflows-fullstack:technical-designer |
technical-designer-frontend | dev-workflows-fullstack:technical-designer-frontend |
work-planner | dev-workflows-fullstack:work-planner |
task-decomposer | dev-workflows-fullstack:task-decomposer |
codebase-analyzer | dev-workflows-fullstack:codebase-analyzer |
code-verifier | dev-workflows-fullstack:code-verifier |
security-reviewer | dev-workflows-fullstack:security-reviewer |
acceptance-test-generator | dev-workflows-fullstack:acceptance-test-generator |
design-sync | dev-workflows-fullstack:design-sync |
integration-test-reviewer | dev-workflows-fullstack:integration-test-reviewer |
prd-creator | dev-workflows-fullstack:prd-creator |
ui-analyzer | dev-workflows-fullstack:ui-analyzer |
ui-spec-designer | dev-workflows-fullstack:ui-spec-designer |
WHEN the installed plugin is backend-only or frontend-only, use:
dev-workflows:<agent-name>dev-workflows-frontend:<agent-name>
Use the plugin-qualified subagent type. WHEN it is unavailable, inspect the registered subagent types and follow the Runtime failure procedure. Use a bare name only when inspection shows that exact bare name is registered.
Progress tracking (TaskCreate / TaskUpdate → todo_write)
Fulfill the same registration duty with todo_write:
| CCW intent | Grok action |
|---|---|
| Register all flow steps after scale determination | todo_write (merge: false or first write) listing every step; include “Map preloaded skills to concrete rules” when the agent requires it |
| Mark current step in progress | todo_write merge: true, status: in_progress |
| Complete a step | merge: true, status: completed |
| Specialist internal TaskCreate first/last tasks | Same via todo_write inside that subagent when it has the tool |
Duty limits
todo_writeis session todo state, not Claude’s Task board API.- Use stable string IDs (e.g.
flow-req-analyzer,flow-prd). - MCP scheduled tasks represent scheduled jobs; use
todo_writefor CCW progress registration. - IF progress registration is required and
todo_writeis unavailable → Runtime failure procedure.
Subagent prompt construction
Keep CCW prompt rules. Always include:
- Concrete deliverable paths with every placeholder resolved
- Expected action
- Scope boundary block from the recipe when the recipe requires it
- Runtime footer WHEN the selected agent instructions or delegated prompt refer to Claude Code tool names:
Runtime (Grok): Agent/Task→spawn_subagent then get_command_or_subagent_output;
Bash→run_terminal_command; Read→read_file; Edit/MultiEdit→search_replace; Write→write;
AskUserQuestion→ask_user_question; TaskCreate/TaskUpdate→todo_write (duty).
subagent_type prefix: dev-workflows-fullstack: (or dev-workflows: / dev-workflows-frontend:).
Preserve every CCW step and gate.
Orchestrator tool surface (mapped)
| CCW permitted | Grok |
|---|---|
| Agent | spawn_subagent + wait via get_command_or_subagent_output |
| AskUserQuestion | ask_user_question |
| TaskCreate / TaskUpdate | todo_write |
| Bash | run_terminal_command |
| Read | read_file |
Implementation Edit/Write/MultiEdit remain specialist-only per CCW.
Runtime failure procedure
WHEN a mapped operation cannot complete (including: no map row, agent not registered, spawn_subagent failed, subagent failed/cancelled, no final payload, mapped tool missing from the current surface):
- Record the attempted CCW obligation, mapped Grok operation, and observed result.
- Inspect the currently available Grok tools or subagent types relevant to that operation.
- Retry only when the result indicates a transient or still-running state.
- Continue with a documented equivalent when the current environment exposes one that appears in this skill’s maps.
- WHEN no executable equivalent is available, report using the format below.
Runtime failure output
## Unresolved CCW→Grok runtime failure
- CCW obligation:
- Mapped Grok operation:
- Observed result:
- Available tools or subagent types checked:
- Missing capability:
- User action or information required:
Scope
This skill covers runtime identifier translation, progress-duty translation, subagent waiting, and runtime-failure reporting. CCW defines recipe bodies, workflow gates, and quality policy.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.