# paper-writer

A skill that writes paper prose from the author's own notes, results and drafts, for a paragraph or a whole manuscript. Every claim has to trace to a source.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 500 installs · ★ 10652
- Author: HKUSTDial
- License: CC-BY-NC-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HKUSTDial/Supervisor-Skills/tree/HEAD/skills/paper-writer/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/paper-writer

## What it does

You bring the ideas, the study design and the results. The skill brings the English, whether the work is experimental or textual, and whether you want one paragraph or a finished draft.

The workflow runs in six phases, opening with scoping, an evidence inventory and a plan of the sections before a single sentence is written. A claim without a source gets searched for, reworded or cut. Bracketed placeholder tags never survive into the output, and a statement is never allowed to be stronger than its evidence. Finished results and expected results get different wording, so they cannot blur together.

Citation checks are handed to sub-agents with a fresh context. Where the environment has no scholarly search tool and no shell access to public indexes, the skill cites only your own references and says so in the delivery note. Introductions are passed to `intro-drafter`, language polishing to `paper-polish`. The licence is CC-BY-NC-SA-4.0, so commercial use is ruled out.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill paper-writer -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill paper-writer -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill paper-writer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install HKUSTDial/Supervisor-Skills paper-writer
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill paper-writer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/HKUSTDial/Supervisor-Skills --path skills/paper-writer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add HKUSTDial/Supervisor-Skills --skill paper-writer -a opencode
```

### 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/HKUSTDial/Supervisor-Skills/tree/HEAD/skills/paper-writer/SKILL.md

## When to use it
- turn rough notes into a Methods section
- draft an abstract from finished results
- write an introduction paragraph from a half-formed idea
- produce a complete first draft of a paper
- check that each claim in the text has a citable source

## Example prompts
- Take `results.md` and write the Methods section from it, numbers included.
- Draft the Discussion in the style this venue expects.
- Give me a full first draft of the paper from these notes and tables.

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

From the same set: [hkustdial/supervisor-skills](https://affpapa.org/en/nevibecode/by/hkustdial/supervisor-skills.md) — 12 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