I released v0.5.3 of the Claude Code Prompt Improver today. The project is past 1.4K stars on GitHub. Here is what changed in the v0.5.x releases.
Summary
New PreToolUse hook adds readability guidance when Claude enters plan mode
Vague prompt research now runs in Task/Explore subagents on Haiku instead of the main context
Marketplace renamed to severity1-marketplace
Windows install works now (python3 || python fallback)
What is the plugin?
A UserPromptSubmit hook that checks if a prompt is vague before Claude Code runs it. Clear prompts pass through. Vague prompts trigger the prompt-improver skill. The skill researches the codebase and asks 1 to 6 questions using AskUserQuestion. The hook adds about 189 tokens per prompt. Clear prompts do not load the skill.
v0.5.3: Plan mode readability
Plans got long on revisions. Claude added text like “previously I considered X but rejected it because Y” and the plan grew with each pass. The new hook runs on EnterPlanMode and tells the model:
Keep the problem statement, remove decision history
On revisions, rewrite the full plan clean. Do not append or annotate.
One action per step. Use file paths as anchors like src/auth.ts:42.
Use short action steps, not long explanations.
This release also fixes a bug in hooks/hooks.json. The PreToolUse entry used a tools array, which is not part of the Claude Code hook spec. Claude Code ignored the field and the hook ran on every tool call. The fix uses the official matcher field. If your own hook has "tools": inside a PreToolUse entry, you probably have the same bug.
v0.5.2: Subagent-first research dispatch
When a prompt was vague, the skill called Glob, Grep, WebSearch, and other search tools directly in the main context. This used main-model tokens for search work. Now those tools run through Task/Explore. Explore uses Haiku and a separate context window. The main context only handles git commands, single-file Reads of user-named files, synthesis, and the question to the user.
v0.5.1 and v0.5.0: Maintenance
Marketplace renamed from claude-code-marketplace to severity1-marketplace
Hook command uses python3 || python so it works on Windows
CLAUDE.md
uses the auto-memory format now
Install
claude plugin marketplace add severity1/severity1-marketplace claude plugin install prompt-improver@severity1-marketplace
Repo:
https://github.com/severity1/claude-code-prompt-improver
Feedback is welcome, especially on the plan mode guidance wording
submitted by
/u/crystalpeaks25
Originally posted by u/crystalpeaks25 on r/ClaudeCode