Directory · Hooks

Claude Code Prompt Improver

Hook plugin that checks prompt clarity and injects targeted context nudges at prompt submit, tool use, and subagent start in Claude Code.

★ 1,952 stars · last updated 2026-10-01 · Free, open source · View on GitHub

Best for

• Claude Code users who often write short or vague prompts
• Reducing correction round-trips by having Claude ask grounded clarifying questions
• Adding plan-mode, background-exec, and subagent guidance automatically
• Teams wanting a declarative JSON registry for custom inject-context hooks

Install

claude plugin marketplace add severity1/severity1-marketplace
claude plugin install prompt-improver@severity1-marketplace

Our take

Requires Claude Code 2.0.22+ and uses the AskUserQuestion tool to ask 1-6 questions only when a prompt is judged vague; clear prompts proceed without loading the skill. Built as a single Python engine driven by JSON nudge files, so new nudges can be added without code changes, and prompts can bypass evaluation with a * prefix. Actively maintained, MIT licensed, with marketplace, local plugin, and manual settings.json install options.

Similar hooks

• Claude Code Ultimate Guide: Large open guide to Claude Code covering agent workflows, hooks, skills, MCP, security, and team adoption, with reusable templates.
• Claude Code Showcase: Example Claude Code project config with hooks, skills, agents, slash commands, MCP setup, and GitHub Actions workflows to copy from.
• Continuous Claude v3: Hooks, skills, and agents that keep Claude Code context across sessions via YAML handoffs, ledgers, and a PostgreSQL memory store.
• Claude Code Hooks Mastery: Reference project implementing all 13 Claude Code hook events as UV Python scripts, plus sub-agents, status lines, and output styles.
• Build with Claude: Plugin marketplace and discovery hub of agents, commands, hooks, and skills for Claude Code users extending their workflows.
• Claude Code Toolkit: Large collection of Claude Code agents, skills, commands, plugins, hooks, rules, and MCP configs, plus links to external tools.