ux-writing

ux-writing is a skill for Claude Code from rshankras/claude-code-apple-skills. It costs 83 tokens per session (1,255 once invoked), scanned A, original, MIT.

Guidance for writing clear text in user interfaces, such as labels, buttons, alerts, errors, and empty states.

In plain words
What is it for?
Use it to write or review interface text, name features and settings, improve error and permission messages, prepare copy for translation, and guide onboarding.
Why use it?
It helps remove confusing, vague, or unhelpful wording that can make people hesitate or get stuck.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the apple-skills plugin — 147 skills shipped together , and of apple-skills

Good fit Use it to write or review interface text, name features and settings, improve error and permission messages, prepare copy for translation, and guide onboarding.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/rshankras/claude-code-apple-skills/ux-writing
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add rshankras/claude-code-apple-skills --skill ux-writing
Clone the repo
git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills

Made for: Claude Code.

Or install apple-skills, the plugin that ships this one along with the rest of its 147 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for ux-writing

README.md
[![agentmods](https://agentmods.dev/badge/skills/rshankras/claude-code-apple-skills/ux-writing/github.svg)](https://agentmods.dev/skills/rshankras/claude-code-apple-skills/ux-writing)
Your own site
<a href="https://agentmods.dev/skills/rshankras/claude-code-apple-skills/ux-writing"><img src="https://agentmods.dev/badge/skills/rshankras/claude-code-apple-skills/ux-writing/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for ux-writing

Your own site · 80×15
<a href="https://agentmods.dev/skills/rshankras/claude-code-apple-skills/ux-writing"><img src="https://agentmods.dev/badge/skills/rshankras/claude-code-apple-skills/ux-writing.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,255 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00083 $0.01255
Opus 5 $0.00042 $0.00628
Sonnet 5 $0.00017 $0.00251
Haiku 4.5 $0.00008 $0.00126

Measured 11d ago against content hash 9e261ee4e793, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

ux-writing scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/design/ux-writing/SKILL.md · 103 lines

How it starts

The opening of the file, as written. The whole thing — 103 lines — stays where its author put it; the contents beside it link to each section on GitHub.

UX Writing

Interface text is interface design. This skill covers writing it: the frameworks Apple's writers use, the anatomy of the hardest components (alerts, errors, empty states, names), and the mechanical edits that improve any screen's copy in minutes.

When This Skill Activates

  • Writing or reviewing user-facing copy: labels, buttons, alerts, onboarding, notifications
  • Naming a new feature, tier, or setting
  • Error messages that frustrate, empty states that dead-end, permission prompts that get denied
  • Localization prep (copy that survives translation)

The PACE framework (Writing for Interfaces)

Run every screen's copy through four questions:

  • Purpose — what must this screen communicate? Headers and buttons should carry the screen alone; know what to leave out. Hierarchy in words mirrors hierarchy in layout.
  • Anticipation — what will the user ask or do next? Write for that ("What comes next?").
  • Context — where is the user right now (quiet home vs. busy airport, mid-task vs. idle)? That decides how much to say.
  • Empathy — write for a person having a problem, not for the system reporting one.

Voice vs. tone

  • Finding voice: describe the app as a person, cluster the personality adjectives, keep 2–3 as your voice attributes — constant across the app, while tone flexes per moment (more directness for high-stakes info, sparing warmth in celebrations).
  • The test that recurs in every Apple session: read it aloud. Does it sound like the best version of your app talking?
  • ❌ Jargon ("it can make people feel left out"); ❌ personality at the cost of usefulness.

The four small edits (biggest impact per minute)

  1. Cut filler: "easily," "quickly," "simply," "just" — ✅ "Enter your license plate to pay for parking" ❌ "Simply enter your license plate number to quickly pay for parking."
  2. Kill repetition — merge redundant sentences: ❌ "We're running late. Your driver won't make it on time. They'll be there in 10 minutes." ✅ "Delivery delayed 10 minutes."
  3. Lead with the why — benefit before action: ✅ "To get reservation updates, enter your phone number." Notifications too: ✅ "Keep your streak going by solving today's crossword."
  4. Keep a word list — three columns: approved term · alternatives to avoid · definition (e.g. "alias — not handle/username/title — the player's in-game name, shown to others"). Reuse identical button labels ("Next") everywhere; consistency builds trust.

Read the full file on GitHub · 103 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 103 lines · 83 tokens per session scan A 9e261ee4e793

Subscribe to this mod's changes

ux-writing is a skill published in the GitHub repository rshankras/claude-code-apple-skills (719 stars, last pushed 1mo ago), licensed MIT. It adds 83 tokens to every session and 1,255 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

brand-identity

Brand strategy and identity design for businesses and products. Use when creating brand guidelines, developing visual identity systems, or defining brand positioning.

travisjneuman/.claude · 30 tokens

generic-react-ux-designer

Professional UI/UX design expertise for React applications. Covers design thinking, user psychology (Hick's/Fitts's/Jakob's Law), visual hierarchy, interaction patterns, accessibility, performance-driven design, and design critique. Use when designing features, improving UX, solving user problems, or conducting design…

travisjneuman/.claude · 69 tokens

graphic-design

Professional graphic design principles for digital and print media. Use when creating visual designs, choosing color palettes, typography, layouts, or providing design feedback.

travisjneuman/.claude · 32 tokens

generic-ux-designer

Professional UX expertise for any project type. Covers user research, design thinking, interaction patterns, accessibility, and design critique. Use when designing new features, improving UX, conducting design reviews, or evaluating user flows. For visual UI work, combine with ui-research skill.

travisjneuman/.claude · 60 tokens

generic-design-system

Complete design system reference for any project - colors, typography, spacing, components, animations. Adapts to project theme and tech stack. Use when implementing UI, choosing colors, creating animations, or ensuring brand consistency. For new design systems, use ui-research skill first.

travisjneuman/.claude · 60 tokens

generic-react-design-system

Complete design system reference for React applications. Covers colors, typography, spacing, component patterns, glassmorphism effects, GPU-accelerated animations, and WCAG AA accessibility. Use when implementing UI, choosing colors, applying spacing, creating components, or ensuring brand consistency.

travisjneuman/.claude · 59 tokens