LaTeX Paper Conversion
Overview
This skill automates the tedious and recurring process of converting an academic paper written in LaTeX from one publisher's template to another. Different journals (e.g., Springer, MDPI, IEEE) have vastly different structural requirements, document classes, margin settings, and bibliography styles. This skill streamlines these conversions by executing a structured multi-stage workflow, extracting content, mapping it to a new template, and resolving common compilation errors.
When to Use This Skill
- Use when the user requests to port an existing LaTeX paper to a new journal's format.
- Use when the user provides an existing
.tex file and a new template directory.
- Use when the user mentions converting from format A (e.g., IPOL/Neural Processing) to format B (e.g., MDPI).
How It Works
Step 1: Pre-requisites & Assessment
Identify the Source LaTeX file and asking the user for the Target Template Directory. Understand the core layout mapping (single-column vs. double-column, bibliography style).
Step 2: Extraction & Injection Script Generation
Create a Python script (e.g., convert_format.py) to parse the source LaTeX file. Use Regular Expressions to extract core text blocks. Merge the new template's preamble, the extracted body, and the backmatter. Write this to a new file in an output directory.
Step 3: Systematic Fixing
Perform generic fixes on the extracted body text before writing the final file, or in subsequent calls:
- Convert math environment cases (e.g.,
\begin{theorem} to \begin{Theorem}).
- Adjust aggressive float placements (e.g.,
[!t] or [h!]) to template-supported options. Avoid forcing [H] unless the float package is explicitly loaded.
- Ensure
\includegraphics paths are relative to the new .tex file location.
- Convert
\begin{tabular} to \begin{tabularx}{\textwidth} or use \resizebox if moving to a double-column layout.
Step 4: Compilation & Debugging
Run a build cycle (pdflatex -> bibtex -> pdflatex). Check the .log file using grep or rg to systematically fix any packages conflicts, undefined commands, or compilation halts.
Examples
Example 1: Converting IPOL to MDPI
```
USER: "I need to convert my paper 'SAHQR_Paper.tex' to the MDPI format located in the 'MDPI_template_ACS' folder."
AGENT: Triggers latex-paper-conversion skill
- Analyzes source
.tex and target template.tex.
- Creates Python script to extract Introduction through Conclusion.
- Injects content into MDPI template.
- Updates image paths and table float parameters
[h!] to [H].
- Compiles via pdflatex and bibtex to confirm zero errors.
```
Best Practices
- ✅ Always write a Python extraction script; DO NOT manually copy-paste thousands of lines of LaTeX.
- ✅ Always run
pdflatex and verify the .log to ensure the final output compiles.
- ✅ Explicitly ask the user for the structural mapping if the source and target differ drastically (e.g., merging abstract and keywords).
- ❌ Don't assume all math packages automatically exist in the new template (e.g., add
\usepackage{amsmath} if missing).
Common Pitfalls
- Problem: Overfull hboxes in tables when moving from single to double column.
Solution: Detect
\begin{tabular} and automatically wrap in \resizebox{\columnwidth}{!}{...} or suggest a format change.
- Problem: Undefined control sequence errors during compilation.
Solution: Search the
Paper.log and include the missing \usepackage{} in the converted template.
Additional Resources
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: latex-paper-conversion3description: This skill should be used when the user asks to convert an academic paper in LaTeX from one format (e.g., Springer, IPOL) to another format (e.g., MDPI, IEEE, Nature). It automates extraction, injection, fixing formatting, and compiling.4---5
6# LaTeX Paper Conversion
7
8## Overview
9
10This skill automates the tedious and recurring process of converting an academic paper written in LaTeX from one publisher's template to another. Different journals (e.g., Springer, MDPI, IEEE) have vastly different structural requirements, document classes, margin settings, and bibliography styles. This skill streamlines these conversions by executing a structured multi-stage workflow, extracting content, mapping it to a new template, and resolving common compilation errors.
11
12## When to Use This Skill
13
14- Use when the user requests to port an existing LaTeX paper to a new journal's format.
15- Use when the user provides an existing `.tex` file and a new template directory.
16- Use when the user mentions converting from format A (e.g., IPOL/Neural Processing) to format B (e.g., MDPI).
17
18## How It Works
19
20### Step 1: Pre-requisites & Assessment
21Identify the **Source LaTeX file** and asking the user for the **Target Template Directory**. Understand the core layout mapping (single-column vs. double-column, bibliography style).
22
23### Step 2: Extraction & Injection Script Generation
24Create a Python script (e.g., `convert_format.py`) to parse the source LaTeX file. Use Regular Expressions to extract core text blocks. Merge the new template's `preamble`, the extracted `body`, and the `backmatter`. Write this to a new file in an output directory.
25
26### Step 3: Systematic Fixing
27Perform generic fixes on the extracted body text before writing the final file, or in subsequent calls:
28- Convert math environment cases (e.g., `\begin{theorem}` to `\begin{Theorem}`).
29- Adjust aggressive float placements (e.g., `[!t]` or `[h!]`) to template-supported options. Avoid forcing `[H]` unless the `float` package is explicitly loaded.
30- Ensure `\includegraphics` paths are relative to the new `.tex` file location.
31- Convert `\begin{tabular}` to `\begin{tabularx}{\textwidth}` or use `\resizebox` if moving to a double-column layout.
32
33### Step 4: Compilation & Debugging
34Run a build cycle (`pdflatex` -> `bibtex` -> `pdflatex`). Check the `.log` file using `grep` or `rg` to systematically fix any packages conflicts, undefined commands, or compilation halts.
35
36## Examples
37
38### Example 1: Converting IPOL to MDPI
39\```
40USER: "I need to convert my paper 'SAHQR_Paper.tex' to the MDPI format located in the 'MDPI_template_ACS' folder."
41AGENT: *Triggers latex-paper-conversion skill*
421. Analyzes source `.tex` and target `template.tex`.
432. Creates Python script to extract Introduction through Conclusion.
443. Injects content into MDPI template.
454. Updates image paths and table float parameters `[h!]` to `[H]`.
465. Compiles via pdflatex and bibtex to confirm zero errors.
47\```
48
49## Best Practices
50
51- ✅ Always write a Python extraction script; DO NOT manually copy-paste thousands of lines of LaTeX.
52- ✅ Always run `pdflatex` and verify the `.log` to ensure the final output compiles.
53- ✅ Explicitly ask the user for the structural mapping if the source and target differ drastically (e.g., merging abstract and keywords).
54- ❌ Don't assume all math packages automatically exist in the new template (e.g., add `\usepackage{amsmath}` if missing).
55
56## Common Pitfalls
57
58- **Problem:** Overfull hboxes in tables when moving from single to double column.
59 **Solution:** Detect `\begin{tabular}` and automatically wrap in `\resizebox{\columnwidth}{!}{...}` or suggest a format change.
60- **Problem:** Undefined control sequence errors during compilation.
61 **Solution:** Search the `Paper.log` and include the missing `\usepackage{}` in the converted template.
62
63## Additional Resources
64
65- [Overleaf LaTeX Documentation](https://www.overleaf.com/learn)
66
67## Limitations
68- Use this skill only when the task clearly matches the scope described above.
69- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
70- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
gabrielmoreira