cgallic/kai-cmo-harness / harness/skills-v2/ux-writing
ux-writing
VerifiedCreate user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and usability, reviewing UI strings, or improving existing interface copy. Applies UX writing best practices based on four quality standards — purposeful, concise, conversational, and clear. Includes accessibility guidelines, research-backed benchmarks (sentence length, comprehension rates, reading levels), expanded error patterns, tone adaptation frameworks, and comprehensive reference materials.
| File | Kind | Size |
|---|---|---|
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 3.9 KB |
| UPSTREAM.md | markdown | 1.2 KB |
| docs/figma-integration.md | markdown | 12.6 KB |
| examples/real-world-improvements.md | markdown | 7.3 KB |
| references/accessibility-guidelines.md | markdown | 11.3 KB |
| references/content-usability-checklist.md | markdown | 4.8 KB |
| references/patterns-detailed.md | markdown | 10.0 KB |
| references/ux-writing-rules.md | markdown | 15.0 KB |
| references/voice-chart-template.md | markdown | 3.9 KB |
| templates/empty-state-template.md | markdown | 5.1 KB |
| templates/error-message-template.md | markdown | 3.1 KB |
| templates/onboarding-flow-template.md | markdown | 7.1 KB |
UPSTREAM.md
View on GitHub# Upstream: ux-writing
Third-party skill, vendored unmodified.
| Field | Value |
|---|---|
| Upstream repository | https://github.com/content-designer/ux-writing-skill |
| Upstream paths | `SKILL.md`, `docs/`, `examples/`, `references/`, `templates/` (the layout of upstream `dist/ux-writing-skill.zip`), plus `LICENSE` |
| Upstream commit | `98cacde4ba2dd10ed28df43a8d53eef1e321c539` (2026-05-26) |
| License | MIT, Copyright (c) 2026 Christopher Greer. The full text is in `LICENSE` in this folder. |
| Vendored | 2026-09-30 |
| Changes | None. v1 `SKILL.md` and v2 `references/ux-writing-rules.md` are byte-identical to upstream `SKILL.md`; `docs/`, `examples/`, `references/` and `templates/` are byte-identical in both folders. The v2 `SKILL.md` is our goal-shaped wrapper around those unchanged rules. Markdown only, no scripts. |
To update: fetch the upstream repo, replace the files in both folders (upstream `SKILL.md` goes to v1 `SKILL.md` and v2 `references/ux-writing-rules.md`), bump the commit above, run `python scripts/sync_plugin_assets.py` and add a CHANGELOG line.
It is not a `kai-*` skill, so it has no page in `docs/skill-manifest/` and no row in the `/kai` router table. The router's "When In Doubt" list points to it.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |