prompt-improver

Translate vague prompts into actionable research plans and clarifying questions.

1.8k|148|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/severity1/claude-code-prompt-improver --skill prompt-improver-severity1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-improver
Source: https://github.com/severity1/claude-code-prompt-improver/tree/main/skills/prompt-improver
Command: npx skills add https://github.com/severity1/claude-code-prompt-improver --skill prompt-improver-severity1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill translates vague prompts into actionable research plans and clarifying questions.

Core Features & Use Cases

  • Grounded research planning: generates a structured research plan before formulating clarifying questions.
  • Targeted questioning: creates 1-6 research-grounded questions to resolve ambiguity.
  • Guided execution: leverages user input and findings to drive precise, actionable outcomes.

Quick Start

Provide a research plan and 1-6 grounded questions to clarify a vague prompt.

Frequently Asked Questions about prompt-improver

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I clarify a vague prompt before executing codebase changes?

To clarify a vague prompt, generate a structured research plan and 1-6 targeted questions grounded in your codebase. This resolves ambiguity around file targets, scope, and approach before execution begins.

What is the best way to turn an ambiguous development request into an actionable plan?

The best way to turn an ambiguous request into an actionable plan is by translating the vague prompt into a research-backed workflow. This generates specific clarifying questions to resolve missing scope and approach details.

How many clarifying questions should I expect when resolving prompt ambiguity?

You should expect 1-6 clarifying questions when resolving prompt ambiguity. These questions are generated based on a structured research plan grounded in your codebase to target missing specificity.

Do I need to provide codebase context for prompt clarification to work?

Yes, you need to provide codebase context for prompt clarification to work effectively. The skill requires grounding in the codebase to formulate research plans and relevant questions that address specific file targets.

What happens after I answer the clarifying questions for my vague prompt?

After you answer the clarifying questions, the skill executes with your user-provided guidance. It leverages your input and research findings to drive precise, actionable outcomes for your original request.