Skills

Subsection Polisher

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

Install

npx skills add WILLOSCAR/research-units-pipeline-skills --skill subsection-polisher -g -a claude-code -y
Category
Engineering
Updated
1mo ago
License
See repository
Context cost
Mediumabout 2,282 tokens
Runs scripts
No, instructions only

What it does

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

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)

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

Read the whole SKILL.md on GitHub

More in Engineering