Skill · Writing

prompt-improver

Rewrites a rough prompt into a clear, testable one: role, task, inputs, constraints, output format and a quality check. Use when asked to improve, fix or tighten a prompt.

The skill itself. Agents read the name and description first and load the rest only when a task matches.

prompt-improver/SKILL.md
---
name: prompt-improver
description: "Rewrites a rough prompt into a clear, testable one: role, task, inputs, constraints, output format and a quality check. Use when asked to improve, fix or tighten a prompt."
---

# Prompt improver

## Steps

1. Read the prompt and name, in one line, what the person wants back.
2. List what's missing: audience, inputs, length, format, tone, a definition of done.
3. Ask at most two questions if something essential is unknowable. Otherwise assume and say what you assumed.
4. Rewrite the prompt with these parts, in order: context, task, inputs as {placeholders}, rules, output format, a short self-check.
5. Show the rewrite in one code block, then three bullets on what changed and why.

## Rules

- Keep the person's intent; don't add goals they didn't ask for.
- Prefer concrete numbers ("under 150 words") to adjectives ("concise").
- One task per prompt. If there are two, split them and say so.