Content Style Guide
mohitagw15856/pm-claude-skills
Create a content style guide / voice & tone guide so everyone writes consistently.
Applies UX writing practice to interface copy such as buttons, errors, forms and onboarding, using four quality standards and accessibility guidance.
$ npx skills add content-designer/ux-writing-skill --skill ux-writing -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install content-designer/ux-writing-skill ux-writing --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
Claude Code skills documentation · loads skills from .claude/skills/
Install the "ux-writing" agent skill from https://github.com/content-designer/ux-writing-skill/tree/main into .claude/skills/ux-writing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-writing", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add content-designer/ux-writing-skill --skill ux-writing -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install content-designer/ux-writing-skill ux-writing --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "ux-writing" agent skill from https://github.com/content-designer/ux-writing-skill/tree/main into .agents/skills/ux-writing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-writing", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add content-designer/ux-writing-skill --skill ux-writing -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install content-designer/ux-writing-skill ux-writing --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "ux-writing" agent skill from https://github.com/content-designer/ux-writing-skill/tree/main into .cursor/skills/ux-writing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-writing", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add content-designer/ux-writing-skill --skill ux-writing -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install content-designer/ux-writing-skill ux-writing --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "ux-writing" agent skill from https://github.com/content-designer/ux-writing-skill/tree/main into .gemini/skills/ux-writing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-writing", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install content-designer/ux-writing-skill ux-writingInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add content-designer/ux-writing-skill --skill ux-writing -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "ux-writing" agent skill from https://github.com/content-designer/ux-writing-skill/tree/main into .github/skills/ux-writing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-writing", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add content-designer/ux-writing-skill --skill ux-writing -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install content-designer/ux-writing-skill ux-writing --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "ux-writing" agent skill from https://github.com/content-designer/ux-writing-skill/tree/main into .opencode/skills/ux-writing/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "ux-writing", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
ux-writingApplies UX writing practice to interface copy such as buttons, errors, forms and onboarding, using four quality standards and accessibility guidance.
This skill guides the agent in writing and auditing interface copy, from buttons, labels and titles to error messages, notifications, empty states, onboarding and help text. Everything is held to four standards: purposeful, concise, conversational and clear. Practical rules include sentence case, active imperative verbs for buttons, front-loading important information, plain language aimed at a 7th-grade reading level for general audiences and 10th for professional ones, and active voice about 85% of the time.
It also covers conversational flows, voice and tone guidelines, tone adaptation, consistency audits and review of existing UI strings. The package includes reference materials, examples, a Figma integration doc and a build script that produces a zip of the skill. It is written for Claude, Codex and Cursor, and a note says it works with the Codex CLI or IDE, not with ChatGPT.
4 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 98cacde. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships script files (Shell, from the files we listed), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
UX Writing loads about 3.8k tokens when it runs, and up to ~11k if it reads all its reference files. Until then it costs about 206 tokens; SKILL.md has 1,768 words of instructions outside code blocks.
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.
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.
The full file from content-designer/ux-writing-skill at commit 98cacde, republished under its MIT licence (© content-designer). 1,768 words, ~3,829 tokens.
.claude/skills/ux-writing/SKILL.md (or your agent's skills folder). This skill also uses 27 other files; get the full folder from GitHub.Write clear, concise, user-centered interface copy (UX text/microcopy) for digital products and experiences. This skill provides frameworks, patterns, and best practices for creating text that helps users accomplish their goals.
Compatible with: Claude, Codex, Cursor, and other agents that support the agent skills specification.
Note: This skill works with Codex CLI/IDE, not ChatGPT. ChatGPT cannot install or use skills.
Use this skill when:
Every piece of UX text should be:
Conciseness
Clarity
Conversational Tone
User-Centered
Apply these common patterns for interface elements.
[Verb] [object] [What failed]. [Why/context]. [What to do].Error Message Types
Validation Errors (Inline)
[Field] [specific requirement]System Errors (Modal/Banner)
[Action failed]. [Likely cause]. [Recovery step].Blocking Errors (Full-screen)
[What's blocked]. [Why]. [Specific action needed].Permission Errors
[User benefit]. [Permission needed].What to Avoid
[Action] [result/benefit]Voice is the consistent personality of the product. Establish voice using:
See references/voice-chart-template.md for creating a voice chart.
Tone is how voice adapts to specific situations. While voice remains constant, tone shifts based on user context and emotional state.
Tone Variables
Tone Adaptation by User Emotional State
Frustrated (errors, failures, blockers)
Confused (first use, complex features)
Confident (routine tasks, return visits)
Cautious (high-stakes actions, data loss)
Successful (completions, achievements)
Tone Adaptation by Content Type
Error messages: Empathetic, reassuring, solution-focused
Success messages: Positive, specific, encouraging
Instructions: Clear, direct, helpful
Onboarding: Inviting, encouraging, concise
Confirmations: Serious, transparent, respectful
Empty states: Hopeful, actionable, guiding
Edit UX text in four phases:
Understand context
Draft content
Edit iteratively
Test and measure
Writing accessible content ensures all users, including those using assistive technology, can understand and interact with your product.
Screen Reader Optimization
Cognitive Accessibility
Multi-Modal Communication
Plain Language for All
Buttons
Links
Error Messages
Form Labels
Use these research-backed metrics to create effective UX text.
By Content Type
Comprehension Rates
Optimal Ranges
By Audience
Testing Tools
Sentence case: "Save your changes" (not "Save Your Changes")
Active imperative for buttons: "Delete account" (not "Account deletion")
User-focused: "Save time with shortcuts" (not "We offer shortcuts")
Specific verbs: "Delete" (not "Remove" when permanently deleting)
Front-loaded: "Password must be 8 characters" (not "Must be 8 characters for your password")
This skill includes:
© content-designer, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 27 other files (references) in the repository root of content-designer/ux-writing-skill.
Open the folder on GitHubat commit 98cacde
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in content-designer/ux-writing-skill, which our catalogue first saw on October 7, 2026.
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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| UX Writing this skillcontent-designer/ux-writing-skill | 224 | 1 repos | ~3.8k | Automated safety check: Pass | MIT | |
| Content Style Guidemohitagw15856/pm-claude-skills | 1.4k | — | ~1k | Automated safety check: Pass | MIT | |
| Color Auditrome-os/rome | 743 | — | ~2.7k | Automated safety check: Pass | MIT | |
| Nbj Write Clearlydaniel-p-green/nbj-write-clearly | 117 | — | ~1.1k | Automated safety check: Pass | MIT | |
| Readable ContentOwl-Listener/inclusive-design-skills | 105 | — | ~883 | Automated safety check: Pass | MIT | |
| Ieee Figure TableCloudWave818/ieee-skills | 359 | — | ~1k | Automated safety check: Pass | MIT |
mohitagw15856/pm-claude-skills
Create a content style guide / voice & tone guide so everyone writes consistently.
rome-os/rome
Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…
daniel-p-green/nbj-write-clearly
Drafts, revises, and audits reader-first technical and product documentation.
Owl-Listener/inclusive-design-skills
Write and structure content for diverse reading abilities and cognitive styles.
CloudWave818/ieee-skills
Audit, redesign, generate, and improve IEEE manuscript figures, tables, captions, result presentation, plotting scripts, visual polish, hybrid Python/R plus vector-editor workflows…
AgriciDaniel/claude-blog
Create and manage writing personas with NNGroup 4-dimension tone framework (Funny-Serious, Formal-Casual, Respectful-Irreverent, Enthusiastic-Matter-of-fact).
Works with
Categories
Applies UX writing practice to interface copy such as buttons, errors, forms and onboarding, using four quality standards and accessibility guidance. This skill guides the agent in writing and auditing interface copy, from buttons, labels and titles to error messages, notifications, empty states, onboarding and help text. Everything is held to four standards: purposeful, concise, conversational and clear.
UX Writing fits situations like: writing button labels, error messages and success messages; editing existing UI text for clarity and reading level; designing onboarding or empty-state copy; auditing product copy for consistency.
Run `npx skills add content-designer/ux-writing-skill --skill ux-writing -a claude-code`. Or copy the skill folder (the content-designer/ux-writing-skill repository) into .claude/skills/ux-writing in your project. Claude Code loads it when a task matches its description.
Run `npx skills add content-designer/ux-writing-skill --skill ux-writing -a codex`. Or copy the skill folder (the content-designer/ux-writing-skill repository) into .agents/skills/ux-writing in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add content-designer/ux-writing-skill --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.
Going by SKILL.md and its folder, UX Writing needs a shell for the scripts in its folder.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
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.
UX Writing is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.8k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.7k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with UX Writing: Content Style Guide (mohitagw15856/pm-claude-skills, 1.4k stars), Color Audit (rome-os/rome, 743 stars), Nbj Write Clearly (daniel-p-green/nbj-write-clearly, 117 stars) and Readable Content (Owl-Listener/inclusive-design-skills, 105 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
content-designer (a GitHub user) maintains it in content-designer/ux-writing-skill, which has 224 GitHub stars. The repository was last updated on May 26, 2026.
Source: content-designer/ux-writing-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.