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]