New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

UX Writing

by rshankras in rshankras/claude-code-apple-skills

Interface copy that works — voice/tone, the PACE framework, alert anatomy, naming features, empty states, error messages, and the small-word edits that measurably improve UX.

MITAuto-check passed

Install UX Writing

skills CLI
$ npx skills add rshankras/claude-code-apple-skills --skill ux-writing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rshankras/claude-code-apple-skills ux-writing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rshankras/claude-code-apple-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/design/ux-writing .claude/skills/ux-writing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ux-writing
GitHub stars
787
Token cost
~1.3k tokens
SKILL.md length
610 words
Files
1
Skills in repo
41
Repo updated
First seen
Licence
MIT

At a glance

Interface copy that works — voice/tone, the PACE framework, alert anatomy, naming features, empty states, error messages, and the small-word edits that measurably improve UX.

  • Works in 4 steps: Cut filler: "easily," "quickly,"… → Kill repetition — merge redundant… → Lead with the why — benefit before… → …
  • Reviewing any user-facing text — labels
  • SKILL.md covers When This Skill Activates, The PACE framework (Writing…, Voice vs. tone and The four small edits (biggest…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

UX Writing is an agent skill from rshankras/claude-code-apple-skills. Interface copy that works — voice/tone, the PACE framework, alert anatomy, naming features, empty states, error messages, and the small-word edits that measurably improve UX. Distilled from Apple's writing sessions (2017–2026). Use when writing or reviewing any user-facing text — labels, alerts, onboarding, notifications, empty states, paywalls — or naming a feature.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Claude Code skills for Apple platform development (iOS, macOS, iPadOS) — product validation, code generation, App Store optimization, and more. The licence is MIT.

When your agent uses it

  • Reviewing any user-facing text — labels
  • Naming a feature

Example prompts

  • “/ux-writing”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Glob, Grep

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Cut filler: "easily," "quickly," "simply," "just" — ✅ "Enter your license plate to pay
  2. Kill repetition — merge redundant sentences: ❌ "We're running late. Your driver won't
  3. Lead with the why — benefit before action: ✅ "To get reservation updates, enter your
  4. Keep a word list — three columns: approved term · alternatives to avoid · definition

What it can do on your machine

Read from SKILL.md and the folder at commit 9ffb831. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • developer.apple.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

UX Writing loads about 1.3k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 610 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rshankras/claude-code-apple-skills at commit 9ffb831, republished under its MIT licence (© rshankras). 610 words, ~1,329 tokens.

Download SKILL.mdSave it as .claude/skills/ux-writing/SKILL.md (or your agent's skills folder).
name
ux-writing
description
Interface copy that works — voice/tone, the PACE framework, alert anatomy, naming features, empty states, error messages, and the small-word edits that measurably improve UX. Distilled from Apple's writing sessions (2017–2026). Use when writing or reviewing any user-facing text — labels, alerts, onboarding, notifications, empty states, paywalls — or naming a feature.
allowed-tools
Read, Write, Edit, Glob, Grep
last_verified
2026-07-16
review_by
2027-06-22

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.
Show full SKILL.md (248 more words)Show less

Alert anatomy (Writing Great Alerts)

First: should this be an alert at all? Alerts interrupt by design — reserve them for things the user must know now.

  • Title: the main point, one sentence or less. Message: only if needed.
  • The scannability test: title + buttons alone must convey the situation.
  • ❌ Vague hedging ("You may need to…") — name the file, name the fix.

Naming features (Craft Clear Names, WWDC26)

Judge every candidate on three criteria: it belongs (fits the app and its location), it sets expectations (readers predict what they'll get), it works everywhere (languages, markets, platforms).

  • Process: Think / Feel / Do — what should the audience think, feel, and do? Group the answers into themes; name from the themes; test candidates in natural sentences ("just search for ___").
  • ✅ Industry-standard words in high-stakes domains: "Balance," not "Spending Power."
  • ✅ Compounds are fine when the parts self-explain ("AutoMix"); emotional names win where the moment is emotional ("Memories").
  • ❌ Implementation jargon — describe the outcome, not the mechanism.

Empty states, permissions, localization

  • Empty states: never dead-end — say what will appear and how, ideally with example input.
  • Permission prompts: explain value first, ask at the contextually right moment (mechanics in generators/permission-priming).
  • Localization: plain language over idiom/humor; leave layout room and accessibility text for every element.

Output Format

Copy review table:

Location | Current | Problem (PACE / filler / vague button / jargon) | Rewrite

ordered by frequency-of-exposure (navigation labels before deep-screen prose).

References

© rshankras, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/design/ux-writing of rshankras/claude-code-apple-skills.

Open the folder on GitHubat commit 9ffb831

Compare with similar skills

UX Writing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

UX Writing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
UX Writing this skillrshankras/claude-code-apple-skills787—~1.3kAutomated safety check: PassMIT
Copy Editingcoreyhaines31/marketingskills54k1 repos~4.5kAutomated safety check: PassMIT
Network Interface Healthaffaan-m/ECC276k1 repos~1.4kAutomated safety check: PassMIT
Make Interfaces Feel Betteraffaan-m/ECC276k1 repos~1.2kAutomated safety check: PassMIT
UX Copysickn33/agentic-awesome-skills47k1 repos~1kAutomated safety check: PassMIT
Sci Fi Interfacesickn33/agentic-awesome-skills47k1 repos~3.1kAutomated safety check: PassMIT

Similar skills

  • Copy Editing

    coreyhaines31/marketingskills

    When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content.

    54k GitHub starsUsed in 1 repo~4.5k tokens
    Writing & ContentAuto-check passed

  • Network Interface Health

    affaan-m/ECC

    Diagnose interface errors, drops, CRCs, duplex mismatches, flapping, speed negotiation issues, and counter trends on routers, switches, and Linux hosts.

    276k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed

  • Make Interfaces Feel Better

    affaan-m/ECC

    Apply concrete design-engineering details that make interfaces feel polished.

    276k GitHub starsUsed in 1 repo~1.2k tokens
    Frontend & DesignAuto-check passed

  • UX Copy

    sickn33/agentic-awesome-skills

    Generate UX microcopy (button labels, error messages, empty states, toasts) following a casual-but-polite voice and tone

    47k GitHub starsUsed in 1 repo~1k tokens
    Writing & ContentAuto-check passed

  • Sci Fi Interface

    sickn33/agentic-awesome-skills

    Web and App implementation guide for Sci-Fi Interface Design.

    47k GitHub starsUsed in 1 repo~3.1k tokens
    MobileAuto-check passed

  • Bio Copy Number Subclonal Copy Number

    GPTomics/bioSkills

    Resolve subclonal copy number, whole-genome doubling, and copy-number tumor evolution from bulk sequencing with Battenberg, TITAN, and MEDICC2.

    1.2k GitHub starsUsed in 2 repos~3.5k tokens
    Research & ScienceAuto-check passed

More from rshankras/claude-code-apple-skills

All 41 skills in this repo

  • Accessibility Generator

    rshankras/claude-code-apple-skills

    Generate accessibility infrastructure for VoiceOver, Dynamic Type, and accessibility features.

    787 GitHub stars~1.4k tokensUpdated 2 mo ago
    Auto-check: notes

  • Animation Patterns

    rshankras/claude-code-apple-skills

    SwiftUI animation patterns including springs, transitions, PhaseAnimator, KeyframeAnimator, SF Symbol effects, scroll-driven effects, mesh gradients, text renderers, and shader effects.

    787 GitHub stars~2.1k tokensUpdated 2 mo ago
    Auto-check passed

  • App Description Writer

    rshankras/claude-code-apple-skills

    Generate compelling App Store descriptions that convert browsers into users.

    787 GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed

  • App Icon Generator

    rshankras/claude-code-apple-skills

    Generates an app icon for macOS or iOS — a fast CoreGraphics placeholder and/or flat layered source art to finish in Icon Composer (the Liquid Glass / iOS 26+ standard).

    787 GitHub stars~5.1k tokensUpdated 2 mo ago
    Auto-check: notes

  • App Namer

    rshankras/claude-code-apple-skills

    Turn an app idea into validated, App-Store-ready name candidates.

    787 GitHub stars~3.4k tokensUpdated 2 mo ago
    Auto-check passed

  • Bundles And Licensing

    rshankras/claude-code-apple-skills

    Revenue beyond the single-app price tag — own-app bundles, Family Sharing as a conversion lever, cross-developer bundles & suites, and institutional licensing via Group Purchases / Apple School &…

    787 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed

Questions about UX Writing

What does UX Writing do?

Interface copy that works — voice/tone, the PACE framework, alert anatomy, naming features, empty states, error messages, and the small-word edits that measurably improve UX. UX Writing is an agent skill from rshankras/claude-code-apple-skills. Interface copy that works — voice/tone, the PACE framework, alert anatomy, naming features, empty states, error messages, and the small-word edits that measurably improve UX.

When should I use UX Writing?

UX Writing fits situations like: reviewing any user-facing text — labels; naming a feature.

How do I install UX Writing in Claude Code?

Run `npx skills add rshankras/claude-code-apple-skills --skill ux-writing -a claude-code`. Or copy the skill folder (skills/design/ux-writing in rshankras/claude-code-apple-skills) into .claude/skills/ux-writing in your project. Claude Code loads it when a task matches its description.

How do I install UX Writing in Codex?

Run `npx skills add rshankras/claude-code-apple-skills --skill ux-writing -a codex`. Or copy the skill folder (skills/design/ux-writing in rshankras/claude-code-apple-skills) into .agents/skills/ux-writing in your project. Codex loads it when a task matches its description.

Can I use UX Writing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rshankras/claude-code-apple-skills --skill ux-writing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ux-writing, .gemini/skills/ux-writing, .github/skills/ux-writing and .opencode/skills/ux-writing in your project.

What does UX Writing need to run?

SKILL.md names no scripts, command-line tools or credentials: UX Writing is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Glob, Grep.

Does UX Writing access the network?

SKILL.md names 1 domain. As links in the text: developer.apple.com. This is read from the text; nothing was executed.

Is UX Writing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does UX Writing use?

UX Writing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does UX Writing use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to UX Writing?

Skills that share tags, products or a category with UX Writing: Copy Editing (coreyhaines31/marketingskills, 54k stars), Network Interface Health (affaan-m/ECC, 276k stars), Make Interfaces Feel Better (affaan-m/ECC, 276k stars) and UX Copy (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains UX Writing?

rshankras (a GitHub user) maintains it in rshankras/claude-code-apple-skills, which has 787 GitHub stars. The repository holds 41 skills in this directory. The repository was last updated on July 24, 2026.

Source: rshankras/claude-code-apple-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.