Installation

Install the UX Writing Skill for Claude Desktop, Claude Code, and Codex

This skill works with Claude Desktop, Claude Code, and Codex (CLI and IDE extensions). It does not work with ChatGPT.

What you need

Choose the installation method that matches your setup:

• Claude Desktop: Quick upload via Settings
• Claude Code: Manual installation to skills folder
• Codex: Manual installation or built-in skill creator

Claude Desktop

Quick install for Claude Desktop

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

1. Download the skill

   Download ux-writing-skill.zip

   This contains just the skill files and documentation—no repository files.

2. Open Claude Desktop

   Launch Claude Desktop on your computer.

3. Navigate to Skills settings

   Go to Settings → Capabilities → Skills

4. Upload the skill

   Click Upload skill and select ux-writing-skill.zip

   Upload the ZIP file directly—do not extract it first.

5. Start using the skill

   The skill is now active! Try asking Claude to write an error message or review interface copy.

Verify it’s working

Try asking Claude:

Write an error message for when a payment fails

Claude will apply UX writing best practices and create a clear, empathetic error message.

Claude Code

Manual install for Claude Code

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

1. Download the skill

   1. Download ux-writing-skill.zip
   2. Extract the ZIP file:
      • Mac: Double-click the ZIP file
      • Windows: Right-click → Extract All
2. Copy to skills folder

   Copy the extracted folder to your Claude skills directory:

   Mac/Linux

   ~/.claude/skills/
   

   Create the directory if it doesn’t exist.

3. Restart Claude Code

   Quit and reopen Claude Code to activate the skill.

Verify it’s working

Try asking Claude:

Write an error message for when a payment fails

Claude will apply UX writing best practices and create a clear, empathetic error message.

Team installation

Want your whole team to use this skill automatically?

1. Copy to project folder

   Copy the ux-writing folder to .claude/skills/ in your project’s root directory.

2. Commit to repository

   Add and commit the skill folder to your repository.

3. Team activation

   When teammates pull the code, they’ll automatically get the skill.

   Project skills only work when Claude Code is opened in that project folder.

Codex

Install for Codex CLI/IDE

If you’re using Codex CLI or IDE extensions, installation is straightforward:

1. Download the skill

   1. Download ux-writing-skill.zip
   2. Extract the ZIP file
2. Copy to Codex skills folder

   Copy the extracted folder to your Codex skills directory:

   Mac/Linux

   ~/.codex/skills/
   

   Create the directory if it doesn’t exist.

3. Restart Codex

   Quit and reopen Codex (or your IDE with Codex extension) to activate the skill.

Verify it’s working

Try asking in Codex:

Write an error message for when a payment fails

Codex will apply UX writing best practices and create a clear, empathetic error message.

Alternative: Built-in skill creator

You can also use Codex’s built-in skill creator:

1. Launch skill creator

   In Codex CLI or IDE, type $skill-creator

2. Provide skill path

   Provide the path to the extracted skill folder

3. Follow prompts

   Follow the prompts to complete installation

Team installation

Want your whole team to use this skill automatically?

1. Copy to project folder

   Copy the ux-writing folder to .codex/skills/ in your project’s root directory.

2. Commit to repository

   Add and commit the skill folder to your repository.

3. Team activation

   When teammates pull the code, they’ll automatically get the skill.

Next steps

Quick start

Learn how to use the skill with practical examples

Figma integration

Connect the skill to Figma for design review