prompt-improver

Transform vague prompts into actionable requests through structured research and clarifying questions.

322|45|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/Microck/ordinary-claude-skills --skill prompt-improver
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prompt-improver
Source: https://github.com/Microck/ordinary-claude-skills/tree/main/skills_all/prompt-improver
Command: npx skills add https://github.com/Microck/ordinary-claude-skills --skill prompt-improver

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill transforms vague prompts into actionable requests via structured research and targeted questions.

Core Features & Use Cases

  • Phase-based workflow: research, questions, clarification, execution
  • Generates focused questions grounded in project context

Quick Start

Provide a vague prompt and let the prompt-improver generate clarifying questions.

Frequently Asked Questions about prompt-improver

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

FAQPage Schema
How do I turn a vague prompt into a clear, actionable request?

Transform vague prompts into actionable requests by applying structured research, generating targeted clarifying questions, and gathering context. This four-phase workflow—research, questions, clarification, execution—grounds your request in specifics before implementation, ensuring you have all details needed to solve the problem effectively.

What's the best way to improve a prompt that lacks context or goals?

Prompt improvement starts with research into your project context, then generates focused questions to identify missing specifics and goals. Once clarified, you execute with full context. This approach works across software development, AI problem-solving, and product design to eliminate ambiguity before you begin work.

When should I use structured clarification questions before starting a task?

Use clarification questions when your initial prompt is vague, missing specifics, or unclear about goals. Structured research and targeted questions reveal gaps in context early, preventing wasted effort on misaligned solutions. This is especially valuable in software development and design workflows where assumptions lead to rework.

Can I apply this prompt refinement process to AI problem-solving workflows?

Yes. The four-phase workflow—research, targeted questions, clarification, execution—applies across AI problem-solving, software development, and product design. Ground your research in project context, craft precise questions, and gather clarification before moving to execution for execution-ready prompts in any domain.

How does research grounding improve the quality of my clarifying questions?

Research grounding anchors clarifying questions in your actual project context rather than generic assumptions. By understanding your environment, constraints, and goals first, you generate focused questions that surface the specific missing details blocking progress, making your prompt executable rather than theoretical.