How do I install the UX Writing skill?

Run npx skillmds@latest add zereight/ux-writing in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is UX Writing safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with UX Writing?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is UX Writing free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published UX Writing?

zereight (@zereight) published this skill. Their other Agent Skills are listed on their SkillMD profile.

UX Writing by zereight — Agent Skill

Name: UX Writing
Author: zereight

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.

zereight 97cd59e 2.4 KB Updated Sep 17, 2026

File contents

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).

Kit location

This skill is part of ux-ui-agent-skills v2.4.0.

Resolve every relative path in the steps above against:

.agents/ux-ui-agent-skills/

(from repo root: /Users/tao.exe/Documents/skill/.agents/ux-ui-agent-skills)

Load .agents/ux-ui-agent-skills/CLAUDE.md when you need the full agent persona or Request Router.

---name: ux-writingdescription: 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.---# Skill: UX WritingProduce or critique interface copy in the project's voice.## Steps1. Read `content/voice-tone.md` (voice principles, tone spectrum, formulas, microcopy patterns, inclusive language, pre-ship checklist).2. Match tone to the user's emotional state (onboarding/success/routine/error/destructive). Higher stress → plainer language.3. 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.4. Enforce mechanics: sentence case, no ALL CAPS, numerals, no blame on the user, labels (not placeholders), no directional/color-only instructions.5. Run the 10-item pre-ship copy checklist.## OutputFinal 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`).---## Kit locationThis skill is part of **ux-ui-agent-skills v2.4.0**.Resolve every relative path in the steps above against:`.agents/ux-ui-agent-skills/`(from repo root: `/Users/tao.exe/Documents/skill/.agents/ux-ui-agent-skills`)Load `.agents/ux-ui-agent-skills/CLAUDE.md` when you need the full agent persona or Request Router.

Frequently asked questions