gpd-write-paper

Structure and draft a physics paper from completed research artifacts and phase summaries.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-write-paper-michaelsengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpd-write-paper
Source: https://github.com/MichaelsEngineering/get-physics-done-test/tree/main/.agents/skills/gpd-write-paper
Command: npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-write-paper-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning completed physics research—derivations, numerical results, figures, and literature reviews—into a coherent, publication-ready paper is slow and error-prone. This Skill automates the full pipeline from research digest to polished LaTeX manuscript, enforcing narrative structure, notation consistency, and citation integrity. ## Core Features & Use Cases - Paper-readiness audit: Gates drafting on SUMMARY completeness, convention consistency, numerical stability, figure readiness, citation readiness, and decisive comparison coverage before any prose is written. - Wave-parallelized section drafting: Spawns paper-writer agents in dependency-ordered waves (Results+Methods, Introduction, Discussion, Conclusions, Abstract, Appendices) with LaTeX compilation checks after each wave. - Staged peer review and revision: Runs a specialist review panel (reader, literature, math, physics, significance) plus a final referee adjudication, with a bounded revision loop of up to 3 iterations. - Use Case: After completing GPD research phases on plasma turbulence control, run the Skill to audit readiness, generate figures, draft all sections into paper/main.tex, verify the bibliography, and produce a referee report before submission. ## Quick Start Ask the agent to write a physics paper from the completed research phases, optionally specifying a title or restricting sources with --from-phases.

Frequently Asked Questions about gpd-write-paper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a physics paper from research results with GPD?

Invoke the write-paper workflow after completing research phases. It loads the research digest, runs a paper-readiness audit, creates an outline, generates figures, drafts sections in parallel waves, and finishes with bibliography verification and staged peer review.

How to write a paper from only some research phases?

Use the --from-phases flag, for example --from-phases 1,3,5, to read SUMMARY.md files and artifacts only from the specified phase directories. This skips milestone digest lookup and scopes the paper to the selected phases.

Does the paper workflow require pdflatex installed?

No, pdflatex is optional. If it is unavailable, the workflow displays a warning and skips compilation checks after each drafting wave, but still generates correct .tex files. Install TeX Live or MacTeX to enable compilation verification.

What happens if the paper-readiness audit finds critical gaps?

The workflow stops and presents the critical gaps, such as missing SUMMARY.md files, convention mismatches, or missing decisive comparisons. You can fix the gaps, proceed anyway with documented limitations, or re-scope using --from-phases.

Which journal formats does the paper writer support?

It supports Physical Review Letters, Physical Review (PRD/PRB/PRA/PRE), Reviews of Modern Physics, and arXiv preprints, plus builder keys like apj, mnras, nature, jhep, and jfm in the PAPER-CONFIG.json spec. Each format has tailored length, style, equation, and figure rules.

Why does the workflow stop at review preflight?

Review preflight blocks execution when project state, roadmap, conventions, manuscript, or research artifacts are missing, or when review integrity is degraded. Resolve the listed blocking issues before drafting can continue.