# nan-paper-polish

nan-paper-polish refines academic manuscripts and theses in LaTeX while safeguarding equations, citations, terminology, and core claims.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/paper-writing/nan-paper-polish/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/nan-paper-polish

## What it does

This skill conducts academic manuscript editing through a six-layer diagnostic workflow. It focuses strictly on verified prose and structural defects rather than introducing arbitrary stylistic variants. Original documents remain untouched unless an overwrite is requested; clean LaTeX output appears directly in the conversation alongside the original excerpt and a clear rationale for every substantive revision.

Evaluation runs across isolated passes: rhetoric, cohesion across paragraphs, clarity, consistency, and epistemic claims such as hedging strength. For complex papers, it can split tasks among distinct auditor roles before a single composer applies the merged adjustments. Crucially, math environments, numeric findings, variable declarations, and citation keys are protected throughout the run.

PDF uploads are handled strictly as read-only material. If you submit a PDF, the skill generates replacement snippets or a section outline instead of an intact layout, making raw LaTeX necessary for complete document revisions.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill nan-paper-polish -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/nan-paper-polish/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/nan-paper-polish/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill nan-paper-polish -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/nan-paper-polish/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill nan-paper-polish -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/nan-paper-polish/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills paper-writing/nan-paper-polish/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/nan-paper-polish/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill nan-paper-polish -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path paper-writing/nan-paper-polish
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/nan-paper-polish/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/paper-writing/nan-paper-polish/SKILL.md

## When to use it
- eliminate phrasing weaknesses without distorting mathematical formulas
- calibrate epistemic hedging and scope in academic claims
- audit manuscript coherence across sections and paragraphs
- generate tracked changes with concrete reasons in LaTeX syntax

## Example prompts
- $nan-paper-polish review and polish the discussion section in manuscript.tex
- Run nan-paper-polish on chapter2.tex and detail every substantive change
- $nan-paper-polish audit epistemic strength and flow in our introduction

## Similar
- [paper-polish](https://affpapa.org/en/nevibecode/skills/paper-polish.md) — skill · 727 installs
- [academic-paper](https://affpapa.org/en/nevibecode/skills/academic-paper.md) — skill · 11600 installs
- [nature-polishing](https://affpapa.org/en/nevibecode/skills/yuan1z-skill-rebuilt-from-cour-nature-polishing.md) — skill · 337 installs
- [ccf-paper-to-exemplar](https://affpapa.org/en/nevibecode/skills/ccf-paper-to-exemplar.md) — skill · 2200 installs
- [research-paper-writing](https://affpapa.org/en/nevibecode/skills/research-paper-writing.md) — skill · 1900 installs
- [pre-submission-reviewer](https://affpapa.org/en/nevibecode/skills/pre-submission-reviewer.md) — skill · 931 installs

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
