# table-generation

Turns JSON or CSV experiment results into booktabs-styled LaTeX tables with bold best values, captions and labels.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1600 installs · ★ 433
- Author: lingzhi227
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/lingzhi227/agent-research-skills/tree/HEAD/skills/table-generation/SKILL.md
- Updated: 2026-02-27
- HTML: https://affpapa.org/en/nevibecode/skills/table-generation

## What it does

The skill reads a results file and builds a paper-ready table from it. The table type comes in as an argument: `comparison` for main results, `ablation` for model variants, `descriptive` for dataset statistics, `multi-dataset` for a methods by datasets by metrics layout. The best value in each column gets bold, the runner-up can be underlined with `--underline-second`, and p-value stars come from `--significance`.

Under the hood there is a `results_to_table.py` script you call from the shell with the data path, table type, bold-best mode and caption. A `references/table-templates.md` file holds templates and examples.

The generated code expects `booktabs`, `multirow`, `multicol` and `threeparttable` in your preamble — without them it will not compile. The script pulls numbers only from the source you hand it, so a mismatch with your experiment logs shows up right away. Worth checking the data before generation rather than after.

The skill sits in a research pipeline: data analysis and experiment code feed into it, paper writing and compilation come after.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill table-generation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/table-generation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/table-generation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill table-generation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/table-generation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill table-generation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/table-generation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lingzhi227/agent-research-skills table-generation
```

2. **Manually: put the files in place**
- File: `.github/skills/table-generation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill table-generation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/lingzhi227/agent-research-skills --path skills/table-generation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/table-generation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add lingzhi227/agent-research-skills --skill table-generation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/lingzhi227/agent-research-skills/tree/HEAD/skills/table-generation/SKILL.md

## When to use it
- build a main comparison table across methods
- lay out an ablation table with component checkmarks
- print dataset statistics with units
- fit methods, datasets and metrics into one wide table
- add p-value stars and underline the second-best result

## Example prompts
- Generate a comparison table from results.json and bold the best result
- Build an ablation table from variants.csv with checkmarks for components
- Create a descriptive dataset table with a caption and label

## Similar
- [paper-write](https://affpapa.org/en/nevibecode/skills/paper-write.md) — skill · 539 installs
- [figure-designer](https://affpapa.org/en/nevibecode/skills/figure-designer.md) — skill · 739 installs
- [paper-writing](https://affpapa.org/en/nevibecode/skills/paper-writing.md) — skill · 561 installs
- [benchmark-paper-template](https://affpapa.org/en/nevibecode/skills/benchmark-paper-template.md) — skill · 679 installs
- [review-response](https://affpapa.org/en/nevibecode/skills/review-response.md) — skill · 555 installs
- [read-arxiv-paper](https://affpapa.org/en/nevibecode/skills/read-arxiv-paper.md) — skill · 2800 installs

From the same set: [lingzhi227/agent-research-skills](https://affpapa.org/en/nevibecode/by/lingzhi227/agent-research-skills.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
