Prose polish
Skill charlieviettq/awesome-agent-skill/.cursor/skills/writing-docs/prose-polish
Polish technical and stakeholder prose—clarity, tone, structure, and reducing generic AI-writing patterns. Use for blog posts, knowledge-base pages, READMEs, exec summaries, and user-facing copy before publish. Triggers: "edit prose", "polish writing", "sounds like AI", "copy edit", "tone".From its SKILL.md
npx -y skills add charlieviettq/awesome-agent-skill --skill prose-polishAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 22 stars22 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.7 KB, 322 tokens by cl100k_base, as published. Nobody here has run it
Prose polish
Goals
- Clear, specific, appropriate for audience (engineer vs exec vs end user).
- Active voice where it helps scanning.
- No false certainty; claims tied to evidence when factual.
Pass order
- Structure — thesis upfront; one idea per paragraph; headings match content.
- Clarity — cut filler; replace vague words (leverage, robust, delve) with specifics.
- Accuracy — numbers, dates, product names; avoid invented citations.
- Tone — match org style; professional without hype.
- Final read — read aloud for rhythm and redundancy.
AI-writing patterns to remove
| Pattern | Fix |
|---|---|
| Empty opener ("In today's world...") | Start with the point |
| Hedging stack | One clear qualification |
| Buzzword salad | Name the mechanism or metric |
| List for everything | Prose when narrative helps |
| Fake symmetry | Keep only real trade-offs |
Technical docs
- Lead with outcome and constraints.
- Use tables for comparisons; prose for narrative decisions.
- Callouts for warnings; link ADR or ticket for decisions.
Bilingual (VI/EN) note
When both languages appear: keep terminology consistent; do not mix languages mid-sentence without reason.
Output
Return edited text or a short change log (structure, clarity, tone) if user prefers diff-style feedback.
Related
pptx for slide decks; docx for Word deliverables.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.