Version 1.5.0 - 2026-01
Version 1.5.0 - 2026-01
Added
- OpenAI Codex Support: Full compatibility with Codex CLI and IDE extensions
- Codex Installation Guide: Step-by-step instructions for Codex users
- Codex Figma Integration: New guide at
docs/codex-figma-integration.md - Multi-Platform Documentation: Updated README and website for Claude + Codex
Changed
- Renamed
docs/figma-integration.mdtodocs/claude-figma-integration.mdfor clarity - Updated website to reflect multi-platform support
- Various terminology fixes (Codex = CLI/IDE, not ChatGPT)
Version 1.4.0 - 2025-12-24
Version 1.4.0 - 2025-12-24
Added
- Smithery Registry: Listed in Smithery skills registry for discoverability
- Smithery Badge: Added badge to README for easy installation
Version 1.3.0 - 2025-11-11
Version 1.3.0 - 2025-11-11
Added
- GitHub Pages Website: Interactive landing page at content-designer.github.io/ux-writing-skill
- Video Demonstration: Embedded demo showing skill in action
- Auto-Rebuild Workflow: GitHub Action to automatically rebuild skill ZIP on changes
Changed
- Reorganized skill packaging for cleaner distribution
- Improved download links and installation flow
- Enhanced modal windows with drag and resize functionality
Version 1.2.0 - 2025-11-10
Version 1.2.0 - 2025-11-10
Added
- Figma Integration Guide: New guide at
docs/figma-integration.mdfor reviewing UX copy directly from Figma designs - Improved Installation Instructions: Clearer steps for non-technical users
Version 1.1.0 - 2025-11-10
Version 1.1.0 - 2025-11-10
Added
- Accessibility Guidelines: Comprehensive accessibility section in SKILL.md covering:
- Screen reader optimization (ARIA labels, descriptive links, accessible buttons)
- Cognitive accessibility (sentence length targets, plain language)
- Multi-modal communication (not relying on color alone)
- Accessible pattern examples with do/don’t comparisons
- New Reference: accessibility-guidelines.md with deep-dive coverage of:
- WCAG principles for UX writers (Perceivable, Operable, Understandable, Robust)
- Screen reader best practices with detailed examples
- Cognitive accessibility research (8 words = 100% comprehension)
- Plain language guidelines by audience type
- Writing for translation and localization
- High-stress context considerations
- Testing methods and tools
- Quick reference accessibility checklist
- UX Text Benchmarks: Research-backed metrics section including:
- Sentence length targets by content type (buttons, titles, errors, instructions)
- Comprehension rates (8 words = 100%, 14 words = 90%)
- Character and line length optimal ranges
- Reading level guidelines by audience (general, professional, technical)
- Testing tools recommendations (Hemingway, Readable.com, MS Word)
- Expanded Error Patterns: Detailed error message types with timing and location:
- Validation errors (inline) with examples and patterns
- System errors (modal/banner) with recovery flows
- Blocking errors (full-screen) with resolution paths
- Permission errors with benefit-first framing
- Comprehensive “what to avoid” guidance
- Tone Adaptation Framework: Structured approach to tone variation:
- Tone variables (purpose, context, emotional state, stakes)
- Tone adaptation by user emotional state (frustrated, confused, confident, cautious, successful)
- Tone adaptation by content type (errors, success, instructions, onboarding, confirmations, empty states)
- Concrete examples for each tone context
Improved
- Enhanced skill description to include accessibility, benchmarks, and expanded frameworks
- Updated Common Mistakes section to include accessibility anti-patterns
- Expanded Resources section to reference new accessibility guidelines
Context
This update addresses key gaps identified through research of public content design systems (Intuit, IBM Carbon, Material Design, Shopify Polaris, Atlassian) and incorporates industry-standard accessibility practices, quantifiable metrics, and expanded frameworks while maintaining copyright compliance through original synthesis and examples.Version 1.0.0 - 2025-11-10
Version 1.0.0 - 2025-11-10
Added
- Initial release of UX Writing Skill
- Core SKILL.md with four quality standards framework
- Reference materials:
- Voice chart template for establishing brand personality
- Content usability checklist for evaluating text quality
- Detailed pattern examples across three different product voices
- Examples directory with real-world improvements:
- Before/after transformations with scoring analysis
- Common improvement patterns and anti-patterns
- Quick self-audit questions
- Templates directory with fillable guides:
- Error message template with multiple formats
- Empty state template for different scenarios
- Onboarding flow template with step-by-step guidance
- MIT License for open source distribution
- Comprehensive README.md positioning the skill strategically
Features
- Model-invoked activation for automatic skill usage
- Progressive disclosure of reference materials
- Scoring framework for objective content evaluation
- Voice and tone adaptation guidance
- Multi-file structure for efficient context loading
Future considerations
Potential additions for future versions:Reference materials
- Voice assistant and conversational UI patterns
- Mobile vs. desktop copy considerations
- Industry-specific pattern libraries (fintech, healthcare, e-commerce)
Templates
- Product announcement templates
- Feature release copy templates
- Marketing vs. product copy guidelines
- Email notification templates
Examples
- More industry-specific examples (fintech, healthcare, e-commerce)
- Complex flow examples (multi-step forms, checkout processes)
- Voice variation examples (formal, casual, technical)
- Accessibility improvements
Tools
- Content audit worksheet
- Voice and tone decision tree
- Readability scoring guide
- Translation preparation checklist
Version numbers follow semantic versioning:
- Major version (X.0.0): Breaking changes to skill structure or API
- Minor version (0.X.0): New features, templates, or reference materials
- Patch version (0.0.X): Bug fixes, typo corrections, small improvements