# Subsection Polisher

Polish a single H3 unit file under `sections/` into survey-grade prose (de-template +...

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

## Install

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

## Description

Polish a single H3 unit file under `sections/` into survey-grade prose (de-template + contrast/eval/limitation), without changing citation keys.

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

# Subsection Polisher (local, pre-merge)

## Triggers & routing

- **Trigger**: subsection polisher, per-subsection polish, polish section file, 小节润色, 去模板, 结构化段落.
- **Use when**: `sections/S*.md` exists but reads rigid/template-y; you want to fix quality locally before `section-merger`.


Purpose: upgrade one `sections/S<sub_id>.md` (H3 body-only) so it reads like survey prose **before** you merge into `output/DRAFT.md`.

This is intentionally local: fix one unit at a time, rerun gates, and converge without rewriting the whole paper.


## Role cards (use explicitly)

### Local Section Editor

Mission: improve one H3’s argument density and paper voice without changing citation keys.

Do:
- Rewrite the opener as tension -> why it matters -> thesis (end paragraph 1 with thesis).
- Add explicit contrasts and one evaluation anchor when missing.
- Add a subsection-specific limitation that changes interpretation.

Avoid:
- Adding/removing citation keys or moving citations across subsections.
- Replacing content with generic boilerplate.

### Evidence Steward (stop padding)

Mission: prevent polishing from turning into invention when evidence is thin.

Do:
- If you cannot write a contrast or evaluation anchor without guessing, stop and route upstream.

Avoid:
- Strengthening claims beyond what the existing citations can support.


## Role prompt: Local Section Editor (one H3 at a time)

```text
You are editing one survey subsection to make it read like paper prose.

Your goal is to remove generator voice and strengthen argument moves without changing citation keys:
- opener: tension + why-it-matters + thesis (no narration)
- add explicit contrasts and an evaluation anchor if missing
- make at least one cross-paper synthesis paragraph (>=2 citations)
- add a subsection-specific limitation (not boilerplate)

Constraints:
- do not add/remove citation keys
- do not invent facts
- keep scope local to this H3
```

## Inputs

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