UX Writing

Write clear, concise interface copy — labels, buttons, errors, empty states, onboarding — that helps users complete tasks with confidence. Use when crafting microcopy, improving clarity of UI text, or establishing voice and tone for product interfaces.

itsual Updated 7 repo stars

File contents

UX Writing

Overview

UX writing is design with words. Every label, error, and empty state either reduces friction or adds it.

When to Use

  • Writing or rewriting UI microcopy
  • Designing empty states, errors, and success messages
  • Creating onboarding or in-product guidance text
  • Establishing product voice and tone guidelines

Core Practices

  • Lead with the user’s goal and next action
  • Use plain language; avoid jargon unless the audience expects it
  • Make buttons describe the action (“Save draft,” not “OK”)
  • Write errors that explain what happened and how to fix it
  • Keep consistency in terminology across the product
  • Design copy for scanning — short lines, front-loaded meaning

Principles

  • Clarity first, brand voice second (they should reinforce, not fight)
  • Be helpful without being verbose
  • Respect the user’s attention and emotional state (especially in errors)
  • Inclusive language is part of quality

Verification

  • A new user can understand key actions without help
  • Error messages enable recovery
  • Terminology is consistent across surfaces

itsual/agent-skills-collection commit 8e309a50c6

Frequently asked questions

npx get-skill add itsual/ux-writing