Skip to content
cccskills
FreePublished on GitHub

ux-writing

Write clear interface text for buttons, forms, errors, empty screens, and onboarding. This skill helps explain what happened and what to do next, while keeping language consistent with the product’s voice and appropriate to each situation.

OriginalShow the original description

Write interface copy — microcopy, error messages, empty states, and CTAs. Use when the words are the deliverable. For content structure and ownership, use `content-strategy` (ux-strategy).

Run score Not tested

See how to install

Good for

  • Rewrite button and form labels
  • Explain errors and the next action
  • Guide users through empty screens
  • Create onboarding and confirmation text

Files included (1)

  • SKILL.md2.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

UX Writing

You are an expert in writing clear, helpful interface copy that guides users and reinforces the product voice.

What You Do

You write UI copy that helps users accomplish tasks, understand status, and feel confident.

UX Writing Categories

Microcopy

  • Button labels: action-oriented, specific (not just 'Submit')
  • Form labels: clear, concise, no jargon
  • Tooltips: brief explanations for complex features
  • Placeholder text: example format, not instructions

Error Messages

  • Say what happened (clear, not technical)
  • Say why (if helpful and brief)
  • Say what to do next (specific action)
  • Use a human tone (not robotic or blaming)

Empty States

  • Explain what will appear here
  • Guide the user to take action
  • Use an encouraging, helpful tone
  • Provide a clear CTA

Confirmation Messages

  • Confirm what just happened
  • Provide next steps if relevant
  • Include undo option for reversible actions
  • Keep it brief and positive

Onboarding Copy

  • Welcome without overwhelming
  • One concept at a time
  • Action-oriented (do, not just read)
  • Allow skipping

CTAs (Calls to Action)

  • Start with a verb
  • Be specific about the outcome
  • Match user intent (not business intent)
  • Primary CTA should be the most common action

Voice and Tone Guidelines

  • Voice (consistent): brand personality, vocabulary, perspective
  • Tone (varies): adapts to context (celebration vs error vs instruction)

Writing Principles

  • Clear over clever
  • Concise over comprehensive
  • Helpful over promotional
  • Consistent over creative
  • Inclusive over casual

Best Practices

  • Write copy before designing the UI (content-first)
  • Test copy with real users
  • Create a terminology dictionary
  • Avoid jargon, abbreviations, and idioms
  • Consider translation and localization from the start

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

a-b-test-design

FreeSummary

Plan A/B experiments to measure the effect of a design change. Define a hypothesis, control and treatment versions, success metrics, sample size, and duration, with supporting measures to detect unintended consequences.

  • Planning a comparison between current and proposed designs
  • Defining success metrics for a change
  • Estimating sample size and test duration
Owl-Listener/designer-skills3.1KUpdated Sep 6, 2026

Assess an existing interface against WCAG 2.2 accessibility guidelines. Identify barriers in content and interactions, rate their severity and user impact, and document affected locations, remediation steps, and code examples to guide improvements.

  • Reviewing accessibility in an existing design or build
  • Checking keyboard access and assistive technology compatibility
  • Prioritizing fixes by severity and user impact
Owl-Listener/designer-skills3.1KUpdated Sep 6, 2026

Plan accessibility testing with people who use assistive technologies, such as screen readers and voice control. Define participant criteria, test environments, session procedures, coverage of WCAG accessibility guidelines, and a consistent format for reporting issues.

  • Planning test sessions with assistive technology users
  • Defining participant recruitment criteria
  • Mapping key user flows to test environments
Owl-Listener/designer-skills3.1KUpdated Sep 6, 2026

Review visual consistency to understand how an interface shapes trust and perceived ease of use. Examine spacing, alignment, typography, and overlooked screen states to guide visual improvements alongside usability testing.

  • Investigating poor feedback on a functional interface
  • Checking visual consistency before launch
  • Reviewing error, empty, and loading states
Owl-Listener/designer-skills3.1KUpdated Sep 6, 2026

affinity-diagram

FreeSummary

Turn interview notes, observations, and survey responses into themes and actionable research insights. Group related evidence without preset categories, retain participant references, and prioritize findings by their impact on design decisions while noting patterns found in only one interview.

  • Synthesize findings across multiple interviews
  • Organize observation notes and survey responses
  • Prioritize research insights for design decisions
Owl-Listener/designer-skills3.1KUpdated Sep 6, 2026

Refine a specific interface animation by choosing easing, meaning changes in speed, along with duration and movement order. Use it to tune buttons, modals, transitions, or loading indicators so motion guides attention and communicates changes.

  • Tune how a modal enters and exits
  • Adjust button and toggle animations
  • Coordinate the order of related movements
Owl-Listener/designer-skills3.1KUpdated Sep 6, 2026

See all skills by Owl-Listener

Report a problem with this skill