latex-authoring
Write or revise LaTeX source for articles and technical documents: document class, math, tables, citations, semantic macros, and package selection. Use when the requested change is in .tex content or
SKILL.mdskills/latex-authoring/SKILL.md
GitHubLaTeX Authoring
Write source that expresses the document's structure and mathematics clearly.
Choose the document class and bibliography backend before adding packages;
follow a venue template when one is required. The source change is complete
only when the relevant build and rendered pages have been checked with
latex-build-diagnostics or the repository's publication skill.
Choose the source structure
| Document | Starting point |
|---|---|
| Article or preprint | article, unless the venue requires its class |
| Book or thesis | The existing institutional class; otherwise book, memoir, or KOMA-Script |
| Letter | scrlttr2 |
| Slides | latex-beamer-presentations |
| Standalone figure | tikz-figure-engineering |
Use a small preamble. mathtools, amssymb, amsthm, microtype,
booktabs, siunitx, graphicx, and hyperref have distinct jobs; add each
only when the source uses it. Load hyperref near the end and cleveref
after it. The current article skeleton is templates/article.tex.
Mathematics
- Use
\[...\]for display math,alignfor aligned derivations,gatherfor separate centered equations, andmultlinefor one long equation. - Put words in math with
\text{...}and define repeated operators with\DeclareMathOperator. Define semantic macros once in the preamble. - Put units through
siunitxand distinguish a differential from a variable, for example\,\mathrm{d}x. - Avoid
$$...$$,eqnarray, and manual line breaks to end paragraphs.
Read references/math-typesetting.md for theorem environments, equations,
and common math-mode errors.
Tables and figures in prose
Use booktabs rules without vertical grid lines. Use siunitx S columns
for comparable numeric values and tabularx when width is constrained.
Captions normally precede tables and follow figures. Size included figures
relative to \linewidth inside columns or minipages. Use vector output for
plots and raster output for photographs. For a figure drawn in TikZ, hand off
to tikz-figure-engineering; choose the semantic form before coordinates.
Bibliography
| Context | Backend |
|---|---|
Venue supplies .bst or requires natbib |
BibTeX and natbib |
| New document with a controlled toolchain | biblatex and Biber |
| Repository has an established inline bibliography | Follow that repository convention |
Never mix natbib and biblatex in one document. Keep citation keys stable,
check that each cited source supports its sentence, and follow the venue's
bibliography instructions. Read references/bibliography.md for backend
options and .bib hygiene.
Source review
- Every label and citation has a matching definition or entry.
- Every macro name describes a role, not a one-off visual tweak.
- Package order is deliberate; avoid obsolete
epsfig,subfigure, andeqnarraypatterns. - Tables and math can be read at final page width.
- Pass the source to the build skill or repository pipeline and inspect the rendered pages that changed.
References
references/math-typesetting.md: load for equations and theorem structure.references/bibliography.md: load for citation backend and entries.templates/article.tex: starting article source.