prompt-improver — Claude Code skill: install and use
This skill reviews prompts, spots missing context and turns vague requests into clearer instructions. Use it when an agent task lacks scope or checks.
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a claude-codeWhat prompt-improver does
prompt-improver examines a request for verifiability, scope, context, constraints, expected output and response format. It flags vague wording, missing tests or check commands, excessive background and unclear deliverables. The result includes a revised prompt, concrete improvement points and questions for details the request does not provide.
The skill also classifies the task by type and complexity. For an ambiguous or multi-file task, the revised wording asks the agent to explore the codebase and plan before implementation. Claude Code and Codex get extra guidance from references/claude.md and references/codex.md. This matters when a task has uncertain impact: the prompt should require exploration before changes. The skill is listed for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.
What it helps with
- review a prompt for missing requirements
- turn vague requests into testable tasks
- define a clear implementation scope
- add files and commands to an agent request
- prepare questions about missing context
Example prompts for the agent
- Improve this prompt for fixing a bug in
src/auth/and add ways to verify the change. - Review my refactoring request and rewrite it with an exploration phase first.
- Rewrite this request for updating
README.mdso the result has clear checks.
How to install prompt-improver
1Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a claude-code2Manually: put the files in place
~/.claude/skills/prompt-improver/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/prompt-improver/
1Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a codex2Manually: put the files in place
.agents/skills/prompt-improver/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a cursor2Manually: put the files in place
.cursor/skills/prompt-improver/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dotneet/claude-code-marketplace prompt-improver2Manually: put the files in place
.github/skills/prompt-improver/SKILL.md1Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a gemini-cli2Platform CLI
gemini skills install https://github.com/dotneet/claude-code-marketplace --path prompt/skills/prompt-improverManually: put the files in place
.devin/skills/prompt-improver/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about prompt-improver
How do I install prompt-improver in Claude Code?
Run npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a claude-code, then check ~/.claude/skills/prompt-improver/SKILL.md.
What does prompt-improver do?
It reviews a prompt for missing context, weak scope and absent verification steps, then produces a clearer draft with targeted questions.
Which platforms does prompt-improver support?
The skill is listed for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode.
