mcpbeat

Research Paper Writing

hezaohezao/research-paper-writing

ML paper pipeline: experiment design to submission.

1k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
117
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/HezaoHezao/poirot --skill research-paper-writing

The instruction itself

15 sections, as written by the author

Research Paper Writing Pipeline

Overview

End-to-end pipeline for producing publication-ready ML/AI research papers

targeting NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Covers the full research

lifecycle: experiment design, execution, analysis, paper writing, review,

revision, and submission.

This is not a linear pipeline — it is an iterative loop. Results trigger

new experiments. Reviews trigger new analysis.

When to Use

  • User is writing an ML/AI research paper for a top venue
  • User needs help with experiment design, execution, or analysis
  • User wants feedback on a draft
  • User is preparing a submission package

Pipeline Phases

Phase 0: Project Setup → Phase 1: Literature Review
       │                        │
       ▼                        ▼
Phase 2: Experiment      Phase 5: Paper Drafting ◄──┐
       Design                  │                    │
       │                       ▼                    │
       ▼                 Phase 6: Self-Review       │
Phase 3: Execution            & Revision ───────────┘
       & Monitoring              │
       │                         ▼
       ▼                   Phase 7: Submission
Phase 4: Analysis

Phase 0: Project Setup

  • Define research question and hypothesis
  • Identify target venue + deadline
  • Set up project structure:
  project/
  ├── experiments/
  ├── data/
  ├── src/
  ├── paper/
  │   ├── main.tex
  │   ├── figures/
  │   └── references.bib
  └── README.md
  • Initialize git repo, set up environment

Phase 1: Literature Review

  • Use arxiv skill to find related work
  • Use web_search for non-arXiv papers (Semantic Scholar, Google Scholar)
  • Use browse_page to read key papers in full
  • Build a references.bib with all cited works
  • Identify the gap your work fills

Phase 2: Experiment Design

  • Define baselines and comparison methods
  • Choose datasets and evaluation metrics
  • Design ablation studies
  • Plan computational budget
  • Write pre-registration document (optional but recommended)

Phase 3: Execution & Monitoring

# Run experiments
python src/train.py --config configs/exp1.yaml

# Monitor with logging
python src/train.py --config configs/exp1.yaml --log-dir runs/exp1

# Track experiments
python src/eval.py --checkpoint runs/exp1/best.pt --eval-set test
  • Log all hyperparameters, seeds, and environment details
  • Save checkpoints for reproducibility
  • Run each experiment with multiple seeds (3-5)

Phase 4: Analysis

  • Aggregate results across seeds
  • Compute statistical significance (paired t-test, bootstrap CI)
  • Generate comparison tables and plots:
  python src/plot.py --results runs/ --output paper/figures/
  • Run ablation analysis
  • Identify surprising findings (investigate, don't hide)

Phase 5: Paper Drafting

Follow venue template structure:

  • Abstract — problem, method, key result, impact (write last)
  • Introduction — motivation, contribution summary, roadmap
  • Related Work — position within literature (from Phase 1)
  • Method — approach, architecture, training procedure
  • Experiments — setup, main results, ablations, analysis
  • Conclusion — summary, limitations, future work

Writing principles:

  • One idea per paragraph
  • Figures tell the story — design figures first, write text around them
  • Tables for comparisons — main results table + ablation table
  • Reproducibility — include all hyperparameters, release code

Phase 6: Self-Review & Revision

Use academic-paper-review skill to self-review:

  • Read the paper cold (fresh eyes)
  • Check methodology soundness, novelty, reproducibility
  • Identify weaknesses and fix them
  • Get feedback from collaborators

Phase 7: Submission

  • Check venue formatting requirements
  • Verify page limits
  • Anonymize for blind review (if applicable)
  • Prepare supplementary material (code, data, extended results)
  • Submit before deadline (not at 23:59)

Statistical Analysis

# Multiple seeds — compute mean ± std
python3 -c "
import numpy as np
results = [0.85, 0.83, 0.86, 0.84, 0.82]  # per-seed results
print(f'Mean: {np.mean(results):.4f} ± {np.std(results):.4f}')
"

# Paired t-test vs baseline
python3 -c "
from scipy import stats
baseline = [0.80, 0.79, 0.81, 0.78, 0.80]
ours = [0.85, 0.83, 0.86, 0.84, 0.82]
t, p = stats.ttest_rel(ours, baseline)
print(f't={t:.3f}, p={p:.4f}')
"

Pitfalls

  • Single seed: results from one seed are not reliable. Use 3-5 minimum.
  • Cherry-picking: report all results, not just the best seed.
  • No ablations: reviewers will ask "does each component matter?" — answer

proactively.

  • Missing related work: reviewers know the field. Cite comprehensively.
  • Unclear contributions: list contributions explicitly in the introduction.
  • Overclaiming: "state-of-the-art" needs evidence across datasets, not one.
  • Last-minute submission: servers crash at deadlines. Submit early.

Dependencies

This skill benefits from: numpy, scipy, matplotlib (analysis + plots).

Install via pip install numpy scipy matplotlib.

How to use it

Copy the folder

Take hezaohezao/research-paper-writing from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.

Install what it needs

The instructions reference pip. Without those the skill loads but fails at the first command.