跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
文档处理

orx-paper

Draft an academic paper or preprint as LaTeX. Create a .tex file in the project working tree, where it renders for the user and compiles to PDF. Use for a paper, preprint, manuscript, arXiv or submission draft, or a section of one; generic reports and result summaries belong to `orx-reports`.

alphaXiv · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add alphaXiv/OpenResearch --skill orx-paper

技能说明


name: orx-paper description: "Draft an academic paper or preprint as LaTeX. Create a .tex file in the project working tree, where it renders for the user and compiles to PDF. Use for a paper, preprint, manuscript, arXiv or submission draft, or a section of one; generic reports and result summaries belong to orx-reports."

Write the paper as a real .tex file in the working tree. Do not answer a paper request with an outline in chat, and keep the .tex out of the artifacts directory: a .tex is compiled where it sits in the live checkout, and the PDF is written beside it.

Create the file on the first request

Create paper.tex at the repo root (<topic>.tex when several papers coexist), write real content into it, then link it in chat using the session playbook's evidence-and-links contract so the user can open the rendered document. An outline in chat gives them nothing to render.

To add a reusable template to OpenResearch, load orx-customize.

Check for a template before writing a preamble

The user may have uploaded their own LaTeX template — a conference class, a lab preprint style. Look before you write anything:

ls .orx/latex-templates/
  • Exactly one template — use it. Do not ask; it is there to be used.
  • Several — name them and ask which, unless the request already said.
  • None — use the preamble below.

To use one, copy its class and style files next to your .tex so the compiler finds them, and start from its entry .tex rather than the default preamble:

cp .orx/latex-templates/<name>/*.cls .orx/latex-templates/<name>/*.sty \
   .orx/latex-templates/<name>/*.bst .
cp .orx/latex-templates/<name>/<entry>.tex paper.tex

Then fill in the template's own structure — keep its \documentclass line, its package list, and its section skeleton, and replace only the placeholder content. A conference class encodes margins, fonts, and an anonymization mode that the submission is checked against; overriding it defeats the point of uploading it. If the template needs a package the machine lacks, say so rather than quietly switching to the default preamble.

A preamble that compiles

When there is no template, start from this. It covers everything the sections below use:

\documentclass[11pt]{article}
\usepackage[margin=1in]{geometry}
\usepackage{amsmath,amssymb,amsthm}
\usepackage{graphicx}
\usepackage{booktabs}
\usepackage{listings}
\usepackage{natbib}
\usepackage[hidelinks]{hyperref}
\newtheorem{theorem}{Theorem}
\newtheorem{lemma}[theorem]{Lemma}

\title{...}
\author{...}
\date{\today}

\begin{document}
\maketitle
...
\end{document}

Every environment needs the package that defines it. This is the most common way a draft fails to compile, and the failure is fatal, not cosmetic:

UsingRequires
theorem, lemma, proofamsthm and a \newtheorem for each
lstlistinglistings
align, equation*, \textamsmath
\toprule, \midrulebooktabs
\includegraphicsgraphicx
\url, \hrefhyperref
\citet, \citepnatbib (plain \cite needs nothing)

Load only packages you use, and never invent a macro without defining it.

Say so when the document needs a different engine

Papers compile with pdfLaTeX by default. A document that needs XeLaTeX or LuaLaTeX — fontspec, unicode-math, a system OpenType font — must say so on its first line, or it will be built with the wrong engine and fail:

% !TeX program = lualatex

Do not add the line otherwise: pdfLaTeX is the most widely supported engine, and microtype's letter tracking works only there.

Structure

\begin{abstract}, then \section/\subsection. Number equations you refer to (\begin{equation}\label{eq:loss}) and cite them with \eqref{eq:loss}; use the starred form for equations you never reference. Label every float and refer to it as Table~\ref{tab:main}, never as "the table below" — a float moves.

Figures and tables

Read the orx-figures module before making a figure. A default matplotlib plot dropped into a paper is a defect a reviewer will name: wrong physical size, titled where the caption belongs, and rasterized where the document wants vector. That module also covers method diagrams in TikZ, which compile in this tree exactly like the paper does.

Reference image files that actually exist in the tree, by path relative to the .tex:

\includegraphics[width=\linewidth]{figs/loss_curve.pdf}

Write the extension out, and confirm the file exists before referencing it — a missing graphic fails the build.

Bibliography

Use an inline thebibliography block:

\begin{thebibliography}{9}
\bibitem[Kaplan et al.(2020)]{kaplan2020} Kaplan et al. Scaling laws for
  neural language models. 2020.
\end{thebibliography}

It compiles in one pass. A \bibliography{refs} with a separate .bib needs a biber round trip and shows as an unresolved reference until then.

The [Author(Year)] label is what \citet prints; without it natbib has no name to use. Give every entry one — for a paper whose authors you do not know, use a short title rather than inventing names.

Pick the citation command by how the sentence reads:

  • \citet{kaplan2020} — the citation is the subject: Kaplan et al. (2020) show…
  • \citep{kaplan2020} — a parenthetical aside: …is predictable (Kaplan et al., 2020)
  • Plain \cite under natbib behaves like \citet, so GRPO~\cite{x} comes out as GRPO Shao et al. (2024), with no parentheses. Write \citep for an aside.

Find real references with the orx-lit-review workflow: retrieve candidates with orx discover, then read selected sources with orx paper. A fabricated citation is worse than no citation.

Results come from runs, not from memory

Every number in a results table must come from an actual run — read it with orx logs (see the orx-evidence skill). Never write a placeho

阅读完整来源 ↗