Menu
Microcopy discipline — buttons, errors, empty/loading/success states, alt text. Voice and tone come from the project's memory, not from this skill.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | ux-writing |
| description | Microcopy discipline — buttons, errors, empty/loading/success states, alt text. Voice and tone come from the project's memory, not from this skill. |
The discipline of interface copy. The project's voice (tone, vocabulary, banned words) lives in memory-long §conventions — seeded by /init, refined by the humans. This skill is how to structure copy regardless of voice.
| Surface | Pattern | Never |
|---|---|---|
| Buttons/CTAs | [imperative verb] [+ object if needed] — "Send message" · primary CTAs ≤24 chars (one line at 320px) | "Submit", "Click here", exclamation marks |
| Form errors | [specific cause]. [corrective action]. — "Invalid email. Check the format." | "Error", vague politeness ("Please fill correctly") |
| Empty states | [context of emptiness] [+ next possible action] | Dead ends ("Nothing here") |
| Loading | Say what is happening — "Validating email…" | "Loading…", "Please wait" |
| Success | [concrete confirmation]. [next action or link]. — "Message sent. Reply within 48h." | "Success!" (zero context) |
| Alt text | Decorative → alt="" · Informative → describe what it communicates, not what it is | Inventing text for decorative images |
| ARIA labels | Expand context beyond visible text | Duplicating visible text |
component-patterns).Context engineering — memory navigation, textual graph traversal, progressive disclosure, recovery. Load when assembling context for a task or when lost.
Implementation-side security discipline — headers, dependencies, secrets, authz. Load for hardening work (sec-ops domain).
Commit conventions, branching, anchors in messages, and the git safety rules. Load for any git operation beyond status/diff.
Anti-generic-AI design discipline — bans, tells, and the slop test. Load for ANY new UI surface or visual redesign. Inspired by Impeccable (Apache 2.0).
Motion & animation discipline — purpose, performance, reduced-motion. Load when work involves animation, transitions or scroll effects.
Infrastructure composition patterns — immutable infra, GitOps, golden images, cattle-not-pets, day-2 thinking. Tool-agnostic.