critique-claritylisted

Reviews markdown or plain-text prose for clarity against the Federal Plain Language Guidelines and Williams' Style: readability, passive voice, sentence length, and nominalization density. Judges sentence- and passage-level readability, not whether an argument's claim is supported or its structure holds together (critique-argument covers that). Use when the user asks for feedback, a second opinion, a red-line pass, or a quality check on a memo, PRD, proposal, or any prose document before it goes out.
product-on-purpose/critique-skills · ★ 1 · AI & Automation · score 71

Install: claude install-skill product-on-purpose/critique-skills

# critique-clarity Reviews a markdown or plain-text prose document against two operationalized rubrics: the Federal Plain Language Guidelines (`PLAIN`, open standard) and Joseph M. Williams and Joseph Bizup's *Style: Lessons in Clarity and Grace* (`WILLIAMS`, paraphrased). Together they cover readability mechanics such as active voice, sentence length, and nominalization density, alongside judged qualities such as audience fit and passage-level cohesion, and report findings as a contract-valid run envelope. **Artifact claim.** This skill evaluates markdown or plain-text prose documents: memos, PRDs, proposals, policy explanations, and similar continuous prose. It does not evaluate HTML rendering, visual layout, non-prose structured data, or any of the other five launch skills' artifact types; a document that is mostly a UI spec, an error-message list, or an argumentative essay's structure specifically is better served by `critique-usability`, `critique-microcopy`, or `critique-argument` respectively. ## Contract Every finding this skill emits conforms to `contract/critique-contract.schema.json`. See `docs/reference/critique-contract.md` for the field contracts a schema cannot check on its own: location navigable unaided, evidence quoted or measured rather than characterized, violation naming the breach, fix actionable and specific. ## Protocol Follow these four passes in order. Do not skip ahead to severity or fixes while still sweeping. 1. **Inventory.** Map the artif