{
  "markdown": "# Agent Skill for UX Writing\n\n> Scale content quality through AI-powered design system enforcement\n\n**🌐 [View website](https://content-designer.github.io/ux-writing-skill/)**\n**📄 [Read docs](https://content-designer-ux-writing-skill-26.mintlify.app/introduction)**\n\nAn [agent skill](https://agentskills.io/) that enables Claude, Codex, and Cursor to write and edit user-centered interface copy (UX text/microcopy) for digital products. This skill transforms AI assistants into specialized UX writing tools that apply consistent standards, patterns, and voice across your product.\n\n## The Problem\n\nDesign systems solve visual consistency, but content quality still depends on individual writers. Every error message, button label, and empty state requires manual review to ensure it's clear, concise, conversational, and purposeful. This doesn't scale.\n\n## The Solution\n\nThis agent skill packages UX writing expertise into a system your agent can apply automatically. Instead of asking \"make this better,\" you can rely on consistent, evidence-based improvements across your entire product interface.\n\n## What Makes This Different\n\n**Systems thinking, not style guides**: This isn't a list of writing tips. It's a framework for evaluating and improving UX text based on four measurable quality standards.\n\n**Progressive disclosure**: Reference materials are loaded only when needed, keeping Claude's context efficient while providing deep expertise on demand.\n\n**Proven patterns**: Built from real-world UX writing best practices, with examples across different product voices and contexts.\n\n**Immediately actionable**: Every pattern includes concrete before/after examples and scoring against quality standards.\n\n## What You Get\n\n### Core Framework\n- **Four quality standards**: Purposeful, Concise, Conversational, Clear\n- **Common UX patterns**: Buttons, errors, empty states, forms, notifications, onboarding\n- **Editing process**: Systematic approach to improving any interface text\n- **Voice and tone guidance**: Adapt content to brand personality and context\n- **Accessibility guidelines**: Write for screen readers, cognitive accessibility, and WCAG compliance\n- **Research-backed benchmarks**: Sentence length targets, comprehension rates, reading levels\n\n### Reference Materials\n- **Accessibility guidelines**: Comprehensive guide for writing inclusive, accessible UX text\n- **Voice chart template**: Establish consistent brand personality\n- **Content usability checklist**: Evaluate text quality with scoring framework\n- **Detailed pattern examples**: See how different voices apply the same patterns\n\n### Practical Tools\n- **Real-world improvements**: Before/after transformations with analysis\n- **Fillable templates**: Error messages, empty states, onboarding flows\n- **Expanded error patterns**: Validation, system, blocking, and permission errors with examples\n- **Tone adaptation framework**: Map emotional states to appropriate tone\n- **Quick reference**: Common patterns and anti-patterns\n\n## Use Cases\n\n**For content designers**: Apply consistent UX writing standards across your product without memorizing every rule.\n\n**For product teams**: Enable non-writers to create interface copy that follows your design system.\n\n**For design system teams**: Enforce content guidelines at scale without becoming a bottleneck.\n\n**For early-stage products**: Build content quality in from the start with proven patterns.\n\n## Installation\n\n### What You Need\n\nThis skill works with **Claude Desktop**, **Claude Code**, **Codex** (CLI and IDE extensions), and **Cursor**. Install it with the [skills CLI](https://skills.sh/docs/cli) — no manual download or file copying required.\n\n**Note:** This skill works with Codex CLI/IDE, not ChatGPT. ChatGPT cannot install or use skills.\n\n### Install with the Skills CLI\n\nRun this command in your terminal:\n\n```bash\nnpx skills add content-designer/ux-writing-skill\n```\n\nThe CLI downloads the skill and configures it automatically for your agent. Restart your agent or IDE after installation.\n\n**Verify it's working** by asking your agent:\n\n```\nWrite an error message for when a payment fails\n```\n\nYour agent will apply UX writing best practices and produce a clear, empathetic error message.\n\n### For Teams: Project Installation\n\nWant your whole team to use this skill automatically? Run the CLI from your project root:\n\n```bash\nnpx skills add content-designer/ux-writing-skill\n```\n\nThen commit the installed skill files to your repository. Teammates get the skill when they pull the code.\n\n## Figma Integration\n\n**Review and improve UX copy directly from your Figma designs!**\n\nConnect this skill to Figma through your agent to analyze mockups, audit copy, and suggest improvements based on UX writing best practices. Perfect for:\n- Content designers reviewing flows before launch\n- Product teams iterating on copy in designs\n- Design QA and accessibility audits\n- Cross-platform consistency checks\n\n**📖 Setup guide for all agents:** [docs/figma-integration.md](docs/figma-integration.md)\n\n## Usage Examples\n\n### Basic Usage\n\n```\nWrite an error message for when a payment fails\n```\n\nYour agent applies the skill automatically and generates clear, actionable error messages following best practices.\n\n### Editing Existing Copy\n\n```\nReview this button label: \"Submit your information for processing\"\n```\n\nYour agent evaluates against the four quality standards and suggests improvements.\n\n### Creating Consistent Patterns\n\n```\nCreate empty state copy for a task list, keeping voice consistent with:\n- Purposeful, Concise, Conversational, Clear\n- Professional but friendly tone\n```\n\nYour agent applies the appropriate patterns and maintains voice consistency.\n\n### Evaluating Quality\n\n```\nScore this error message:\n\"An error occurred. Please try again later.\"\n```\n\nYour agent uses the content usability checklist to provide detailed scoring and improvement suggestions.\n\n## How It Works\n\nThis skill uses **model-invoked activation** — Claude, Codex, and Cursor automatically decide when to use it based on your request. You don't need to explicitly call the skill; it activates when you:\n\n- Write or edit interface copy\n- Create error messages, notifications, or empty states\n- Work on button labels, form fields, or instructions\n- Review product content for consistency\n- Establish voice and tone guidelines\n\nThe AI loads reference materials progressively, using only what's needed for your specific task to maintain efficient context usage.\n\n**In Codex**, you can also explicitly invoke the skill using `$ux-writing` or through the `/skills` command. **In Cursor**, use `@ux-writing` or reference the skill by name in your prompt.\n\n## What You'll Learn\n\nUsing this skill exposes the systematic thinking behind effective UX writing:\n\n- How to evaluate content objectively with scoring frameworks\n- Why certain patterns work across different product contexts\n- How voice stays consistent while tone adapts to situations\n- The difference between writing for clarity vs. writing for personality\n\n## For Content Design Teams\n\nThis skill can serve as:\n\n- **Onboarding tool**: New team members learn patterns faster\n- **Quality baseline**: Consistent standards across all writers\n- **Efficiency multiplier**: Generate first drafts that follow guidelines\n- **System documentation**: Reference materials that never go stale\n\n## Credits\n\nBuilt by [Christopher Greer](https://www.linkedin.com/in/christopher-greer/), Staff Content Designer at Stripe, based on established UX writing principles from:\n\n- Content Design by Sarah Richards\n- Strategic Writing for UX by Torrey Podmajersky  \n- Nicely Said by Kate Kiefer Lee and Nicole Fenton\n- Google Material Design writing guidelines\n- Years of practical application building design systems\n\n## Contributing\n\nContributions welcome! If you have:\n\n- Additional reference patterns\n- More real-world examples\n- Template improvements\n- Translations to other languages\n\nPlease open an issue or submit a pull request.\n\n### Building the Skill Package\n\nIf you're contributing or want to build the skill ZIP locally:\n\n```bash\n./build-skill.sh\n```\n\nThis creates `dist/ux-writing-skill.zip` containing only the skill files (`SKILL.md`, `docs/`, `examples/`, `references/`, `templates/`).\n\nThe build script excludes repository files like `README.md`, `CONTRIBUTING.md`, `index.html`, and the demo video — these live on GitHub but aren't needed in the skill package.\n\n## License\n\nMIT License — use this skill freely in your projects and teams.\n\n## Related Work\n\nLooking for more agent skills?\n\n- Learn about the standard: [agentskills.io](https://agentskills.io/)\n- Browse skills on [skills.sh](https://skills.sh)\n- Install skills with the [skills CLI](https://skills.sh/docs/cli)\n\n**For Claude**\n\n- Browse the [Claude Code Skills collection](https://github.com/anthropics/skills)\n- Learn about [agent skills architecture](https://claude.com/blog/equipping-agents-for-the-real-world-with-agent-skills)\n- Read [best practices for authoring skills](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)\n\n**For Codex**\n\n- Explore [Codex Agent Skills documentation](https://developers.openai.com/codex/skills/)\n- Learn how to [create custom skills](https://developers.openai.com/codex/skills/create-skill)\n- Join the [OpenAI Developer Community](https://community.openai.com/) to discuss skills\n\n**For Cursor**\n\n- Read about [Cursor Agent Skills](https://cursor.com/docs/context/skills)\n\n## Why This Matters\n\nContent is infrastructure. Every button label, error message, and empty state shapes how people understand and use your product. Good UX writing shouldn't depend on having an expert review every string. \n\nThis skill makes UX writing excellence systematic, scalable, and consistent — exactly what design systems do for visual design.\n\n---\n\n**Status**: Production-ready • **Version**: 1.6.0 • **Last updated**: March 2026\n",
  "bytes": 9924,
  "sha": "cd91a5041ba536a21bcbdce4bc2ff96128ada9704d687737f274daacc2abe4b8",
  "repo_slug": "content-designer/ux-writing-skill",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_content_designer_ux_writing_skill_ux_wri_e501ec4f/readme"
}