prompt-improver
This skill enriches vague prompts with targeted research and clarification before execution. Should be used when a prompt is determined to be vague and requires systematic research, question generation, and execution guidance.
npx skills add majiayu000/claude-skill-registry --skill prompt-improver --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Prompt Improver Skill ## Purpose Transform vague, ambiguous prompts into actionable, well-defined requests through systematic research and targeted clarification. This skill is invoked when the hook has already determined a prompt needs enrichment. ## When This Skill is Invoked **Automatic invocation:** - UserPromptSubmit hook evaluates prompt - Hook determines prompt is vague (missing specifics, context, or clear target) - Hook invokes this skill to guide research and questioning **Manual invocation:** - To enrich a vague prompt with research-based questions - When building or testing prompt evaluation systems - When prompt lacks sufficient context even with conversation history **Assumptions:** - Prompt has already been identified as vague - Evaluation phase is complete (done by hook) - Proceed directly to research and clarification ## Core Workflow This skill follows a 4-phase approach to prompt enrichment: ### Phase 1: Research Create a dynamic research plan using TodoWrite before asking questions. **Research Plan Template:** 1. **Check conversation history first** - Avoid redundant exploration if context already exists 1. **Review codebase** if needed: - Task/Explore for arc
- Purpose
- When This Skill is Invoked
- Core Workflow
- Phase 1: Research
- Phase 2: Generate Targeted Questions
- Phase 3: Get Clarification
- Phase 4: Execute with Context
- Examples
- Example 1: Skill Invocation → Research → Questions → Execution
- Example 2: Clear Prompt (Skill Not Invoked)
- Key Principles
- Progressive Disclosure
What does the prompt-improver skill do?
This skill enriches vague prompts with targeted research and clarification before execution. Should be used when a prompt is determined to be vague and requires systematic research, question generation, and execution guidance.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill prompt-improver --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.