Productivity
latex-paper-en▌
bahayonghang/academic-writing-skills · updated Apr 8, 2026
$npx skills add https://github.com/bahayonghang/academic-writing-skills --skill latex-paper-en
summary
Compile, audit, and improve English LaTeX conference and journal papers with targeted module-based checks.
- ›Supports 12 specialized modules covering compilation, formatting, bibliography validation, grammar, sentence clarity, logic flow, expression polish, translation, title optimization, figure quality, pseudocode review, and experiment-section analysis.
- ›Preserves LaTeX syntax, citations, references, labels, and math environments by default; returns findings in diff-comment style for ea
skill.md
LaTeX Academic Paper Assistant (English)
Use this skill for targeted work on an existing English LaTeX paper project. Keep the workflow low-friction: identify the right module, run the smallest useful check, and return actionable comments in LaTeX-friendly review format.
Capability Summary
- Compile and diagnose LaTeX build failures.
- Audit formatting, bibliography, grammar, sentence length, argument logic, and figure quality.
- Review IEEE-style pseudocode blocks, figure-wrapped algorithms, captions, labels, comments, and algorithm package choices.
- Improve expression, translate academic prose, optimize titles, and reduce AI-writing traces.
- Review experiment sections without rewriting citations, labels, or math.
Triggering
Use this skill when the user has an existing English .tex paper project and wants help with:
- compiling or fixing build errors
- format or venue compliance
- bibliography and citation validation
- grammar, sentence, logic, or expression review
- translation of academic prose
- title optimization
- figure or caption quality checks
- pseudocode and algorithm-block review
- de-AI editing of visible prose
- experiment-section analysis
Do Not Use
Do not use this skill for:
- planning or drafting a paper from scratch
- deep literature research or fact-finding without a paper project
- Chinese thesis-specific structure/template work
- Typst-first paper workflows
- DOCX/PDF conversion tasks that do not involve the LaTeX source
- multi-perspective review, scoring, or submission gate decisions (use
paper-audit) - standalone algorithm design from scratch without a paper project
Module Router
| Module | Use when | Primary command | Read next |
|---|---|---|---|
compile |
Build fails or the user wants a fresh compile | uv run python -B $SKILL_DIR/scripts/compile.py main.tex |
references/modules/COMPILE.md |
format |
User asks for LaTeX or venue formatting review | uv run python -B $SKILL_DIR/scripts/check_format.py main.tex |
references/modules/FORMAT.md |
bibliography |
Missing citations, unused entries, BibTeX validation | uv run python -B $SKILL_DIR/scripts/verify_bib.py references.bib --tex main.tex |
references/modules/BIBLIOGRAPHY.md |
grammar |
Grammar and surface-level language fixes | uv run python -B $SKILL_DIR/scripts/analyze_grammar.py main.tex --section introduction |
references/modules/GRAMMAR.md |
sentences |
Long, dense, or hard-to-read sentences | uv run python -B $SKILL_DIR/scripts/analyze_sentences.py main.tex --section introduction |
references/modules/SENTENCES.md |
logic |
Weak argument flow, unclear transitions, introduction funnel problems, or abstract/conclusion misalignment | uv run python -B $SKILL_DIR/scripts/analyze_logic.py main.tex --section methods |
references/modules/LOGIC.md |
expression |
Academic tone polish without changing claims | uv run python -B $SKILL_DIR/scripts/improve_expression.py main.tex --section related |
references/modules/EXPRESSION.md |
translation |
Chinese-to-English academic translation or bilingual polishing | uv run python -B $SKILL_DIR/scripts/translate_academic.py input.txt --domain deep-learning |
references/modules/TRANSLATION.md |
title |
Generate, compare, or optimize paper titles | uv run python -B $SKILL_DIR/scripts/optimize_title.py main.tex --check |
references/modules/TITLE.md |
figures |
Figure existence, extension, DPI, or caption review | uv run python -B $SKILL_DIR/scripts/check_figures.py main.tex |
references/REVIEWER_PERSPECTIVE.md |
pseudocode |
IEEE-safe pseudocode review, algorithm2e cleanup, caption/label/reference checks, and comment-length review |
uv run python -B $SKILL_DIR/scripts/check_pseudocode.py main.tex --venue ieee |
references/modules/PSEUDOCODE.md |
deai |
Reduce AI-writing traces while preserving LaTeX syntax | uv run python -B $SKILL_DIR/scripts/deai_check.py main.tex --section introduction |
references/modules/DEAI.md |
experiment |
Inspect experiment design/write-up quality, discussion depth, discussion layering, and conclusion completeness | uv run python -B $SKILL_DIR/scripts/analyze_experiment.py main.tex --section experiments |
references/modules/EXPERIMENT.md |
tables |
Table structure validation, three-line table generation, or booktabs review | uv run python -B $SKILL_DIR/scripts/check_tables.py main.tex |
references/modules/TABLES.md |
abstract |
Abstract five-element structure diagnosis and word count validation | uv run python -B $SKILL_DIR/scripts/analyze_abstract.py main.tex |
references/modules/ABSTRACT.md |
adapt |
Journal adaptation: reformat paper for a different venue | (LLM-driven workflow) | references/modules/ADAPT.md |
Required Inputs
main.texor the paper entrypoint.- Optional
--section SECTIONwhen the request is section-specific. - Optional bibliography path when the request targets references.
- Optional venue/context when the user cares about IEEE, ACM, Springer, NeurIPS, or ICML conventions.
If arguments are missing, ask only for the file path and the target module.
Output Contract
- Return findings in LaTeX diff-comment style whenever possible:
% MODULE (Line N) [Severity] [Priority]: Issue ... - Keep comments surgical and source-aware.
- Report the exact command used and the exit code when a script fails.
- Preserve
\cite{},\ref{},\label{}, custom macros, and math environments unless the user explicitly asks for source edits.
Workflow
- Parse
$ARGUMENTSand identify the smallest matching module. - Read only the reference file needed for that module.
- Run the module script with
uv run python -B .... - Summarize issues, suggested fixes, and blockers in LaTeX-friendly comments.
- If the user asks for a different concern, switch modules instead of overloading one run.
Safety Boundaries
- Never invent citations, metrics, baselines, or experimental results.
- Never rewrite bibliography keys, references, labels, or math by default.
- Treat generated text as proposals; keep source-preserving checks separate from prose rewriting.
Reference Map
references/STYLE_GUIDE.md: tone and style defaults.references/VENUES.md: venue-specific expectations.references/CITATION_VERIFICATION.md: citation verification workflow.references/REVIEWER_PERSPECTIVE.md: reviewer-style heuristics for figures and clarity.references/modules/: module-by-module commands and decision notes.references/modules/PSEUDOCODE.md: IEEE-safe defaults for LaTeX pseudocode.
Read only the file that matches the active module.
Example Requests
- “Compile my IEEE paper and tell me why
main.texstill fails after BibTeX.” - “Check the introduction section for grammar and sentence length, but do not rewrite equations.”
- “Audit figures and references in this ACM submission before I submit.”
- “Check whether this IEEE pseudocode still uses
algorithm2efloats and tell me how to make it IEEE-safe.” - “Review the experiments section for overclaiming, missing ablations, and weak baseline comparisons.”
See examples/ for complete request-to-command walkthroughs.