ux-writing

ux-writing is a skill for Claude Code, Codex from subhansh-dev/agent-maxxing. It costs 18 tokens per session (1,036 once invoked), scanned A, original, MIT.

A UX-writing guide for clear labels, instructions, and error messages in software interfaces. UX writing is the wording users see while they use an application.

In plain words
What is it for?
Use it to write buttons, destructive-action confirmations, validation messages, permission notices, and network-error text.
Why use it?
It removes vague button text and unhelpful errors by making each message explain the action, what happened, and what the user can do next.

Skill for Claude CodeCodex

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.

agentmods
npx agentmods add skills/subhansh-dev/agent-maxxing/ux-writing
Any agent
npx skills add subhansh-dev/agent-maxxing --skill ux-writing
Clone the repo
git clone --depth 1 https://github.com/subhansh-dev/agent-maxxing

Made for: Claude Code, Codex.

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/subhansh-dev/agent-maxxing/ux-writing.svg)](https://agentmods.dev/skills/subhansh-dev/agent-maxxing/ux-writing)
Your own site
<a href="https://agentmods.dev/skills/subhansh-dev/agent-maxxing/ux-writing"><img src="https://agentmods.dev/badge/skills/subhansh-dev/agent-maxxing/ux-writing.svg" alt="Measured on agentmods" height="20"></a>
Per session 18 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,036 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
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 $0.00018 $0.01036
Opus 5 $0.00009 $0.00518
Sonnet 5 $0.00004 $0.00207
Haiku 4.5 $0.00002 $0.00104

Measured 5d ago against content hash 7db33a1aa115, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, 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 5d 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.

content/ux-writing/SKILL.md · 113 lines

How it starts

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

UX Writing

The Button Label Problem

Never use "OK", "Submit", or "Yes/No". These are lazy and ambiguous. Use specific verb + object patterns:

Bad Good Why
OK Save changes Says what will happen
Submit Create account Outcome-focused
Yes Delete message Confirms the action
Cancel Keep editing Clarifies what "cancel" means
Click here Download PDF Describes the destination

For destructive actions, name the destruction:

  • "Delete" not "Remove" (delete is permanent, remove implies recoverable)
  • "Delete 5 items" not "Delete selected" (show the count)

Error Messages: The Formula

Every error message should answer: (1) What happened? (2) Why? (3) How to fix it? Example: "Email address isn't valid. Please include an @ symbol." not "Invalid input".

Error Message Templates

Situation Template
Format error "[Field] needs to be [format]. Example: [example]"
Missing required "Please enter [what's missing]"
Permission denied "You don't have access to [thing]. [What to do instead]"
Network error "We couldn't reach [thing]. Check your connection and [action]."
Server error "Something went wrong on our end. We're looking into it. [Alternative action]"

Don't Blame the User

Reframe errors: "Please enter a date in MM/DD/YYYY format" not "You entered an invalid date".

Empty States Are Opportunities

Empty states are onboarding moments: (1) Acknowledge briefly, (2) Explain the value of filling it, (3) Provide a clear action. "No projects yet. Create your first one to get started." not just "No items".

Voice vs Tone

Voice is your brand's personality—consistent everywhere. Tone adapts to the moment.

Moment Tone Shift
Success Celebratory, brief: "Done! Your changes are live."
Error Empathetic, helpful: "That didn't work. Here's what to try..."
Loading Reassuring: "Saving your work..."
Destructive confirm Serious, clear: "Delete this project? This can't be undone."

Read the full file on GitHub · 113 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. 5d ago First seen · 113 lines · 18 tokens per session scan A 7db33a1aa115

Subscribe to this mod's changes

ux-writing is a skill published in the GitHub repository subhansh-dev/agent-maxxing (2 stars, last pushed 1mo ago), licensed MIT. It adds 18 tokens to every session and 1,036 once invoked, about $0.0001 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-31.