# Prompt Improver

> Researches conversation and code context to generate 1-6 targeted clarifying questions when a prompt is vague, then executes the original request.

- Skill: `samyakjhaveri/prompt-improver` (Agent Skill)
- Install (CLI): `npx skillmds add samyakjhaveri/prompt-improver`
- Raw SKILL.md: https://api.skillmd.com/api/skills/samyakjhaveri/prompt-improver/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Prompt Engineering
- Tags: Clarifying Questions, Context Research, Prompt Improvement
- Author: SamyakJhaveri (https://skillmd.com/u/samyakjhaveri)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/samyakjhaveri/prompt-improver

---


# Prompt Improver Skill

You are invoked because the UserPromptSubmit hook has determined the user's prompt lacks sufficient clarity to execute well. Your job is to research context first, then ask smart questions — not the other way around.

## Phase 1 — Research (NEVER skip this)

Before generating any questions, gather real context:

1. Check the full conversation history — has this topic come up before? Is there already enough context?
2. If the request involves code: read relevant files, scan the directory structure, understand the stack
3. If the request involves a task: understand what already exists, what's already been tried
4. If you can fully infer the user's intent from context alone — **skip to Phase 4 immediately**

## Phase 2 — Generate Questions (only if genuinely needed)

Create 1–6 questions. Rules:
- Every question must be grounded in what you actually found in Phase 1
- Never ask about something you can already infer
- Each question should be multiple-choice (3–4 options max) — no open-ended text boxes
- Questions must reduce ambiguity, not pad the conversation
- If 1 question resolves the ambiguity, only ask 1

## Phase 3 — Clarification

Use the `AskUserQuestion` tool to present your questions. Each option should:
- Be concrete and specific (not vague like "Option A / Option B")
- Describe the trade-off or implication where relevant
- Include an "Other / I'll describe" option

## Phase 4 — Execute

Proceed with the original request using:
- The user's original intent
- What you learned in Phase 1
- The user's answers from Phase 3 (if any questions were asked)

Do not re-ask anything the user has already answered. Do not summarise what you're about to do — just do it.

## Bypass

If the user prefixes their message with `*`, the hook skips evaluation entirely and passes the prompt straight through. Useful for urgent or already-detailed prompts.