clarify

Installation
Summary

Identify and improve unclear interface text to make products easier to understand and use.

  • Assesses copy across error messages, form labels, buttons, help text, empty states, success messages, and confirmation dialogs to find jargon, ambiguity, passive voice, and missing context
  • Requires frontend-design skill context and audience analysis before proceeding; gathers technical level and user mental state to inform improvements
  • Applies core principles: be specific, concise, active, human, and helpful; prioritizes actionable guidance over vague explanations
  • Verifies improvements against comprehension, actionability, brevity, consistency, and tone fit for the situation
SKILL.md

Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.

MANDATORY PREPARATION

Invoke /impeccable — it contains design principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no design context exists yet, you MUST run /impeccable teach first. Additionally gather: audience technical level and users' mental state in context.


Assess Current Copy

Identify what makes the text unclear or ineffective:

  1. 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
Related skills

More from pbakaus/impeccable

Installs
81.6K
GitHub Stars
27.1K
First Seen
Mar 4, 2026