latex-conference-template-organizer

What this skill does

# LaTeX Conference Template Organizer

## Overview

Transform messy conference LaTeX template .zip files into clean, Overleaf-ready submission templates. Official conference templates often contain excessive example content, instructional comments, and disorganized file structures. This skill converts them into templates ready for writing.

## Working Mode

**Analyze-then-confirm mode**: First analyze issues and present them to the user, then execute cleanup after confirmation.

## Complete Workflow

```
Receive .zip file
    ↓
1. Extract and analyze file structure
    ↓
2. Identify main file and dependencies
    ↓
3. Diagnose issues (present to user)
    ↓
4. Ask for conference info (link/name)
    ↓
5. Wait for user confirmation of cleanup plan
    ↓
6. Execute cleanup, create output directory
    ↓
7. Generate README (with official website info)
    ↓
8. Output complete
```

## Step 1: Extract and Analyze

### Extract Files

Extract .zip to a temporary directory:

```bash
unzip -q template.zip -d /tmp/latex-template-temp
cd /tmp/latex-template-temp
find . -type f -name "*.tex" -o -name "*.sty" -o -name "*.cls" -o -name "*.bib"
```

### Identify File Types

| File Type | Purpose |
|-----------|---------|
| `.tex` | LaTeX source files |
| `.sty` / `.cls` | Style files |
| `.bib` | Bibliography database |
| `.pdf` / `.png` / `.jpg` | Image files |

### Identify Main File

**Common main file names:**
- `main.tex`
- `paper.tex`
- `document.tex`
- `sample-sigconf.tex`
- `template.tex`

**Identification methods:**
1. Check if filename matches common patterns
2. Search for files containing `\documentclass`
3. If multiple candidates exist, ask user to confirm

```bash
# Find files containing \documentclass
grep -l "\\documentclass" *.tex
```

## Step 2: Diagnose Issues

Present discovered issues to the user:

### Disorganized File Structure

- Multi-level directory nesting
- .tex files scattered across directories
- Unclear which file is the main file

### Redundant Content

Detect the following patterns and flag for cleanup:
- Filenames containing: `sample`, `example`, `demo`, `test`
- Comments containing: `sample`, `example`, `template`, `delete this`

### Dependency Issues

- Referenced `.sty`/`.cls` files missing
- Image/table reference paths incorrect

## Step 3: Ask for Conference Information

Ask the user for the following information:

```markdown
Please provide the following information (optional):

1. **Conference submission link** (recommended): Used to extract official submission requirements
2. **Conference name**: If no link available
3. **Other special requirements**: Such as page limits, anonymity requirements, etc.
```

## Step 4: Present Cleanup Plan

Present the cleanup plan to the user and wait for confirmation:

```markdown
## Cleanup Plan

### Issues Found
- [List diagnosed issues]

### Cleanup Approach
1. Main file: main.tex (clean example content)
2. Section separation: text/ directory
3. Resource directories: figures/, tables/, styles/

### Output Structure
[Show output directory structure]

Confirm execution? [Y/n]
```

## Step 5: Execute Cleanup

### Create Output Directory Structure

```bash
mkdir -p output/{text,figures,tables,styles}
```

### Clean Up Main File (main.tex)

**Keep:**
- `\documentclass` declaration
- Required package imports
- Core configuration (e.g., anonymous mode)

**Remove:**
- Example section content
- Verbose instructional comments
- Example author/title information

**Add:**
- Import sections with `\input{text/XX-section}`

**Example main.tex structure** (ACM template standard format):
```latex
\documentclass[...]{...}  % Keep original template document class

% Required packages (keep original template package declarations)

%% ============================================================================
%% Preamble: Before \begin{document}
%% ============================================================================

%% Title and author information
\title{Your Paper Title}
\author{Author Name}
\affiliation{...}

%% Abstract (in preamble, before \maketitle)
\begin{abstract}
% TODO: Write abstract content
\end{abstract}

%% CCS Concepts and Keywords (in preamble)
\begin{CCSXML}
<ccs2012>
   <concept>
       <concept_id>10010405.10010444.10010447</concept_id>
       <concept_desc>Applied computing~...</concept_desc>
       <concept_significance>500</concept_significance>
   </concept>
</ccs2012>
\end{CCSXML}

\ccsdesc[500]{Applied computing~...}
\keywords{keyword1, keyword2, keyword3}

%% ============================================================================
%% Document Body
%% ============================================================================
\begin{document}

\maketitle

%% Section content (imported from text/)
\input{text/01-introduction}
\input{text/02-related-work}
\input{text/03-method}
\input{text/04-experiments}
\input{text/05-conclusion}

\bibliographystyle{...}
\bibliography{references}

\end{document}
```

### KDD 2026 Anonymous Submission Special Configuration

For KDD 2026 (using ACM acmart template), add the `nonacm` option to the document class to remove footnotes:

```latex
%% ============================================================================
%% Document Class - KDD 2026 Anonymous Submission Configuration
%% Submission version: \documentclass[sigconf,anonymous,review,nonacm]{acmart}
%% Camera-ready: \documentclass[sigconf]{acmart}
%% ============================================================================
\documentclass[sigconf,anonymous,review,nonacm]{acmart}

%% ============================================================================
%% Disable ACM metadata (submission version only)
%% ============================================================================
\settopmatter{printacmref=false}  % Disable ACM Reference Format
\setcopyright{none}               % Disable copyright notice
\acmConference[]{}{}{}            % Clear conference info (removes footnote)
\acmYear{}                        % Clear year
\acmISBN{}                        % Clear ISBN
\acmDOI{}                         % Clear DOI

%% Content to restore for camera-ready version:
%% \acmConference[KDD '26]{Proceedings of the 30th ACM SIGKDD Conference on Knowledge Discovery and Data Mining}{August 09--13, 2026}{Jeju, Korea}
%% \acmISBN{978-1-4503-XXXX-X/26/08}
%% \acmDOI{10.1145/nnnnnnn.nnnnnnn}
```

### Create Section Files (text/)

Create independent .tex files for each section, **containing only section content** without `\begin{document}` etc.:

**text/01-introduction.tex**:
```latex
\section{Introduction}
% TODO: Write introduction content
```

**text/02-related-work.tex**:
```latex
\section{Related Work}
% TODO: Write related work content
```

**text/03-method.tex**:
```latex
\section{Method}
% TODO: Write method content
```

**text/04-experiments.tex**:
```latex
\section{Experiments}
% TODO: Write experiments content
```

**text/05-conclusion.tex**:
```latex
\section{Conclusion}
% TODO: Write conclusion content
```

**Important notes:**
- **Abstract** should be placed in main.tex preamble (before `\begin{document}`), after `\maketitle`
- **Files in text/ contain only sections**, starting with `\section{...}`
- Do not include `\begin{document}` or other wrappers in text/ files

### Copy Style Files (styles/)

Copy all `.sty` and `.cls` files from the original template to `styles/`:

```bash
find /tmp/latex-template-temp -type f \( -name "*.sty" -o -name "*.cls" \) -exec cp {} output/styles/ \;
```

**Note:** Maintain the original template's directory structure (e.g., `acmart/`), only move to `styles/`.

### Handle Images and Tables

```bash
# Copy image files
find /tmp/latex-template-temp -type f \( -name "*.png" -o -name "*.jpg" -o -name "*.jpeg" -o -name "*.pdf" \) -exec cp {} output/figures/ \;

# Copy table files (if any)
find /tmp/latex-template-temp -type f -name "*.tex" | grep -i table | while read f; do cp "$f" output/tables/; done
```

### Create Example Table File

**I