plugins/prose/skills/reviewing-prose/SKILL.md
ALWAYS invoke this skill when reviewing, editing, or improving prose for quality. NEVER review prose without this skill.
npx skillsauth add outcomeengineering/spx-claude reviewing-proseInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Detect and fix formulaic patterns that signal machine-generated or lazy writing. Flag specific violations and suggest concrete rewrites.
</objective><quick_start>
Core rule: Zero tolerance. Every pattern in the reference catalog is a violation. Do not excuse any instance as "single use" or "it lands here." If a sentence triggers a pattern, flag it. If a sentence triggers two patterns simultaneously, it is the highest priority flag.
Before reviewing, read /standardizing-prose for the complete catalog of 30+ anti-patterns across 6 categories.
</quick_start>
<essential_principles>
Six categories of patterns to detect. Each is detailed with examples in the reference file.
Word choice -- Significance adverbs ("quietly", "deeply"), authenticity adverbs ("genuinely", "truly", "actually"), overused vocabulary ("delve", "leverage", "robust", "genuine"), ornate nouns ("tapestry", "landscape", "paradigm"), pompous verbs ("serves as", "stands as").
Sentence structure -- Negative parallelism ("It's not X -- it's Y"), stacked negations ("Not X. Not Y. Just Z."), rhetorical self-answers ("The result? Devastating."), anaphora abuse, tricolon stacking, filler transitions ("It's worth noting"), tacked-on significance ("highlighting its importance"), false ranges, gerund fragment litanies, tautological definitions ("An irreversible change does not revert"), redundant paired examples.
Paragraph structure -- Strings of punchy fragments as standalone paragraphs, listicles disguised as prose ("The first... The second... The third...").
Tone -- False-suspense transitions ("Here's the kicker"), unnecessary metaphors ("Think of it as..."), hypothetical openers ("Imagine a world where..."), performed vulnerability, asserting clarity ("The truth is simple"), grandiose stakes inflation, teacher-student condescension ("Let's break this down"), vague attributions ("Experts argue"), invented concept labels ("the supervision paradox").
Formatting -- Em-dash overuse, bold-first bullets, unicode decoration.
Composition -- Fractal summaries, dead metaphors, historical analogy stacking, one-point dilution, content duplication, signposted conclusions, dismissive optimism ("Despite its challenges...").
</essential_principles>
<workflow>/standardizing-prose for the anti-pattern catalog<success_criteria>
Review is complete when:
</success_criteria>
<reference_index>
| Skill | When to Read |
| ---------------------- | -------------------------- |
| /standardizing-prose | Always -- before reviewing |
</reference_index>
tools
ALWAYS invoke this skill when creating Excalidraw diagrams, visualizing workflows, architectures, or concepts. NEVER generate Excalidraw JSON without this skill.
development
ALWAYS invoke this skill when writing or fixing tests for TypeScript.
development
TypeScript code standards enforced across all skills. Loaded by other skills, not invoked directly.
development
TypeScript ADR conventions enforced across architect and auditor skills. Loaded by other skills, not invoked directly.