mcpField
U
ux-writing-skill

ux-writing-skill

github.com/podoDesign & UI29224 installsUpdated 2d ago
Repository

About ux-writing-skill

ux-writing-skill helps teams and agents create clear, concise interface copy using consistent UX writing standards. It covers common UI patterns, from buttons and errors to onboarding and accessibility wording.

Key features

  1. 01Purposeful, concise, conversational copy
  2. 02Button and CTA guidance
  3. 03Error-message patterns
  4. 04Empty-state and form copy
  5. 05Notification and onboarding copy
  6. 06Accessibility wording guidance

Use cases

  1. 01Write clear error messages
  2. 02Draft button labels and CTAs
  3. 03Improve onboarding and empty-state text
  4. 04Create screen-reader-friendly interface copy

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/podo/design-agent-skills --skill ux-writing-skill

After installing, type/ux-writing-skillin Claude Code to confirm it loaded.

Bundled filesstub.yaml

Details

From the project README

ux-writing-skill

Catalogue stub — full skill: content-designer/ux-writing-skill

Decision tree

  1. Is the full skill already installed? Upstream names this skill ux-writing, so it installs next to this pointer (the pointer is not replaced).

    • Global: f=~/.agents/skills/ux-writing/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
    • Project: f=.agents/skills/ux-writing/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
    • installed → the skill is installed as ux-writing, invoke it and proceed
    • pointer → go to step 2

  2. Detect scope, then install:

    [ -e ~/.agents/skills/ux-writing-skill ] && echo "global" || echo "project"

    Global:

    npx skills add content-designer/ux-writing-skill --skill ux-writing -g -y

    Project:

    npx skills add content-designer/ux-writing-skill --skill ux-writing -y

    Claude Code: send a command as a chat message starting with ! to run it without leaving the conversation.

Heads-up

  • License: MIT
  • Download size: ~21 MB.
  • Name collision: ux-writing is also written by designer-skills (its install or its catalogue pointer); installing both overwrites the earlier one.

Invoke after install

  • Skill name: ux-writing
  • Triggers: "UX writing", "microcopy", "error message copy", "empty state copy", "button label", "UI copy"

What it does

Applies systematic UX writing standards to every piece of interface copy. Four quality dimensions: Purposeful (serves user goals), Concise (fewest words that keep the meaning; about 8–14 words per sentence, 2–4 words for buttons), Conversational (active voice, second person), Clear (no jargon). Covers the most common UI copy patterns:

  • Buttons & CTAs — action-verb labels, primary/secondary/destructive framing
  • Error messages — what happened, why, how to fix (never blame the user)
  • Empty states — purpose, value prop, call to action
  • Form labels & placeholders — distinction between label, hint, placeholder, validation
  • Notifications & toasts — urgency calibration, dismissal copy
  • Onboarding — progressive disclosure, setup copy, success moments
  • Accessibility — screen reader-first phrasing, aria-label guidance, cognitive load

When NOT to use

  • Long-form product marketing copy — use copywriting-skill
  • Removing AI writing patterns from existing text — use humanize-text
  • Full content strategy / information architecture — use design-with-claude (content-strategist)

Comments

Markdown supported