/table-generation

name: table-generation
description: Generate publication-quality LaTeX tables from experimental results. Convert JSON/CSV data to booktabs-styled tables with bold best results, multi-row layouts, and proper captions. Use when creating result tables, comparison tables, or ablation tables for papers.
argument-hint: [data-source]

Table Generation

Convert experimental results into publication-ready LaTeX tables.

Input

• `$0` — Table type: `comparison`, `ablation`, `descriptive`, `custom`
• `$1` — Data source: JSON file, CSV file, or inline data

Scripts

Generate LaTeX table from JSON/CSV

python ~/.claude/skills/table-generation/scripts/results_to_table.py \
  --input results.json --type comparison \
  --bold-best max --caption "Performance comparison" \
  --label tab:main_results

Supports: `comparison`, `ablation`, `descriptive`, `multi-dataset` table types. Additional flags: `--type multi-dataset` for methods x datasets x metrics layout, `--significance` for p-value stars, `--underline-second` for second-best results.

References

• LaTeX table templates and examples: `~/.claude/skills/table-generation/references/table-templates.md`

Table Types

`comparison` — Main results table

• Rows = methods (baselines + ours), Columns = metrics/datasets
• Bold the best result in each column
• Include mean +/- std when available
• Use `\multirow` for method categories (Supervised, Self-supervised, etc.)

`ablation` — Ablation study table

• Rows = variants (full model, minus component A, minus component B, ...)
• Columns = metrics
• Bold the full model result
• Use checkmarks for component presence

`descriptive` — Dataset/statistics table

• Dataset characteristics, hyperparameters, or summary statistics
• Clean formatting with proper units

`custom` — Free-form table

• User specifies layout and content

Required Packages

\usepackage{booktabs}    % \toprule, \midrule, \bottomrule
\usepackage{multirow}    % \multirow
\usepackage{multicol}    % multi-column layouts
\usepackage{threeparttable}  % table notes

Output Format

Always generate tables with: 1. `booktabs` rules (`\toprule`, `\midrule`, `\bottomrule`) 2. `\caption{}` and `\label{tab:...}` 3. Bold best results using `\textbf{}` 4. Table notes via `threeparttable` when needed 5. Proper alignment (`l` for text, `c` or `r` for numbers)

Rules

• Only include numbers from actual experimental logs — never hallucinate results
• All numbers must match the data source exactly
• Use `$\pm$` for standard deviations
• Use `\underline{}` for second-best results when appropriate
• Keep tables compact — avoid unnecessary columns
• Use `table*` for wide tables spanning two columns
• Add glossary/notes for abbreviated column headers

Related Skills

• Upstream: [data-analysis](../data-analysis/), [experiment-code](../experiment-code/)
• Downstream: [paper-writing-section](../paper-writing-section/), [paper-compilation](../paper-compilation/)
• See also: [figure-generation](../figure-generation/)