SuperAPI AI Directory

ux-writing-skill

Design & creation

View repository

Updated 10-15 17:07

About this skill

ux-writing-skill

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

Decision tree

  1. Is the full skill already installed?

    • Global: grep -q "^das:" ~/.agents/skills/ux-writing-skill/SKILL.md 2>/dev/null && echo "pointer" || echo "installed"
    • Project: grep -q "^das:" .agents/skills/ux-writing-skill/SKILL.md 2>/dev/null && echo "pointer" || echo "installed"
    • No das: block → full skill installed, invoke and proceed
    • das: block present → 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-skill -g -y

Project:

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

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

Invoke after install

  • Skill name: ux-writing-skill
  • 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 (8–14 words for labels), 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)