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.
config/settings.default.json
View on GitHub{
"version": 1,
"//": "Shipped defaults. Prefer editing a copy at ~/.config/prompt-improver/settings.json or .prompt-improver/settings.json (see settings.example.json). Keys starting with // are comments only. Tables (aliases, chains, commands) live in config/runtime-defaults.json — override any key here or in your copy.",
"//backend": "auto | claude | grok | gemini | codex | agy | copilot | cursor | opencode | cline | qwen | droid | amp | kimi | kiro — Env: PROMPT_IMPROVER_BACKEND",
"backend": "auto",
"//model": "null = per-backend defaults below. Env: PROMPT_IMPROVER_MODEL. Per-prompt model: wins.",
"model": null,
"//default_models": "Generator model per CLI when model is null. null = leave the CLI's own default (multi-provider CLIs use their own model ids). claude uses the `opus` alias, which tracks the newest Opus.",
"default_models": {
"claude": "opus",
"grok": "grok-4.7",
"gemini": "gemini-3.8-flash",
"codex": "gpt-6-sol",
"agy": null,
"copilot": null,
"cursor": null,
"opencode": null,
"cline": null,
"qwen": null,
"droid": null,
"amp": null,
"kimi": null,
"kiro": null
},
"//max_tokens": "Soft cap passed through where backends support it (best-effort). Env: PROMPT_IMPROVER_MAX_TOKENS",
"max_tokens": 12000,
"//enable_research": "When false, generator omits/minimizes <research> blocks. Env: PROMPT_IMPROVER_ENABLE_RESEARCH",
"enable_research": true,
"//enable_thinking": "When false, generator omits <approach> blocks unless safety-critical. Env: PROMPT_IMPROVER_ENABLE_THINKING",
"enable_thinking": true,
"//headless_only": "When true, host should not rewrite prompts in-session when headless fails. Env: PROMPT_IMPROVER_HEADLESS_ONLY",
"headless_only": true,
"//allow_web_search": "When false, improved prompts must not instruct web search. Env: PROMPT_IMPROVER_ALLOW_WEB_SEARCH",
"allow_web_search": true,
"//allow_code_execution_in_generation": "When false, generator must not run gather-context.sh or shell. Env: PROMPT_IMPROVER_ALLOW_CODE_EXECUTION",
"allow_code_execution_in_generation": false,
"//skip_validate": "When true, skip validate-prompt.sh after headless generation. Env: PROMPT_IMPROVER_SKIP_VALIDATE",
"skip_validate": false,
"//backend_invocation": "scripts = use scripts/backends/*.sh; commands = use backend_commands templates; auto = templates when you override backend_commands. Env: PROMPT_IMPROVER_BACKEND_INVOCATION",
"backend_invocation": "scripts",
"//fallback_strategy": "manual = host bounce on limit exhaustion; error = hard fail",
"fallback_strategy": "manual",
"//preferred_backends": "Order to try OTHER generators after the primary fails — not the default pick. kimi is left out because its -p mode auto-approves tools.",
"preferred_backends": [
"claude",
"codex",
"grok",
"gemini",
"agy",
"copilot",
"cursor",
"opencode",
"cline",
"qwen",
"droid",
"amp",
"kiro"
],
"//custom_command": "Any CLI: prompt on stdin → improved text on stdout. Bypasses built-in backends. Env: PROMPT_IMPROVER_CUSTOM_COMMAND",
"custom_command": null,
"notes": "Fully customisable runtime tables: model_aliases, model_fallback_chains, model_backend_patterns, backend_commands, backend_model_flags, supported_backends, limit_detection, host_env_markers, parent_process_patterns, cascade_scan_order — see config/runtime-defaults.json; override any in your settings.json.\n\nModel resolution: 1) model:/--model 2) PROMPT_IMPROVER_MODEL 3) default_models[backend] 4) CLI default.\nCustom CLIs: custom_command (docs/CUSTOM-BACKENDS.md).\nGeneration materials + context_mode: see generation object / runtime-defaults.json.",
"generation": {
"context_mode": "deterministic",
"include_xml_template": true,
"include_principles": true,
"include_chaining": true,
"include_examples": true,
"include_system_prompt": true,
"system_prompt_path": "assets/generation-agent-prompt.md",
"xml_template_path": "references/xml-template.md",
"principles_path": "references/prompting-principles.md",
"chaining_path": "references/prompt-chaining.md",
"examples_path": "examples/before-after.md",
"extra_reference_paths": [],
"output_instructions": "Output ONLY the final improved XML prompt. No explanation, no code fences, no commentary, no execution of the request.",
"require_xml_output": true,
"forbid_agent_codebase_search": true,
"backend_timeout_secs": 300,
"grok_timeout_secs": 180,
"grok_max_turns": 3
},
"//generation": "Customise generation materials and deterministic context. Full defaults: config/runtime-defaults.json → generation"
}
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 |