ux-writing-skill

This agent skill transforms Claude, Codex, and Cursor into specialized UX writing tools by packaging evidence-based writing expertise into an automated framework. It applies four measurable quality standards—Purposeful, Concise, Conversational, and Clear—across common UX patterns like error messages, buttons, empty states, and notifications. The skill includes accessibility guidelines, voice and tone frameworks, research-backed benchmarks, and before/after examples that help teams enforce consistent content quality without manual review bottlenecks. Content designers use it to apply standards systematically; product teams use it to enable non-writers to create on-brand copy; and design system teams use it to scale content enforcement. Installation takes one CLI command, and the skill activates automatically when you write or edit interface copy.

1. **Identify the UI element**: Specify the component (e.g., button, modal, tooltip) and its context (e.g., login screen, checkout flow). Use tools like Figma or Storybook to reference the design system. 2. **Define constraints**: Provide the design system name (e.g., Material Design, Carbon Design), tone (e.g., conversational, formal), and character limits. Include edge cases (e.g., error states, empty states) to ensure coverage. 3. **Run the prompt**: Paste the template into Claude/ChatGPT and replace [PLACEHOLDERS] with your specifics. For bulk generation, use a CSV/JSON file to list elements and iterate with the AI. 4. **Review and refine**: Cross-check the output against the design system. Adjust for edge cases missed (e.g., accessibility labels for screen readers). Use tools like Storybook’s 'Variants' tab to test consistency. 5. **Automate**: Integrate with tools like GitHub Actions or Figma plugins to auto-generate microcopy when design files are updated. Log discrepancies in a spreadsheet for review.