Claude Code Prompt Improver is a Claude Code hook that adds useful context and questions around a submitted prompt, tool call, or subagent start. It is for Claude Code users who want clearer requests, better task planning, and fewer correction rounds.
Borrowing it
Nothing to install: this file belongs to severity1/claude-code-prompt-improver. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/severity1/claude-code-prompt-improver/main/CLAUDE.mdgit clone --depth 1 https://github.com/severity1/claude-code-prompt-improverWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/severity1/claude-code-prompt-improver/claude-md)<a href="https://agentmods.dev/instructions/severity1/claude-code-prompt-improver/claude-md"><img src="https://agentmods.dev/badge/instructions/severity1/claude-code-prompt-improver/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/severity1/claude-code-prompt-improver/claude-md"><img src="https://agentmods.dev/badge/instructions/severity1/claude-code-prompt-improver/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.05548 | $0.05548 |
| Opus 5.5 | $0.02219 | $0.02219 |
| Sonnet 5.5 | $0.01110 | $0.01110 |
| Haiku 4.5 | $0.00555 | $0.00555 |
Grade A, and why
claude-code-prompt-improver CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 251 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Claude Code Prompt Improver
This file provides guidance to Claude Code when working with code in this repository.
Overview
A declarative hook engine driven by a JSON nudge registry. One engine dispatches every hook event; each prompt-improvement capability is a data row in nudges/<EventName>/*.json, not a separate script. Adding an inject-context nudge is a single JSON file with zero Python changes.
Core functionality:
- One engine entry point (
engine.py <EventName>) dispatched per hook event fromhooks.json - Reads stdin once, runs the event's rules, merges
inject_contextfragments by priority, emits one JSON object, exits 0 always improvenudge (always fires on UserPromptSubmit): evaluates clarity; clear prompts proceed, vague prompts invoke the prompt-improver skillapproach-assessmentnudge (UserPromptSubmit, priority 10, keyword match on non-trivial-work verbs, non_slash, ignorecase): injects approach-selection guidance (subagent vs orchestration vs just do it) and reminds that spawned subagents need context passed explicitly; self-cancels false positives with a leading conditionworkflownudge (UserPromptSubmit, priority 20): injects model-routing and plan-mode-first HITL guidance for workflow/deep-research/ultracode requestsplan-modenudge (UserPromptSubmit, priority 50, non_slash, always-evaluate): judges whether task complexity warrants entering plan mode before starting; owns the 'whether to plan at all' decision; approach-assessment owns 'which approach'plannudge (PreToolUse, self-gates on tool_name=EnterPlanMode): injects plan readability guidancesubagent-routingnudge (SubagentStart): injects breadth-over-depth guidance when an Explore or Plan agent spawnsbackground-execnudge (PreToolUse, matches tool_input.command on Bash): encourages background execution and token-efficient polling for long-running/never-exiting commandsoutput-readabilitynudge (UserPromptSubmit, keyword match): self-cancelling reminder to make substantial deliverables (report/review/summary/analysis) human-parsableask-user-questionnudge (UserPromptSubmit, priority 40, keyword match on decision/fork language, non_slash, ignorecase): self-cancelling nudge to route genuine user-owned decisions through AskUserQuestion tool with concrete options; research first when context is thin; pick sensible default for minor/reversible choices- Uses AskUserQuestion tool for targeted clarifying questions (1-6 questions)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago Changed · +1 lines · +95 tokens per session d34b0733d987
- 2mo ago First seen · 250 lines · 5,453 tokens per session scan A 11b17b64ec89
claude-code-prompt-improver CLAUDE.md is an instructions file published in the GitHub repository severity1/claude-code-prompt-improver (1,968 stars, last pushed 1mo ago), licensed MIT. It adds 5,548 tokens to every session, about $0.0222 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
claude-code-prompt-improver CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| claude-code-prompt-improver CLAUDE.mdseverity1/claude-code-prompt-improver | Instructions file | 2.0k | 1mo ago | MIT | A | 5,548 | Claude Code |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | today | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |