# 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.

- Skill: `charlieviettq/prose-polish` (Agent Skill)
- Install (CLI): `npx skillmds@latest add charlieviettq/prose-polish`
- Raw SKILL.md: https://api.skillmd.com/api/skills/charlieviettq/prose-polish/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: charlieviettq (https://skillmd.com/u/charlieviettq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/charlieviettq/prose-polish

---


# 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

1. **Structure** — thesis upfront; one idea per paragraph; headings match content.
2. **Clarity** — cut filler; replace vague words (leverage, robust, delve) with specifics.
3. **Accuracy** — numbers, dates, product names; avoid invented citations.
4. **Tone** — match org style; professional without hype.
5. **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.