AgentSkillsCN

ux-writing

遵循 Material Design 3 的 UX 文本撰写最佳实践，对 UI 文本进行审阅与撰写。适用于编写新的 UI 文本（按钮、标签、对话框、错误信息、通知、标题、菜单、工具提示、空状态、表单字段），或对现有 UI 文本进行审阅与优化，以提升清晰度、一致性和无障碍性。涵盖句首小写、用词选择、语法、标点符号、代词使用、缩略语应用，以及后果传达等要点。任何涉及微文案、界面文案、UI 字符串或 UX 文本的任务均可触发此技能。

SKILL.md
--- frontmatter
name: ux-writing
description: >-
  Review and write UI text following Material Design 3 UX writing best
  practices. Use when writing new UI text (buttons, labels, dialogs, error
  messages, notifications, titles, menus, tooltips, empty states, form fields)
  or reviewing and fixing existing UI text for clarity, consistency, and
  accessibility. Covers sentence case, word choice, grammar, punctuation,
  pronouns, abbreviations, and consequence communication. Triggers on any task
  involving microcopy, interface copy, UI strings, or UX text.

UX Writing

Review and write UI text based on the Material Design 3 style guide.

Workflow

Determine whether the task is a review of existing text or creation of new text, then follow the appropriate workflow.

Review workflow

  1. •Read the target file(s)
  2. •Load references/md3-style-guide.md
  3. •Check all text against the three rule categories:
    • •Best practices (consequences, scannability, sentence case, abbreviations)
    • •Word choice (second person, pronoun consistency, first-person caution)
    • •Grammar and punctuation (periods, contractions, commas, colons, exclamation points, ellipses, parentheses, ampersands, dashes, hyphens, italics, caps)
  4. •Report each finding in this format:
    code
    file:line — "original text" — [Rule N.N name] — Suggested: "improved text"
  5. •Summarize findings grouped by category

Creation workflow

  1. •Identify the UI element type (button, error message, dialog, tooltip, label, heading, empty state, notification, menu item, form field)
  2. •Load references/md3-style-guide.md
  3. •Apply the rules relevant to the element type:
    • •Buttons: Sentence case, skip periods, use contractions, skip ellipses
    • •Error messages: Explain consequences, use second person, skip exclamation points
    • •Dialogs: Explain consequences, skip periods for single sentences, use contractions
    • •Headings/titles: Sentence case, skip colons, use scannable words
    • •Labels/tooltips: Sentence case, skip periods, spell out abbreviations
    • •Empty states: Use second person, skip exclamation points, explain next steps
    • •Notifications: Explain consequences, use second person, use contractions
  4. •Draft the text
  5. •Self-check the draft against all applicable rules
  6. •Present the text with a brief rationale citing the rules applied

Quick reference

Key rules to check first:

RuleSummary
Sentence caseCapitalize only the first word (not Title Case)
Second personUse "you/your", not "the user"
No mixed pronounsDon't combine "my" with "your" in the same context
Skip periodsOmit periods for single-sentence UI text
Use contractions"Don't" instead of "Do not" for natural tone
Serial comma"Folders, files, and images" (Oxford comma)
No caps blocksNever use ALL CAPS — use sentence case
No exclamation pointsReserve for greetings or celebrations only
Explain consequencesState what happens and how to undo

Full style guide

For the complete set of 20 rules with Do/Don't examples, load references/md3-style-guide.md.