Skip to content
Back to search

latex-arxiv-SKILL

A highly customizable agentic harness for arXiv-ready ML/AI review papers (and beyond). It drives agentic AI like Codex CLI and Claude Code through a gated LaTeX workflow with verified BibTeX citations.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/appautomaton--latex-arxiv-skill/badge.svg)](/listings/appautomaton--latex-arxiv-skill)

HTML

<a href="/listings/appautomaton--latex-arxiv-skill"><img src="/api/listings/appautomaton--latex-arxiv-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The [`example/v0-single-SKILL`](example/v0-single-SKILL/) paper was generated by activating the `arxiv-paper-writer` skill with **two prompts**.

**Prompt 1 (start the paper):**

write a review article for arxiv that is about SOTA generative image models

The agent does an initial literature pass, drafts a section framework, proposes candidate titles, and writes a `plan/<timestamp>-<slug>.md` with clarification questions.

> [!TIP] > Open the generated `plan/` file and answer the clarification questions to steer scope, title, and coverage.

**Prompt 2 (delegate the decisions and proceed):**

I will let you choose the best title and the topics and inclusion of material that you see the best fit

This second prompt is intentionally vague, and the plan questions were ignored. The harness still makes best-effort choices and produces a complete, compiling LaTeX project. See [`main.tex`](example/v0-single-SKILL/main.tex), [`ref.bib`](example/v0-single-SKILL/ref.bib), and [`main.pdf`](example/v0-single-SKILL/main.pdf).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 114 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # arXiv Review Paper Harness
  2. [![CI](https://github.com/appautomaton/latex-arxiv-SKILL/actions/workflows/ci.yml/badge.svg)](https://github.com/appautomaton/latex-arxiv-SKILL/actions/workflows/ci.yml)
  3. [![GitHub stars](https://img.shields.io/github/stars/appautomaton/latex-arxiv-SKILL?style=flat&color=f5b400&logo=github)](https://github.com/appautomaton/latex-arxiv-SKILL/stargazers)
  4. [![Claude Code](https://img.shields.io/badge/Claude_Code-compatible-D97757?logo=anthropic&logoColor=white)](https://www.anthropic.com/claude-code)
  5. [![OpenAI Codex](https://img.shields.io/badge/OpenAI_Codex-compatible-412991?logo=openai&logoColor=white)](https://developers.openai.com/codex/skills)
  6. [![Agent Skill](https://img.shields.io/badge/Agent_Skill-portable-6E56CF)](agent-skills-standard.md)
  7. [![LaTeX](https://img.shields.io/badge/LaTeX-IEEEtran-008080?logo=latex&logoColor=white)](#requirements)
  8. [![License: MIT](https://img.shields.io/badge/License-MIT-3da639.svg)](LICENSE)
  9. > **An agentic harness, packaged as a portable Agent Skill for Claude Code and Codex. It turns a topic into an arXiv-ready ML/AI review paper that is gated, issue-driven, and verified citation by citation.**
  10. **arXiv Review Paper Harness** is an agentic harness for writing machine-learning and AI **review papers** in LaTeX. You give your coding agent a topic, and the harness drives it through a disciplined pipeline: literature discovery, a human approval gate, an issue-by-issue writing loop, citation verification, prose refinement, and compilation. The result is a two-column **IEEEtran** project that compiles to a PDF. Its skills and scripts follow the portable [Agent Skills standard](agent-skills-standard.md), so the same files run in **OpenAI Codex** and **Anthropic Claude Code**.
  11. ---
  12. ## How it works
  13. ```mermaid
  14. flowchart TD
  15. A([Topic]) --> B[Research snapshot<br/>10 to 20 papers, no prose]
  16. B --> C[Scaffold IEEEtran project<br/>plus draft plan and candidate titles]
  17. C --> D{Approval gate}
  18. D -- revise --> C
  19. D -- approved --> E[Issues CSV<br/><i>execution contract</i>]
  20. E --> F[Per-issue writing loop<br/>research, write, <b>verify every citation</b>]
  21. F --> G[Rhythm refinement<br/>vary sentence and paragraph length]
  22. G --> H[QA and compile<br/>fix overfull boxes, zero undefined cites]
  23. H --> I([main.pdf and ref.bib])
  24. style D fill:#f5b400,stroke:#333,color:#000
  25. style I fill:#3da639,stroke:#333,color:#fff
  26. ```
  27. The agent cannot write a single paragraph into `main.tex` until two conditions hold. First, you approve the plan. Second, the issues CSV exists. From there, every section is a tracked issue with target citations and acceptance criteria, and every citation is checked against a live source before it enters `ref.bib`.
  28. ## Why it's different
  29. - **Hard quality gates, not vibes:** no prose before plan approval, and nothing marked `DONE` until acceptance criteria are met.
  30. - **Verified citations only:** every `\cite{}` is web-checked against its source before being added, so there are no hallucinated references.
  31. - **Issue-driven execution:** an `issues/*.csv` file is the single source of truth for progress, and the agent splits or inserts issues as scope grows instead of doing untracked work.
  32. - **Deterministic where it matters:** scaffolding, plan and issue generation, arXiv discovery (with a local **SQLite cache**), validation, and compilation are Python scripts, so they behave the same on every run.
  33. - **Dual-runtime:** one skill bundle that runs in both Claude Code and Codex.
  34. - **Compiles or it is not done:** delivery requires a clean `pdflatex` and `bibtex` build with no undefined-citation warnings.
  35. ## Quickstart
  36. The [`example/v0-single-SKILL`](example/v0-single-SKILL/) paper was generated by activating the `arxiv-paper-writer` skill with **two prompts**.
  37. **Prompt 1 (start the paper):**
  38. ```text
  39. write a review article for arxiv that is about SOTA generative image models
  40. ```
  41. The agent does an initial literature pass, drafts a section framework, proposes candidate titles, and writes a `plan/<timestamp>-<slug>.md` with clarification questions.
  42. > [!TIP]
  43. > Open the generated `plan/` file and answer the clarification questions to steer scope, title, and coverage.
  44. **Prompt 2 (delegate the decisions and proceed):**
  45. ```text
  46. I will let you choose the best title and the topics and inclusion of material that you see the best fit
  47. ```
  48. This second prompt is intentionally vague, and the plan questions were ignored. The harness still makes best-effort choices and produces a complete, compiling LaTeX project. See [`main.tex`](example/v0-single-SKILL/main.tex), [`ref.bib`](example/v0-single-SKILL/ref.bib), and [`main.pdf`](example/v0-single-SKILL/main.pdf).
  49. ## What's in the box
  50. | Component | What it is |
  51. |-----------|-----------|
  52. | [`arxiv-paper-writer`](.codex/skills/arxiv-paper-writer/SKILL.md) | **The primary harness.** The gated workflow, guardrails, and success criteria. |
  53. | `scripts/` | Deterministic Python helpers: scaffolding, plan and issue generation, CSV validation, LaTeX compile, and `arxiv_registry.py` (arXiv Atom-API discovery and BibTeX with a local SQLite cache). |
  54. | [`latex-rhythm-refiner`](.codex/skills/latex-rhythm-refiner/SKILL.md) | Post-processes prose for readable sentence and paragraph rhythm while preserving every citation. |
  55. | [`collaborating-with-claude`](.codex/skills/collaborating-with-claude/SKILL.md) · [`-gemini`](.codex/skills/collaborating-with-gemini/SKILL.md) | Bridges to delegate sub-tasks or get a second opinion from another model. |
  56. | [`agent-skills-standard.md`](agent-skills-standard.md) | The repo's spec for authoring portable `SKILL.md` bundles across Codex and Claude Code. |
  57. | [`example/`](example/) | Two fully generated papers, with plans, issue CSVs, sources, and compiled PDFs. |
  58. ## Examples
  59. | Paper | Citations | Notes |
  60. |-------|-----------|-------|
  61. | [v0: Generative image models review](example/v0-single-SKILL/) | 55 verified | Single-skill run, the 2-prompt quickstart above. |
  62. | [v0.5: Video world simulators (3D/4D) review](example/v0.5-sqlite-multi-SKILLs/video-world-simulators-3d4d-review/) | 81 verified | Multi-skill run with the SQLite arXiv registry and BibTeX cache. |
  63. ## Requirements
  64. > [!IMPORTANT]
  65. > A working LaTeX environment is required: `pdflatex` and `bibtex`, or `latexmk`.
  66. - **Agent runtime:** OpenAI Codex or Anthropic Claude Code, with skills enabled.
  67. - **Python 3.8+** for the helper scripts.
  68. - **Web search and browsing** for citation verification.
  69. - Tested on macOS with GPT-5.2 (Extra High).
  70. ## FAQ
  71. **How does it prevent hallucinated or invented citations?**
  72. Guardrails, built into the workflow. Every citation is verified against a live source before it enters `ref.bib`, and any claim without evidence becomes a TODO rather than a fabricated reference.
  73. **Can I use it on an existing LaTeX project?**
  74. Yes. Point it at your project and a citation-validation pass audits and repairs `ref.bib` without re-scaffolding anything.
  75. **Can it write original or experimental research papers, not just reviews?**
  76. Yes, with a little tailoring. Review and survey articles are its sweet spot out of the box, but nothing locks it there. Shape the plan and inputs to your goal, and the same gated workflow extends to original or experimental work.
  77. ## Credits
  78. The issue-driven workflow is inspired by "issue-driven development" as demonstrated by [`appautomaton/agent-designer`](https://github.com/appautomaton/agent-designer).
  79. ## License
  80. [MIT](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.