ux-writing

Write clear microcopy for buttons, errors, empty states, and onboarding flows.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/kaitoartz/dotfiles --skill ux-writing-kaitoartz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ux-writing
Source: https://github.com/kaitoartz/dotfiles/tree/main/dot_agents/skills/ux-writing
Command: npx skills add https://github.com/kaitoartz/dotfiles --skill ux-writing-kaitoartz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Interfaces often ship with vague, confusing, or jargon-heavy copy that frustrates users and increases support tickets. This Skill provides structured guidelines for writing microcopy that guides users clearly through digital products. ## Core Features & Use Cases - Button Labels & CTAs: Replace generic labels like "Submit" or "OK" with specific action verbs that match user intent. - Error & Success Messages: Apply the formula of what happened, why, and how to fix it, with concrete before-and-after examples. - Empty States, Loading & Onboarding: Write copy for empty screens, progress indicators, tooltips, and welcome flows with appropriate voice and tone. - Use Case: When designing a checkout flow, use this Skill to rewrite the payment error message from "Transaction failed" to "Your card was declined. Check the card number or try a different payment method." ## Quick Start Use the ux-writing skill to rewrite the error messages and button labels in my signup form.

Frequently Asked Questions about ux-writing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write better button labels for my app?▼

Use specific action verbs that match user intent, such as "Save," "Send," or "Add to Cart" instead of generic labels like "Submit" or "OK." Front-load the action and avoid vague phrases like "Click here" or negative framing like "Don't cancel."

What makes a good error message in UX writing?▼

A good error message follows the formula: what happened, why, and how to fix it. Be specific about the problem, avoid blaming the user, suggest a concrete solution, and use plain language instead of error codes like "Error 404."

How do I write empty state copy for a dashboard?▼

Empty state copy should include three elements: what the space is for, why it is empty, and how to fill it. For example, "Your projects will appear here. Create your first project to get started" covers all three.

When should loading text be shown versus just a spinner?▼

For waits under 2 seconds, show only a spinner with no text. For 2-10 second waits, add short text like "Saving changes..." For waits over 10 seconds, explain the process and expected duration, and show progress percentage when possible.

What are the limitations of tooltips for important information?▼

Tooltips should never contain critical information because they are hidden by default and hard to discover on touch devices. Keep them under 150 characters, cover one concept each, and use them only for supplementary hints or keyboard shortcuts.