ux-writing-content-design
Skill4 starsChanged 4 months agoApache-2.0View on GitHub
Write interface copy that clarifies, guides, and converts. Covers microcopy, tone of voice, error messages, form labels, empty states, onboarding copy, and content design principles. Use when writing or reviewing any text that appears in an interface. Triggers on: "UX writing", "microcopy", "error message", "tone of voice", "content design", "interface copy", "UX copy", "button label", "form label".
1 other project uses a version of this.
Adopted by
Most recently taken up by
- hueyexe/frontend-agent-skillstheir own version, first seen Aug 2, 2026
Other versions1 project uses a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 1
- hueyexe/frontend-agent-skills★ 6same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository80 other files it gives its agents.
- a11y-accessibility-designSkill
- agentic-ui-patternsSkill
- ai-native-ui-designSkill
- ai-ui-anti-patternsSkill
- ai-ui-heuristicsSkill
- calm-technology-uiSkill
- conversion-growth-designSkill
- cross-platform-designSkill
- dark-mode-designSkill
- data-visualizationSkill
- design-systemsSkill
- design-thinking-processSkill
- error-empty-statesSkill
- ethical-design-patternsSkill
- form-uxSkill
- information-architectureSkill
- interaction-design-patternsSkill
- internationalization-uiSkill
- mobile-touch-designSkill
- modal-classes-lifecycleSkill
- modal-container-imagesSkill
- modal-dicts-queuesSkill
- modal-endpointsSkill
- modal-fundamentalsSkill
- modal-gpu-computeSkill
- modal-networkingSkill
- modal-observabilitySkill
- modal-parallel-executionSkill
- modal-sandboxesSkill
- modal-scaling-performanceSkill
- modal-schedulingSkill
- modal-secretsSkill
- modal-serversSkill
- modal-storageSkill
- modal-web-servingSkill
- modal-workspace-adminSkill
- motion-design-principlesSkill
- notifications-permissionsSkill
- onboarding-uxSkill
- rust-api-designSkill
- rust-async-programmingSkill
- rust-cargo-masterySkill
- rust-cli-applicationsSkill
- rust-clippy-lintsSkill
- rust-closures-iteratorsSkill
- rust-compiler-internalsSkill
- rust-concurrencySkill
- rust-design-patternsSkill
- rust-editionsSkill
- rust-embeddedSkill
- rust-error-handlingSkill
- rust-game-developmentSkill
- rust-lifetimes-borrowingSkill
- rust-macrosSkill
- rust-performanceSkill
- rust-rustdocSkill
- rust-rustup-toolchainSkill
- rust-smart-pointersSkill
- rust-testing-benchmarkingSkill
- rust-type-systemSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈4
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Every word in an interface is a design decision.
- Distinctive: line 31
Remove words that don't change the meaning.
- Distinctive: line 40
Write like a helpful human, not a system.
- Distinctive: line 93
Every error message needs all three:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
UX Writing & Content Design
Every word in an interface is a design decision. UX writing is not copywriting — it's about clarity over cleverness, action over description.
"The words in an interface are not decoration. They are functional. They clarify, they guide, they reduce friction." — Torrey Podmajersky
Core Principles
1. Clear, Not Clever
Users don't read interfaces — they scan. Every word must earn its place.
| Instead of... | Use... | Why |
| "Utilize" | "Use" | Shorter, more common |
| "In order to" | "To" | Remove filler words |
| "Please be advised that" | (delete) | Adds nothing |
| "We are unable to process your request at this time" | "Something went wrong. Try again." | Plain language |
2. Concise
Remove words that don't change the meaning.
| Instead of... | Use... |
| "Click the button below in order to proceed with the registration process" | "Register" |
| "Would you like to save your changes before exiting?" | "Save changes before leaving?" |
| "Your password must contain at least 8 characters" | "Password: 8+ characters" |
3. Conversational
Write like a helpful human, not a system.
| Instead of... | Use... |
| "Invalid credentials" | "Wrong email or password" |
| "Operation completed successfully" | "Done" |
| "Error 402: PaymentException" | "Payment failed. Try a different card." |
4. Action-Oriented
Lead with the verb. Tell users what to do.
| Instead of... | Use... |
| "Subscription management" | "Manage subscription" |
| "Your account settings" | "Update account" |
| "More information" | "Learn more" |
5. User-Centric
Frame from the user's perspective, not the company's.
| Instead of... | Use... |
| "We need your email" | "What's your email?" |
| "We have updated our terms" | "Our terms changed. Here's what matters." |
| "Company policy requires verification" | "Verify your account to continue" |
Tone of Voice
Define Your Voice Dimensions
Pick a position on each axis:
| Dimension | This end | ... | ... | That end |
| Serious ↔ Playful | Formal, reserved | → | → | Casual, fun |
| Enthusiastic ↔ Matter-of-fact | Excited, energetic | → | → | Neutral, calm |
| Respectful ↔ Irreverent | Polite, deferential | → | → | Bold, cheeky |
Example: A fintech app might be matter-of-fact + respectful ("Your transfer was sent"). A social app might be playful + enthusiastic ("You're all set! 🎉").
Tone Adjusts by Context
The same voice speaks differently in different situations:
| Context | Tone | Example |
| Onboarding | Welcoming, encouraging | "Let's get you set up" |
| Success | Positive, brief | "Done" / "Saved" |
| Error | Helpful, blame-free | "Something went wrong on our end" |
| Confirmation | Clear, serious | "This will delete all your data. This cannot be undone." |
| Empty state | Guiding, motivating | "No projects yet. Create your first one." |
Error Messages
The 3-Part Structure
Every error message needs all three:
- What happened — plain language
- Why it happened — be specific
- How to fix it — actionable next step
| Bad | Good |
| "Error 404" | "We can't find that page. Try searching or go home." |
| "Payment failed" | "Your card was declined. Try a different card or contact your bank." |
| "Invalid input" | "Email is required. Enter the email you signed up with." |
Error Message Rules
- Never blame the user — "Something went wrong on our end" not "You did something wrong"
- Avoid "invalid" — it means nothing. Be specific about what's wrong.
- Avoid "please" in errors — it softens urgency. "Please try again" → "Try again"
- One error, one action — give exactly one clear next step
Button Labels
Rules
- Start with a verb — "Save", "Continue", "Delete", "Send"
- Be specific — "Send message" not "Submit"
- No "OK" — "OK" is lazy. Use the action name: "Got it", "Dismiss", "Save"
- Pair clearly — "Cancel" / "Delete" (not "Cancel" / "OK" for destructive actions)
Destructive Action Patterns
| Primary Action | Secondary Action |
| Delete account | Keep account |
| Discard changes | Keep editing |
| Leave group | Stay |
Form Labels & Instructions
Labels
- Above the input — fastest scanning (vs. left-aligned or placeholder)
- Sentence case — "Email address" not "Email Address"
- Required field indicator — mark required, not optional. Asterisk (*) is standard.
Placeholder Text
- Never use as a label — it disappears when typed
- Use as an example — placeholder="you@company.com"
- Keep it short — 2-3 words max
Helper Text
- Below the input — "Must be at least 8 characters"
- Only when needed — don't state the obvious
Reference Map
references/error-message-patterns.md— what/why/next templates and field vs page errorsreferences/voice-tone-checklist.md— voice axes, tone-by-context, clarity edit pass
Related Skills
- For error state patterns → use
interaction-design-patterns - For empty state patterns → use
interaction-design-patterns - For onboarding patterns → use
onboarding-ux - For accessibility and plain language → use
a11y-accessibility-design
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

