# UX Writing Systems

> UX writing systems, content guidelines, and text component patterns for consistent product language.

- Skill: `dragoon0x/ux-writing-systems` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dragoon0x/ux-writing-systems`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dragoon0x/ux-writing-systems/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: dragoon0x (https://skillmd.com/u/dragoon0x)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dragoon0x/ux-writing-systems

---


# Ux Writing Systems

## Building a UX Writing System

### Content Components
- **Headings:** H1 = page purpose, H2 = section topics.
- **Body text:** 16px minimum, 45-75 char line length.
- **Labels:** Short, specific, consistent terminology.
- **Descriptions:** Support labels when needed. One sentence.
- **Help text:** Below inputs, before the user needs it.
- **Status text:** Present tense for current state, past tense for completed.

### Terminology Database
- Canonical terms for features (don't call it "workspace" in one place and "project" in another).
- Acronym definitions.
- Prohibited terms (brand-specific no-go words).

### String Templates
- `{User} shared {item} with you.`
- `{Count} items selected.`
- Handle pluralization: 1 item / 2 items.
- Handle zero: "No items" not "0 items."

### Tone Matrix
| Context | Tone |
|---------|------|
| Success | Brief, satisfied |
| Error | Empathetic, helpful |
| Warning | Clear, non-alarming |
| Onboarding | Patient, encouraging |
| Empty state | Friendly, actionable |