Skip to main content
The skill activates automatically when you write or edit interface copy. You don’t need to explicitly call it.

​
How it works

This skill uses model-invoked activation—Claude and Codex automatically decide when to use it based on your request. The AI loads reference materials progressively, using only what’s needed for your specific task.
In Codex CLI/IDE, you can also explicitly invoke the skill using $ux-writing or through the /skills command.

​
Basic usage

The skill activates when you:
  • Write or edit interface copy
  • Create error messages, notifications, or empty states
  • Work on button labels, form fields, or instructions
  • Review product content for consistency
  • Establish voice and tone guidelines

​
Usage examples

​
Write an error message

Ask Claude or Codex to create user-friendly error messages:
Result: Claude applies the skill automatically and generates clear, actionable error messages following best practices:
  • Explains what happened
  • Provides context about why it failed
  • Offers a clear recovery path
  • Uses empathetic, non-blaming language
Example output:
The skill applies the error message pattern: [What failed]. [Why/context]. [What to do].

​
Edit existing copy

Review and improve interface copy against the four quality standards:
Result: Claude evaluates the copy against the four quality standards (Purposeful, Concise, Conversational, Clear) and suggests improvements. Example analysis:
  • Purposeful: ✓ Describes action
  • Concise: ✗ Too wordy (6 words)
  • Conversational: ✗ Corporate, formal tone
  • Clear: ✓ Meaning is clear
Suggested improvement: “Submit information” or “Continue”

​
Create empty state copy

Generate helpful empty states that guide users:
Result: Claude applies the appropriate empty state pattern and maintains voice consistency. Example output:
Includes:
  • Explanation of why it’s empty
  • Clear call-to-action
  • Encouraging tone

​
Evaluate content quality

Score existing interface copy using the content usability framework:
Result: Claude uses the content usability checklist to provide detailed scoring and improvement suggestions. Example scoring:
  • Purposeful: 2/5 — Doesn’t explain what failed or why
  • Concise: 5/5 — Brief and direct
  • Conversational: 3/5 — Sounds robotic
  • Clear: 2/5 — Vague, no recovery path
Overall score: 12/20 Improvements suggested:
  • Specify what failed
  • Explain why it happened
  • Provide actionable recovery step
  • Use more empathetic tone

​
Write consistent button labels

Create action-oriented button labels:
Result: Claude applies the button pattern [Verb] [object] with active imperative verbs. Example output:
  • “Save changes”
  • “Delete account”
  • “View details”
Follows best practices:
  • Sentence case
  • Active imperative verbs
  • Specific, not generic
  • 2-4 words each

​
Create notification copy

Write timely, valuable notification messages:
Result: Claude applies notification patterns with verb-first title and contextual description. Example output:
Follows notification best practices:
  • Verb-first title
  • Clear action required
  • Brief explanation
  • Actionable CTA

​
Understanding the four quality standards

The skill evaluates all UX text against these standards:
Helps users or the business achieve goals.
  • Does the text help users complete their task?
  • Is the value to the user clear?
  • Are concerns anticipated and addressed?
Uses the fewest words possible without losing meaning.
  • Every word must have a job
  • Remove unnecessary qualifiers
  • Front-load important information
  • Target: 40-60 characters per line maximum
Sounds natural and human, not robotic.
  • Write how you speak
  • Use active voice 85% of the time
  • Include natural connecting words
  • Avoid corporate jargon
Unambiguous, accurate, and easy to understand.
  • Use plain language (7th grade reading level for general audience)
  • Choose specific, meaningful verbs
  • Use consistent terminology
  • Avoid jargon and technical terms

​
Common UX text patterns

The skill includes patterns for:
  • Buttons and links: Active imperative verbs, sentence case
  • Error messages: Empathetic, clear, actionable (validation, system, blocking, permission)
  • Success messages: Past tense, specific, encouraging
  • Empty states: Explanation + CTA to populate
  • Form fields: Clear labels, helpful instructions
  • Notifications: Timely, valuable, verb-first titles
  • Titles: Noun phrases, orient users

​
Tips for best results

1

Provide context

Share relevant information about:
  • User goals and needs
  • Product voice and tone
  • Technical constraints
  • User emotional state
2

Specify the content type

Be clear about what you’re creating:
  • Error message
  • Button label
  • Empty state
  • Notification
  • Form instructions
3

Request specific patterns

Reference UX writing principles:
  • “Keep it conversational”
  • “Make it actionable”
  • “Apply the four quality standards”
  • “Use empathetic tone for errors”
4

Iterate and refine

Ask Claude to:
  • Score the copy
  • Suggest alternatives
  • Adapt tone for different contexts
  • Make it more concise

​
Next steps

Core principles

Deep dive into the four quality standards and UX writing patterns

Figma integration

Review and improve UX copy directly from Figma designs

Voice and tone

Learn how to adapt content to brand personality and context

Accessibility

Write inclusive UX text for all users