# Draft Polisher

Audit-style editing pass for `output/DRAFT.md`: remove template boilerplate, improve...

- Repository: https://github.com/WILLOSCAR/research-units-pipeline-skills (517 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-05
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add WILLOSCAR/research-units-pipeline-skills --skill draft-polisher -g -a claude-code -y`
Codex: `npx skills add WILLOSCAR/research-units-pipeline-skills --skill draft-polisher -g -a codex -y`
Cursor: `npx skills add WILLOSCAR/research-units-pipeline-skills --skill draft-polisher -g -a cursor -y`
Gemini CLI: `npx skills add WILLOSCAR/research-units-pipeline-skills --skill draft-polisher -g -a gemini-cli -y`

## Description

Audit-style editing pass for `output/DRAFT.md`: remove template boilerplate, improve coherence, and enforce citation anchoring.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Draft Polisher (Audit-style editing)

## Triggers & routing

- **Trigger**: polish draft, de-template, coherence pass, remove boilerplate, 润色, 去套话, 去重复, 统一术语.
- **Use when**: a first-pass draft exists but reads like scaffolding (repetition/ellipsis/template phrases) or needs a coherence pass before global review/LaTeX.


Goal: turn a first-pass draft into readable survey prose **without breaking the evidence contract**.

This is a local polish pass: de-template + coherence + terminology + redundancy pruning.

Note: if the main issue is structural redundancy from section accumulation, push the change upstream to `sections/` and use `paragraph-curator` before merge. `draft-polisher` should not be the primary place where you decide which paragraphs to keep.



## Role cards (use explicitly)

### Style Harmonizer (editor)

Mission: remove generator voice and make prose read like one author wrote it.

Do:
- Delete narration openers and slide navigation; replace with argument bridges.
- Vary rhythm; remove repeated template stems.
- Collapse repeated disclaimers into one front-matter methodology paragraph.

Avoid:
- Adding or removing citation keys.
- Moving citations across subsections.

### Evidence Contract Guard (skeptic)

Mission: prevent polishing from inflating claims beyond evidence.

Do:
- Keep quantitative statements scoped (task/metric/constraint) or weaken them.
- Treat missing evidence as a failure signal; route upstream rather than rewriting around gaps.

Avoid:
- Overconfident language when evidence is abstract-only.


## Role prompt: Style Harmonizer (editor expert)

```text
You are the style and coherence editor for a technical survey.

Your goal is to make the draft read like one careful author wrote it, without changing the evidence contract.

Hard constraints:
- do not add/remove citation keys
- do not move citations across ### subsections
- do not strengthen claims beyond what existing citations support

The rest: https://github.com/WILLOSCAR/research-units-pipeline-skills/blob/HEAD/.codex/skills/draft-polisher/SKILL.md