vr-write-paper

name	vr-write-paper
description	Writes an academic paper based on experiment results and figures. Generates a publication-ready paper in LaTeX format.
user-invocable	true
argument-hint	["experiment-directory or paper-directory"]

Write Paper

Writes an academic paper based on experiment results and figures.

Input

$ARGUMENTS - Experiment directory or paper directory path

Process

Step 1: Gather Materials

Read the following files to identify the information needed for paper writing:

• Brainstorming results (brainstorm_*.md)
• Experiment plan (plan.md)
• Experiment settings (config.yaml)
• Result data (results/*.json)
• Figure descriptions (figures/figure_descriptions.md)
• Figure file list (figures/*.pdf)

Step 2: Design Paper Structure

Follow the standard academic paper structure:

1. Title & Abstract
2. Introduction - Motivation, problem definition, contributions
3. Related Work - Survey of related research
4. Method - Detailed description of the proposed method
5. Experimental Setup - Experimental environment, data, metrics
6. Results - Experimental results, analysis
7. Discussion - Interpretation of results, limitations
8. Conclusion - Summary, future work

Step 3: Write the Paper

Write each section.

Related Work Search

Read .claude/skills/_shared/paper-search-protocol.md and execute a Level 2 search focused on: "methods, benchmarks, and prior approaches most relevant to [paper's contribution]". Generate BibTeX entries and merge into references.bib. Use the per-paper analysis to write a structured Related Work narrative.

Paper Writing Principles:

• Write in clear and concise academic English
• Use an appropriate mix of passive and active voice
• Each paragraph should convey one core idea
• Always provide evidence (data, prior work) for claims
• Actively reference graphs and tables (\cref, \cite)
• Spell out abbreviations on first use

LaTeX Writing Rules:

• Use conference/journal templates (default: NeurIPS style)
• Separate files by section (sections/*.tex)
• Insert figures with \includegraphics
• Use the booktabs package for tables
• Use BibTeX for references

Step 4: Write the Abstract

Summarize the core of the paper in 150-250 words:

• Problem definition (1-2 sentences)
• Method summary (2-3 sentences)
• Key results (2-3 sentences)
• Significance (1 sentence)

Step 5: Review and Revise

• Check logical flow
• Review consistency (terminology, notation)
• Verify figure/table reference accuracy
• Check grammar and spelling

Output

File Structure

papers/paper_YYYYMMDD_<title>/
├── main.tex                # Main paper file
├── references.bib          # References
├── sections/
│   ├── abstract.tex
│   ├── introduction.tex
│   ├── related_work.tex
│   ├── method.tex
│   ├── experiments.tex
│   ├── results.tex
│   ├── discussion.tex
│   └── conclusion.tex
├── figures/                # Figure files (copied or symlinked)
└── Makefile                # Build automation

main.tex Basic Structure

\documentclass{article}
% Conference style packages

\title{[Paper Title]}
\author{[Authors]}

\begin{document}
\maketitle

\input{sections/abstract}
\input{sections/introduction}
\input{sections/related_work}
\input{sections/method}
\input{sections/experiments}
\input{sections/results}
\input{sections/discussion}
\input{sections/conclusion}

\bibliographystyle{plain}
\bibliography{references}

\end{document}

Notes

• Confirm the target conference/journal with the user to use the appropriate template
• The Related Work Search step uses the shared paper search protocol for structured discovery
• After completing the first draft, get user review and make revisions
• Be honest about limitations in the Limitation and Future Work sections
• After completing the first draft, run /vr-peer-review <paper-dir> for self-review