| name | writing-enhancements |
| description | Review a piece of writing and identify specific opportunities to make individual sentences more memorable using classical figures of rhetoric (polyptoton, chiasmus, isocolon, tricolon, anaphora, epistrophe, synaesthesia, personification, verbless sentences, paradox, pun, hyperbole/adynaton). Use when the user asks to enhance, punch up, or make writing more memorable, eloquent, or enchanting — or invokes /writing-enhancements on a draft. |
Writing Enhancements
Given a piece of writing, find the sentences that could be memorable and show how to make them so — using the figures of rhetoric catalogued in references/figures.md.
Scope discipline: every suggestion must come from that catalogue. Do not invent other advice — no "tighten this," no "cut the adverb," no structural notes, no grammar fixes. This skill does one thing: rephrase single sentences into more memorable versions using the figures. If nothing in the catalogue applies to a passage, leave the passage alone.
The premise
You are not adding new content. The figures of rhetoric are ways of rephrasing a single sentence so it sticks in the reader's mind. The meaning stays; the shape changes.
The goal is not efficiency. Efficient writing is Soylent — technically complete, missing the point. We decorate our houses, cook our food, choose our clothes; there is no reason writing alone must be plain. Write to enchant.
Workflow
1. Read the piece and set the register
Before suggesting anything, judge how far the writing can go:
- Go big — poems, scripts, speeches, essays, novels, titles, taglines, love letters, personal writing. Reach for the whole catalogue.
- Tone it down — quarterly reports, technical docs, API references, incident write-ups. Restrict yourself to the quiet figures (isocolon, tricolon, verbless sentences, light polyptoton) and suggest fewer of them.
State the register you've judged in one line before the suggestions, so the user can correct you.
2. Find the load-bearing sentences
Not every sentence should be enhanced. Look hardest at the places that carry weight:
- The title. Polyptoton and verbless sentences are extraordinarily rich here — you get a lot into three or four words. Walk the Walk. Stranger in a Strange Land. Bleak House.
- The opening line. London. / Space, the final frontier.
- The closing line.
- Section and chapter transitions — the last line before a break should lean towards what comes next and leave the reader wanting more.
- The one claim you most want remembered — the thesis, the punchline, the call to action.
- Any list of three, or any sentence already near-symmetrical — it is halfway to a tricolon or a chiasmus and just needs the last turn.
- Any description of smell, taste, touch, or sound — these are where writing goes flat, and where synaesthesia does its best work.
- Any abstraction (jealousy, time, death, the market, the deadline) — a candidate for personification.
3. For each opportunity, work the catalogue
Read references/figures.md and try the figures against the sentence. Several will fail; that's expected. A useful method for each candidate:
- Is a word here repeatable in another form? → polyptoton
- Are two ideas being set against each other? → chiasmus (symmetrical) or isocolon (equal weight)
- Are there two items that want a third? → tricolon, with the twist and the extra syllable at the end
- Do successive sentences share a beginning or an ending? → anaphora / epistrophe
- Is a sense being described in its own terms? → synaesthesia
- Is there an abstraction standing around undressed? → personification
- Does the sentence need to land like a fist on a table? → drop the main verb
- Is this a sensible observation? → can it be phrased so it seems, for one moment, not to make sense? → paradox
- Does a key word have a second meaning? → pun
- Is the claim an overstatement already? → push it to the impossible → hyperbole / adynaton
Then read your rewrite aloud, under your breath, tapping the beat. English has a rhythm; if the rewrite stumbles, the figure isn't earning its place. See "Rhythm" in the reference.
4. Report
Give a short list of concrete, sentence-level opportunities. For each:
**[Figure name]** — <section / paragraph reference>
Original: <the sentence exactly as written>
Suggested: <the rewrite>
Why: <one or two sentences — what the figure does to the reader here>
Where a sentence supports more than one treatment, offer the alternatives — figures mix freely (the first shall be last and the last shall be first is paradox and chiasmus at once).
Order the list by payoff, not by position in the document: title and opening line first, then the thesis sentence, then the rest.
Close with a one-line note on dosage — see below.
5. Dosage
Figures are chili flakes. The first few are always good; there is a point where you have used too many and now you are ill. Where that point falls is a question of judgment, but a few per paragraph will already put the writing far ahead of how most people write. If you have found more opportunities than that, say so and mark which you'd actually use.
Signs of too much: every sentence turning symmetrical, three-part lists arriving in convoy, paradox used where a plain statement would do. Paradox in particular is not easy and should not be overused.
Rules
- Suggest, don't rewrite. Identify opportunities and show the rewrite for each. Only rewrite the whole piece if the user asks.
- Quote the original exactly so the user can find it.
- Preserve the meaning. A figure that changes what the sentence claims is a bad suggestion, not a bold one.
- Name the figure every time. The Greek names are unpronounceable and don't matter — but naming the tool teaches it.
- Don't strain. Forcing a chiasmus onto a sentence that doesn't want one produces something worse than the original. When nothing fits, say nothing.
- Say when the form can mirror the meaning. Yesterday begins and ends each verse on the same word because the song is about being stuck. If a passage is about circularity, repetition, escalation, or entrapment, the figure can enact it rather than just decorate it — flag those; they're the best suggestions you'll make.
- Nothing outside the catalogue. No general writing advice, no line edits, no notes on clarity or structure.
Reference
references/figures.md — the full catalogue: each figure, how it works, when to use it, why it works, with examples.
