# AI Paper Writing

> Best practices for writing AI research papers. Use when the project involves writing a research paper in AI field.

- Skill: `jumyungpark/ai-paper-writing` (Agent Skill, multi-file: 25 files)
- Install (CLI): `npx skillmds@latest add jumyungpark/ai-paper-writing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jumyungpark/ai-paper-writing/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: jumyungpark (https://skillmd.com/u/jumyungpark)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jumyungpark/ai-paper-writing

---


# AI Paper Writing

A modular skill bundle distilled from “Highly Opinionated Advice on How to Write AI Papers” (Neel Nanda).  
The goal is to help you produce papers where readers **understand**, **remember**, and **believe** the narrative.

## North star

An ideal paper is a short, rigorous, evidence-based technical story with a takeaway the reader cares about:

- **What?** 1–3 concrete claims that contribute to knowledge
- **Why?** rigorous evidence that supports the claims
- **So what?** motivation + impact: why the reader should care

## How to use

Pick a workflow below, or jump straight to a module. Each module is independent.

### Common inputs

- Your paper text (or section)
- Or: a project summary + key results + experiments list

### Common outputs

- claim list (1–3 claims + scope + confidence level)
- evidence map (claim → experiments → risks)
- rewritten abstract/intro
- experiment fixes (baselines, ablations, stronger discriminators)
- figure + caption guidance
- limitations + discussion guidance

---

## Workflows

### A) Drafting from scratch (recommended order)

1. [Compress to claims](modules/01-compress-to-claims.md)
2. [Motivation & impact](modules/02-motivation-impact.md)
3. [Novelty & positioning](modules/03-novelty-positioning.md)
4. [Evidence & red-teaming](modules/04-evidence-redteaming.md)
5. [Paper structure overview](modules/00-overview.md)
6. [Abstract](modules/07-structure-abstract.md)
7. [Introduction](modules/08-structure-introduction.md)
8. [Figures](modules/09-figures.md)
9. [Main body layering](modules/10-main-body.md)
10. [Discussion & limitations](modules/12-discussion-limitations.md)
11. [Related work](modules/11-related-work.md)

### B) Reviewing a draft

1. [Compress to claims](modules/01-compress-to-claims.md) (extract what the paper _actually_ claims)
2. [Evidence & red-teaming](modules/04-evidence-redteaming.md)
3. [Avoid misleading evidence](modules/06-avoid-misleading.md)
4. [Abstract](modules/07-structure-abstract.md)
5. [Introduction](modules/08-structure-introduction.md)
6. [Common pitfalls](modules/14-common-pitfalls.md)

### C) Strengthening experiments

1. [Experiments design](modules/05-experiments-design.md)
2. [Baselines + ablations](modules/05-experiments-design.md#baselines--ablations)
3. [Avoid misleading evidence](modules/06-avoid-misleading.md)
4. [Evidence & red-teaming](modules/04-evidence-redteaming.md)

### D) Tightening narrative + clarity

1. [Compress to claims](modules/01-compress-to-claims.md)
2. [Motivation & impact](modules/02-motivation-impact.md)
3. [Abstract](modules/07-structure-abstract.md)
4. [Introduction](modules/08-structure-introduction.md)
5. [Definitions & layering](modules/10-main-body.md)

---

## Templates

- [Abstract template](templates/abstract-template.md)
- [Intro template](templates/intro-template.md)
- [Paper outline template](templates/paper-outline-template.md)
- [Evidence audit template](templates/evidence-audit-template.md)
- [Figure caption template](templates/figure-caption-template.md)

---

## Modules index

- [00 Overview](modules/00-overview.md)
- [01 Compress to claims](modules/01-compress-to-claims.md)
- [02 Motivation & impact](modules/02-motivation-impact.md)
- [03 Novelty & positioning](modules/03-novelty-positioning.md)
- [04 Evidence & red-teaming](modules/04-evidence-redteaming.md)
- [05 Experiments design](modules/05-experiments-design.md)
- [06 Avoid misleading evidence](modules/06-avoid-misleading.md)
- [07 Structure: Abstract](modules/07-structure-abstract.md)
- [08 Structure: Introduction](modules/08-structure-introduction.md)
- [09 Figures](modules/09-figures.md)
- [10 Main body](modules/10-main-body.md)
- [11 Related work](modules/11-related-work.md)
- [12 Discussion & limitations](modules/12-discussion-limitations.md)
- [13 Writing process](modules/13-writing-process.md)
- [14 Common pitfalls](modules/14-common-pitfalls.md)
- [15 Checklists](modules/15-checklists.md)

---

## Acknowledgements

This was compiled from Neel Nanda's article (Highly Opinionated Advice on How to Write AI Papers)[https://www.alignmentforum.org/s/5GT3yoYM9gRmMEKqL/p/eJGptPbbFPZGLpjsp]