Audit Ux Copy
audit_ux_copyAudit UI and marketing copy for readability, passive voice, jargon, filler, and weak CTAs. Receive metrics with flagged phrases and fixes.
Instructions
Audit UI / marketing copy objectively: readability (Flesch reading ease + grade level), average sentence length, passive voice, jargon/hype words, filler, user-focus ('you' vs 'we'), and weak CTAs. Returns metrics plus specific flagged phrases and fixes. The machine-checkable slice of UX writing — pair with get_design_doc('ux-writing') for voice/tone judgment. It reads source and does not measure anything: no usability session is run, no A/B result is read, and no finding here is or can be a statement about whether the copy actually works for a reader. It also has no notion of register: it has no way to tell short UI copy from long-form prose, so a paragraph of accurate technical documentation can draw more jargon/filler hits than a paragraph of real hype. Returns markdown plus structured output: findings (rule, severity, message, fix, doc, line), a severity summary, a machine-readable notVisible list of what it could not check, and a metrics block carrying the same words/sentences/avgSentenceLen/Flesch/grade-level/you-we numbers the markdown table prints.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | The copy to audit (a headline, paragraph, button label, error message, or full page copy) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| metrics | Yes | The metrics table the markdown half prints, as numbers. Facts about the text's shape, not measurements of how it reads — see `notVisible`. | |
| summary | Yes | Counts by severity. Always agrees with `findings` — it is derived from the same list. | |
| findings | Yes | Every finding, in the order the markdown report lists them. | |
| notVisible | Yes | What this audit structurally could not check, one limitation per entry. Read it as a peer of `findings`: silence on a subject named here is this tool's reach, not a clean result. Nothing any of these tools reports is measured. |