# prompt-improver

This skill reviews prompts, spots missing context and turns vague requests into clearer instructions. Use it when an agent task lacks scope or checks.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 508 installs · ★ 3
- Author: dotneet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dotneet/claude-code-marketplace/tree/HEAD/prompt/skills/prompt-improver/SKILL.md
- Updated: 2026-01-23
- HTML: https://affpapa.org/en/nevibecode/skills/prompt-improver

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/prompt-improver/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/prompt-improver/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/prompt-improver/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/prompt-improver/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dotneet/claude-code-marketplace prompt-improver
```

2. **Manually: put the files in place**
- File: `.github/skills/prompt-improver/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dotneet/claude-code-marketplace --path prompt/skills/prompt-improver
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/prompt-improver/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add dotneet/claude-code-marketplace --skill prompt-improver -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dotneet/claude-code-marketplace/tree/HEAD/prompt/skills/prompt-improver/SKILL.md

## When to use it
- 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
- 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.md` so the result has clear checks.

## Similar
- [skill-improver](https://affpapa.org/en/nevibecode/skills/skill-improver.md) — skill · 5000 installs
- [pr-improver](https://affpapa.org/en/nevibecode/skills/pr-improver.md) — skill · 995 installs
- [claude-md-improver](https://affpapa.org/en/nevibecode/skills/claude-md-improver.md) — skill · 12558 installs
- [gpt-5-4-prompting](https://affpapa.org/en/nevibecode/skills/gpt-5-4-prompting.md) — skill · 728 installs
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — MCP server · ★ 319
- [h3-prompt-writing](https://affpapa.org/en/nevibecode/skills/h3-prompt-writing.md) — skill · 11600 installs

From the same set: [dotneet/claude-code-marketplace](https://affpapa.org/en/nevibecode/by/dotneet/claude-code-marketplace.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md