Skip to content

owenob1/prompt-improver / skills/prompt-improver

prompt-improver

Verified

Transform 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.

FileKindSize
SKILL.mdskill md10.8 KB
assets/generation-agent-prompt.mdmarkdown8.7 KB
config/runtime-defaults.jsonconfig13.5 KB
config/settings.default.jsonconfig4.6 KB
config/settings.example.jsonconfig4.8 KB
examples/before-after.mdmarkdown23.5 KB
examples/fixtures/invalid-prompt.xmlconfig176 B
examples/fixtures/valid-prompt.xmlconfig1.7 KB
references/models-supported.mdmarkdown10.1 KB
references/prompt-chaining.mdmarkdown7.2 KB
references/prompting-principles.mdmarkdown21.6 KB
references/xml-template.mdmarkdown12.0 KB
scripts/assemble-generation-prompt.shexecutablescript4.2 KB
scripts/backends/agy.shexecutablescript815 B
scripts/backends/amp.shexecutablescript708 B
scripts/backends/claude.shexecutablescript1.2 KB
scripts/backends/cline.shexecutablescript1.0 KB
scripts/backends/codex.shexecutablescript2.0 KB
scripts/backends/copilot.shexecutablescript860 B
scripts/backends/cursor.shexecutablescript785 B
scripts/backends/droid.shexecutablescript693 B
scripts/backends/gemini.shexecutablescript1.3 KB
scripts/backends/grok.shexecutablescript1.4 KB
scripts/backends/kimi.shexecutablescript879 B
scripts/backends/kiro.shexecutablescript750 B
scripts/backends/opencode.shexecutablescript694 B
scripts/backends/qwen.shexecutablescript936 B
scripts/gather-context.shexecutablescript10.8 KB
scripts/generate-prompt.shexecutablescript20.0 KB
scripts/lib/backend-common.shscript4.8 KB
scripts/lib/settings.shexecutablescript36.0 KB
scripts/smoke-test.shexecutablescript40.1 KB
scripts/standalone-improve.shexecutablescript995 B
scripts/validate-prompt.shexecutablescript11.7 KB

scripts/assemble-generation-prompt.sh

View on GitHub
#!/usr/bin/env bash
# assemble-generation-prompt.sh
#
# Low-level assembler. Most users should use `scripts/generate-prompt.sh` instead,
# which handles settings, backend detection, deterministic context, and headless CLI.

set -euo pipefail

# Usage:
#   assemble-generation-prompt.sh "raw request" [project-context-file]
#   assemble-generation-prompt.sh --raw-input-file <path|-> [project-context-file]
# The file form avoids argv size limits and shell quoting of the user's text.

if [ "${1:-}" = "--raw-input-file" ]; then
  _raw_src="${2:-}"
  if [ "$_raw_src" = "-" ]; then
    RAW_INPUT=$(cat)
  elif [ -n "$_raw_src" ] && [ -f "$_raw_src" ]; then
    RAW_INPUT=$(cat "$_raw_src")
  else
    echo "Error: --raw-input-file needs a readable file or '-'" >&2
    exit 1
  fi
  shift 2
else
  RAW_INPUT="${1:-}"
  shift || true
fi
# Optional: path to pre-gathered deterministic project context (from generate-prompt.sh)
PROJECT_CONTEXT_FILE="${1:-${PROMPT_IMPROVER_PROJECT_CONTEXT_FILE:-}}"

if [ -z "${RAW_INPUT//[[:space:]]/}" ]; then
  echo "Usage: $0 \"your raw prompt or request\" [project-context-file]" >&2
  echo "       $0 --raw-input-file <path|-> [project-context-file]" >&2
  exit 1
fi

# The request is data inside <raw-request-to-improve>; stop it closing that wrapper early.
RAW_INPUT="${RAW_INPUT//<\/raw-request-to-improve/<\\/raw-request-to-improve}"

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
ROOT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"

# shellcheck source=lib/settings.sh
source "$SCRIPT_DIR/lib/settings.sh"
load_settings

