Agent skill
ai-paper-writing
Best practices for writing AI research papers. Use when the project involves writing a research paper in AI field.
Install this agent skill to your Project
npx add-skill https://github.com/ParkJumyung/skills/tree/main/ai-paper-writing
SKILL.md
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)
- Compress to claims
- Motivation & impact
- Novelty & positioning
- Evidence & red-teaming
- Paper structure overview
- Abstract
- Introduction
- Figures
- Main body layering
- Discussion & limitations
- Related work
B) Reviewing a draft
- Compress to claims (extract what the paper actually claims)
- Evidence & red-teaming
- Avoid misleading evidence
- Abstract
- Introduction
- Common pitfalls
C) Strengthening experiments
- Experiments design
- Baselines + ablations
- Avoid misleading evidence
- Evidence & red-teaming
D) Tightening narrative + clarity
- Compress to claims
- Motivation & impact
- Abstract
- Introduction
- Definitions & layering
Templates
- Abstract template
- Intro template
- Paper outline template
- Evidence audit template
- Figure caption template
Modules index
- 00 Overview
- 01 Compress to claims
- 02 Motivation & impact
- 03 Novelty & positioning
- 04 Evidence & red-teaming
- 05 Experiments design
- 06 Avoid misleading evidence
- 07 Structure: Abstract
- 08 Structure: Introduction
- 09 Figures
- 10 Main body
- 11 Related work
- 12 Discussion & limitations
- 13 Writing process
- 14 Common pitfalls
- 15 Checklists
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]
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ai-research
Systematic AI research process. Use when the user is AI researcher and the project is involved in AI research project.
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
Didn't find tool you were looking for?