owenob1/prompt-improver / skills/prompt-improver
prompt-improver
VerifiedTransform vague prompts into precise, verifiable structured XML prompts that coding agents execute reliably. Modes: execute (default — generate then run) and plan (generate XML for review first). Use when the user says improve prompt, make this work better, prompt engineer, structure a request, plan a complex change before coding, or when a rough request needs verification criteria before execution. Do not use when the input is already a well-structured XML prompt or detailed implementation spec — skip generation and execute directly.
scripts/backends/grok.sh
View on GitHub#!/usr/bin/env bash
# scripts/backends/grok.sh
# xAI Grok Build CLI headless. Honors PROMPT_IMPROVER_MODEL.
#
# Known CLI quirks (observed on 0.2.x; still guarded on 1.x):
# - The process may hang after writing the final answer (never exits).
# - --prompt-file hangs more often than -p for short prompts.
# Mitigation: -p when the prompt fits argv, else --prompt-file; always bounded
# by a timeout (generation.grok_timeout_secs, default 180); non-empty stdout
# plus a timeout exit (124/137/143) counts as success.
set -euo pipefail
# shellcheck source=../lib/backend-common.sh
source "$(cd "$(dirname "${BASH_SOURCE[0]}")/../lib" && pwd)/backend-common.sh"
pi_backend_init "${1:-}"
pi_require_cli "See https://docs.x.ai/build/overview" grok
export PROMPT_IMPROVER_BACKEND_TIMEOUT="${PROMPT_IMPROVER_GROK_TIMEOUT:-${PROMPT_IMPROVER_BACKEND_TIMEOUT:-180}}"
MAX_TURNS="${PROMPT_IMPROVER_GROK_MAX_TURNS:-3}"
ARGS=(
--output-format plain
--always-approve
--no-subagents
--no-plan
--disable-web-search
--max-turns "$MAX_TURNS"
)
if [ -n "${PROMPT_IMPROVER_MODEL:-}" ]; then
ARGS+=(-m "$PROMPT_IMPROVER_MODEL")
fi
code=0
if pi_prompt_fits_argv; then
pi_run_bounded "$PI_OUT_FILE" "$PI_ERR_FILE" grok -p "$(cat "$PI_PROMPT_FILE")" "${ARGS[@]}" || code=$?
else
echo "Prompt is $(pi_prompt_size) bytes; using --prompt-file." >&2
pi_run_bounded "$PI_OUT_FILE" "$PI_ERR_FILE" grok --prompt-file "$PI_PROMPT_FILE" "${ARGS[@]}" || code=$?
fi
pi_finish grok "$code" true
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |