Agent Skills
› Owl-Listener/designer-skills
› ux-writing
ux-writing
GitHub专注于撰写清晰、友好的界面文案，包括微文案、错误提示、空状态和CTA等。提供各类场景的写作规范、语调指南及最佳实践，确保内容易懂且符合品牌声音，提升用户体验。
Trigger Scenarios
需要撰写界面按钮、表单标签或工具提示等微文案
设计或优化错误消息、空状态或确认信息
制定产品整体的语音语调（Voice and Tone）指南
Install
npx skills add Owl-Listener/designer-skills --skill ux-writing -g -y
SKILL.md
Frontmatter
{
"name": "ux-writing",
"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)."
}
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
Version History
-
20e34c4
Current 2026-08-19 23:21
明确技能边界与触发条件，防止与其他技能冲突；规范描述格式，增加“何时使用”指引及插件间引用逻辑。
- acc3e57 2026-07-25 05:15
