> ## Documentation Index
> Fetch the complete documentation index at: https://content-designer-ux-writing-skill-26.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

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

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

## 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

<Tabs>
  <Tab title="Claude Desktop">
    ## Quick install for Claude Desktop

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

    <Steps>
      <Step title="Download the skill">
        Download [ux-writing-skill.zip](https://github.com/content-designer/ux-writing-skill/raw/main/dist/ux-writing-skill.zip)

        This contains just the skill files and documentation—no repository files.
      </Step>

      <Step title="Open Claude Desktop">
        Launch Claude Desktop on your computer.
      </Step>

      <Step title="Navigate to Skills settings">
        Go to **Settings → Capabilities → Skills**
      </Step>

      <Step title="Upload the skill">
        Click **Upload skill** and select **ux-writing-skill.zip**

        <Warning>
          Upload the ZIP file directly—do not extract it first.
        </Warning>
      </Step>

      <Step title="Start using the skill">
        The skill is now active! Try asking Claude to write an error message or review interface copy.
      </Step>
    </Steps>

    ### 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.
  </Tab>

  <Tab title="Claude Code">
    ## Manual install for Claude Code

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

    <Steps>
      <Step title="Download the skill">
        1. Download [ux-writing-skill.zip](https://github.com/content-designer/ux-writing-skill/raw/main/dist/ux-writing-skill.zip)
        2. Extract the ZIP file:
           * **Mac**: Double-click the ZIP file
           * **Windows**: Right-click → Extract All
      </Step>

      <Step title="Copy to skills folder">
        Copy the extracted folder to your Claude skills directory:

        <CodeGroup>
          ```bash Mac/Linux theme={null}
          ~/.claude/skills/
          ```

          ```bash Windows theme={null}
          %USERPROFILE%\.claude\skills\
          ```
        </CodeGroup>

        <Note>
          Create the directory if it doesn't exist.
        </Note>
      </Step>

      <Step title="Restart Claude Code">
        Quit and reopen Claude Code to activate the skill.
      </Step>
    </Steps>

    ### 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?

    <Steps>
      <Step title="Copy to project folder">
        Copy the `ux-writing` folder to `.claude/skills/` in your project's root directory.
      </Step>

      <Step title="Commit to repository">
        Add and commit the skill folder to your repository.
      </Step>

      <Step title="Team activation">
        When teammates pull the code, they'll automatically get the skill.

        <Note>
          Project skills only work when Claude Code is opened in that project folder.
        </Note>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Codex">
    ## Install for Codex CLI/IDE

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

    <Steps>
      <Step title="Download the skill">
        1. Download [ux-writing-skill.zip](https://github.com/content-designer/ux-writing-skill/raw/main/dist/ux-writing-skill.zip)
        2. Extract the ZIP file
      </Step>

      <Step title="Copy to Codex skills folder">
        Copy the extracted folder to your Codex skills directory:

        <CodeGroup>
          ```bash Mac/Linux theme={null}
          ~/.codex/skills/
          ```

          ```bash Windows theme={null}
          %USERPROFILE%\.codex\skills\
          ```
        </CodeGroup>

        <Note>
          Create the directory if it doesn't exist.
        </Note>
      </Step>

      <Step title="Restart Codex">
        Quit and reopen Codex (or your IDE with Codex extension) to activate the skill.
      </Step>
    </Steps>

    ### 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:

    <Steps>
      <Step title="Launch skill creator">
        In Codex CLI or IDE, type `$skill-creator`
      </Step>

      <Step title="Provide skill path">
        Provide the path to the extracted skill folder
      </Step>

      <Step title="Follow prompts">
        Follow the prompts to complete installation
      </Step>
    </Steps>

    ### Team installation

    Want your whole team to use this skill automatically?

    <Steps>
      <Step title="Copy to project folder">
        Copy the `ux-writing` folder to `.codex/skills/` in your project's root directory.
      </Step>

      <Step title="Commit to repository">
        Add and commit the skill folder to your repository.
      </Step>

      <Step title="Team activation">
        When teammates pull the code, they'll automatically get the skill.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Next steps

<CardGroup cols={2}>
  <Card title="Quick start" icon="rocket" href="/quickstart">
    Learn how to use the skill with practical examples
  </Card>

  <Card title="Figma integration" icon="figma" href="/guides/figma-integration">
    Connect the skill to Figma for design review
  </Card>
</CardGroup>