clarify
Installation
SKILL.md
Adapted from impeccable by Paul Bakaus, used under the Apache License 2.0. Modified for this collection; see NOTICE.md for what changed.
Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.
Assess Current Copy
Identify what makes the text unclear or ineffective:
- Find clarity problems:
- Jargon: Technical terms users won't understand
- Ambiguity: Multiple interpretations possible
- Passive voice: "Your file has been uploaded" vs "We uploaded your file"
- Length: Too wordy or too terse
- Assumptions: Assuming user knowledge they don't have
- Missing context: Users don't know what to do or why
- Tone mismatch: Too formal, too casual, or inappropriate for situation