ux-writing
Write or review UI copy — buttons, errors, empty states, microcopy, notifications, labels — using the voice & tone system (clear, concise, useful, human, honest) with the what→why→how error formula and inclusive-language rules. Use when the user needs interface copy, error messages, empty-state text, or a copy review.
How do I install this agent skill?
npx skills add https://github.com/plugin87/ux-ui-agent-skills --skill ux-writingIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides guidelines for UX writing and interface copy review. It does not contain any code, network requests, or sensitive data access.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Skill: UX Writing
Produce or critique interface copy in the project's voice.
Steps
- Read
content/voice-tone.md(voice principles, tone spectrum, formulas, microcopy patterns, inclusive language, pre-ship checklist). - Match tone to the user's emotional state (onboarding/success/routine/error/destructive). Higher stress → plainer language.
- Apply the formulas:
- Buttons: frontload the verb, name the outcome.
- Confirmation dialogs: the confirm button restates the action and object — "Delete account", not "Delete"/"OK"/"Yes"/"Confirm". The title asks ("Delete account?"), the button answers in matching words. Cancel stays "Cancel". For irreversible/high-stakes actions, require a type-to-confirm step (WCAG 3.3.4/3.3.6).
- Errors: what happened → why → how to fix (no dead ends, no codes/stack traces).
- Empty states: value → first action.
- Enforce mechanics: sentence case, no ALL CAPS, numerals, no blame on the user, labels (not placeholders), no directional/color-only instructions.
- Run the 10-item pre-ship copy checklist.
Output
Final copy (or a redline review) that reads naturally aloud and passes the checklist. Keep within any character limits for tight UI.
Verification (mandatory before declaring done)
Run every line through the 10-item pre-ship checklist in content/voice-tone.md — do not skip it:
- Reads naturally aloud; frontloaded verb on actions; no jargon/blame/dead-ends.
- Errors follow what→why→how; empty states give value→action; no bare "No data"/"Error".
- Mechanics: sentence case, numerals, labels (not placeholders), no color/direction-only cues, inclusive language.
- Within character limits; translatable (no concatenation — see
accessibility/i18n-rtl.md).
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/plugin87/ux-ui-agent-skills/ux-writing">View ux-writing on skillZs</a>