UX Writing Skill for Claude & Codex

Scale content quality through AI-powered design system enforcement

🌐 View Website

An Agent Skill that enables Claude and OpenAI Codex to write and edit user-centered interface copy (UX text/microcopy) for digital products. This skill transforms AI assistants into specialized UX writing tools that apply consistent standards, patterns, and voice across your product.

The Problem

Design systems solve visual consistency, but content quality still depends on individual writers. Every error message, button label, and empty state requires manual review to ensure it's clear, concise, conversational, and purposeful. This doesn't scale.

The Solution

This Agent Skill packages UX writing expertise into a system that Claude can apply automatically. Instead of asking "make this better," you can rely on consistent, evidence-based improvements across your entire product interface.

What Makes This Different

Systems thinking, not style guides: This isn't a list of writing tips. It's a framework for evaluating and improving UX text based on four measurable quality standards.

Progressive disclosure: Reference materials are loaded only when needed, keeping Claude's context efficient while providing deep expertise on demand.

Proven patterns: Built from real-world UX writing best practices, with examples across different product voices and contexts.

Immediately actionable: Every pattern includes concrete before/after examples and scoring against quality standards.

What You Get

Core Framework

• Four quality standards: Purposeful, Concise, Conversational, Clear
• Common UX patterns: Buttons, errors, empty states, forms, notifications, onboarding
• Editing process: Systematic approach to improving any interface text
• Voice and tone guidance: Adapt content to brand personality and context
• Accessibility guidelines: Write for screen readers, cognitive accessibility, and WCAG compliance
• Research-backed benchmarks: Sentence length targets, comprehension rates, reading levels

Reference Materials

• Accessibility guidelines: Comprehensive guide for writing inclusive, accessible UX text
• Voice chart template: Establish consistent brand personality
• Content usability checklist: Evaluate text quality with scoring framework
• Detailed pattern examples: See how different voices apply the same patterns

Practical Tools

• Real-world improvements: Before/after transformations with analysis
• Fillable templates: Error messages, empty states, onboarding flows
• Expanded error patterns: Validation, system, blocking, and permission errors with examples
• Tone adaptation framework: Map emotional states to appropriate tone
• Quick reference: Common patterns and anti-patterns

Use Cases

For content designers: Apply consistent UX writing standards across your product without memorizing every rule.

For product teams: Enable non-writers to create interface copy that follows your design system.

For design system teams: Enforce content guidelines at scale without becoming a bottleneck.

For early-stage products: Build content quality in from the start with proven patterns.

Installation

What You Need

This skill works with Claude Desktop, Claude Code, and Codex (CLI and IDE extensions). Choose the installation method that matches your setup.

Note: This skill works with Codex CLI/IDE, not ChatGPT. ChatGPT cannot install or use skills.

Quick Install (Claude Desktop)

If you're using Claude Desktop, installation is simple:

1. Download ux-writing-skill.zip — this contains just the skill files and documentation
2. Open Claude Desktop
3. Go to Settings → Capabilities → Skills
4. Click Upload skill and select ux-writing-skill.zip
5. Upload the ZIP file directly — do not extract it first
6. Start using the skill immediately!

The ZIP contains only skill-relevant files: SKILL.md plus supporting documentation in docs/, examples/, references/, and templates/.

Manual Install (Claude Code)

If you're using Claude Code, follow these steps:

Step 1: Download the Skill

1. Download ux-writing-skill.zip
2. Extract the ZIP file (double-click on Mac, right-click → Extract on Windows)

Step 2: Copy to Skills Folder

Copy the extracted folder to your Claude skills directory:

• Mac/Linux: ~/.claude/skills/
• Windows: %USERPROFILE%\.claude\skills\

Create the directory if it doesn't exist.

Step 3: Restart Claude Code

...