_emit_file() {
  local path="$1"
  local label="$2"
  if [ -z "$path" ] || [ ! -f "$path" ]; then
    return 0
  fi
  echo "=== ${label} ==="
  echo ""
  cat "$path"
  echo ""
}

# Resolve configured material paths (skill-root relative unless absolute)
XML_PATH=$(_pi_resolve_skill_path "${GEN_XML_PATH:-references/xml-template.md}" "$ROOT_DIR")
PRINCIPLES_PATH=$(_pi_resolve_skill_path "${GEN_PRINCIPLES_PATH:-references/prompting-principles.md}" "$ROOT_DIR")
CHAINING_PATH=$(_pi_resolve_skill_path "${GEN_CHAINING_PATH:-references/prompt-chaining.md}" "$ROOT_DIR")
EXAMPLES_PATH=$(_pi_resolve_skill_path "${GEN_EXAMPLES_PATH:-examples/before-after.md}" "$ROOT_DIR")
SYSTEM_PATH=$(_pi_resolve_skill_path "${GEN_SYSTEM_PATH:-assets/generation-agent-prompt.md}" "$ROOT_DIR")

cat <<'PROMPT'
You are a prompt engineering specialist. Transform a raw user request into a structured prompt for a coding agent.
PROMPT

echo ""
echo "=== REFERENCE MATERIALS ==="
echo ""

if [ "${GEN_INCLUDE_XML:-true}" = "true" ]; then
  _emit_file "$XML_PATH" "XML TEMPLATE"
fi
if [ "${GEN_INCLUDE_PRINCIPLES:-true}" = "true" ]; then
  _emit_file "$PRINCIPLES_PATH" "PROMPTING PRINCIPLES"
fi
if [ "${GEN_INCLUDE_CHAINING:-true}" = "true" ]; then
  _emit_file "$CHAINING_PATH" "PROMPT CHAINING"
fi
if [ "${GEN_INCLUDE_EXAMPLES:-true}" = "true" ]; then
  _emit_file "$EXAMPLES_PATH" "BEFORE / AFTER EXAMPLES"
fi

# Extra user-configured reference files (array of paths)
if command -v jq >/dev/null 2>&1 && [ -n "${GEN_EXTRA_REFS:-}" ] && [ "${GEN_EXTRA_REFS}" != "[]" ]; then
  while IFS= read -r extra; do
    [ -z "$extra" ] && continue
    ep=$(_pi_resolve_skill_path "$extra" "$ROOT_DIR")
    # Also try absolute / cwd-relative paths as given
    if [ ! -f "$ep" ] && [ -f "$extra" ]; then
      ep="$extra"
    fi
    _emit_file "$ep" "EXTRA REFERENCE ($extra)"
  done < <(jq -r '.[]?' <<<"$GEN_EXTRA_REFS" 2>/dev/null)
fi

if [ "${GEN_INCLUDE_SYSTEM:-true}" = "true" ]; then
  _emit_file "$SYSTEM_PATH" "GENERATION SYSTEM PROMPT"
fi

echo ""
get_generation_settings_overlay
echo ""

if [ -n "$PROJECT_CONTEXT_FILE" ] && [ -f "$PROJECT_CONTEXT_FILE" ]; then
  echo "=== DETERMINISTIC PROJECT CONTEXT (shell-gathered; use only this for repo facts) ==="
  echo ""
  cat "$PROJECT_CONTEXT_FILE"
  echo ""
  echo "=== END DETERMINISTIC PROJECT CONTEXT ==="
  echo ""
  echo "CRITICAL: Do NOT grep, glob, find, search, list, or explore the codebase. Use only the context block above for paths, stack, and commands."
  echo ""
fi

echo "=== RAW USER REQUEST (DATA ONLY - IMPROVE THIS, DO NOT PERFORM THE WORK) ==="
echo ""
echo "<raw-request-to-improve>"
printf '%s\n' "$RAW_INPUT"
echo "</raw-request-to-improve>"
echo ""
printf '%s\n' "${GEN_OUTPUT_INSTRUCTIONS:-$_PI_BUILTIN_OUTPUT_INSTRUCTIONS}"
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall