latex-tables · terrylica — Claude Code skill: LaTeX tables with tabularray
Teaches the agent to build LaTeX tables with tabularray: fixed column widths, alignment, rule lines. Useful when a tblr has to be written from scratch or an old table rewritten.
MIT 242 installs ★ 3 updated 2026-10-25
npx skills add terrylica/cc-skills --skill latex-tables -a claude-codeWhat latex-tables does
The skill hands the agent a working tblr syntax. Widths are pinned with Q[2cm], stretchy columns use X, a bold first row comes from row{1}={font=\bfseries}, and rules switch on through hlines and vlines inside colspec. Five reference files sit beside the main instructions: table patterns, column specs, lines and borders, troubleshooting, and migration away from tabular and tabularx.
The package has to be there first. Run kpsewhich tabularray.sty to see whether it is, and sudo tlmgr install tabularray to add it. Nothing gets installed behind your back, so on a TeX Live tree missing the package the document fails at compile time regardless of what the agent writes.
This one also edits itself. When an instruction turns out wrong, or a workaround was needed, the agent is told to patch SKILL.md right away instead of leaving it for later, and to review the file once the job is done. It has Read, Edit and Bash for that.
What it helps with
- build a table with fixed-width columns
- migrate a
longtableortabularxlayout totblr - stop a table from running past the page margin
- get long text wrapping inside cells
- trace a compile error back to the
colspec
Example prompts for the agent
- Build a
tblrtable withQ[2cm]columns and rules on every side. - Move the
longtableinreport.texover totabularray, keeping the current column widths. - The table runs past the right margin — fix the
colspecand get the text wrapping.
How to install latex-tables
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-tables -a claude-code2Manually: put the files in place
~/.claude/skills/latex-tables/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/latex-tables/
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-tables -a codex2Manually: put the files in place
.agents/skills/latex-tables/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-tables -a cursor2Manually: put the files in place
.cursor/skills/latex-tables/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install terrylica/cc-skills plugins/doc-tools/skills/latex-tables2Manually: put the files in place
.github/skills/latex-tables/SKILL.md1Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-tables -a gemini-cli2Platform CLI
gemini skills install https://github.com/terrylica/cc-skills --path plugins/doc-tools/skills/latex-tablesManually: put the files in place
.devin/skills/latex-tables/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill latex-tables -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about latex-tables
How do I install latex-tables in Claude Code?
Run npx skills add terrylica/cc-skills --skill latex-tables -a claude-code. The skill file lands at ~/.claude/skills/latex-tables/SKILL.md.
What does latex-tables do?
It gives the agent the tabularray syntax for widths, alignment, rules and header styling. It also covers common compile errors and moving off the older table packages.
What do I need before the tables compile?
The tabularray package. Check with kpsewhich tabularray.sty and install with sudo tlmgr install tabularray.
Source text
SKILL.md · MIT
---
name: latex-tables
description: LaTeX tables with tabularray package. TRIGGERS - LaTeX table, tabularray, fixed-width columns, table alignment.
allowed-tools: Read, Edit, Bash
---
# LaTeX Tables with tabularray
> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
## When to Use This Skill
Use this skill when:
- Creating tables with fixed-width columns
- Formatting complex table layouts
- Need precise column alignment
- Migrating from tabular/tabularx/longtable/booktabs
- Troubleshooting table overflow issues
## Quick Reference
## Why tabularray?
Modern LaTeX3 package (replaces old solutions):
- Fixed-width columns with proper alignment
- Clean, consistent syntax
- Replaces: `tabular`, `tabularx`, `longtable`, `booktabs`
- Better performance than legacy packages
- Part of TeX Live 2025
---
## Installation
```bash
# Check if installed
kpsewhich tabularray.sty
# If not found, install:
sudo tlmgr install tabularray
```
## Basic Usage
```latex
\documentclass{article}
\usepackage{tabularray} % Modern table package
\begin{document}
% Simple table
\begin{tblr}{colspec={ccc}, hlines, vlines}
Header 1 & Header 2 & Header 3 \\
Data 1 & Data 2 & Data 3 \\
\end{tblr}
\end{document}
```
---
## Quick Reference Card
```latex
% Minimal table
\begin{tblr}{colspec={ccc}}
A & B & C \\
\end{tblr}
% With all lines
\begin{tblr}{colspec={ccc}, hlines, vlines}
A & B & C \\
\end{tblr}
% Fixed widths
\begin{tblr}{colspec={Q[2cm] Q[3cm] Q[2cm]}, hlines}
A & B & C \\
\end{tblr}
% Bold header
\begin{tblr}{
colspec={ccc},
row{1}={font=\bfseries}
}
Header & Header & Header \\
Data & Data & Data \\
\end{tblr}
```
---
## Best Practices
1. Use Q[width] for fixed columns instead of p{width}
2. Specify widths explicitly when text might overflow
3. Use X for flexible columns that should expand
4. Style headers with row{1} instead of manual formatting
5. Use colspec for column properties, not inline commands
6. Check package version: `kpsewhich tabularray.sty` (should be recent)
---
## Reference Documentation
For detailed information, see:
- [Table Patterns](./references/table-patterns.md) - 5 common table patterns with examples
- [Column Specification](./references/column-spec.md) - Alignment options and width control
- [Lines and Borders](./references/lines-borders.md) - All lines, selective lines, thick lines
- [Troubleshooting](./references/troubleshooting.md) - Table too wide, text not wrapping, alignment issues
- [Migration](./references/migration.md) - Migrating from tabular and tabularx
**Official Docs**: Run `texdoc tabularray` for complete package documentation
**See Also**:
- Use `latex/setup` skill for installing tabularray package
- Use `latex/build` skill for compilation workflows
---
## Troubleshooting
| Issue | Cause | Solution |
| ------------------------ | ------------------------- | --------------------------------------------------- |
| Package not found | tabularray not installed | `sudo tlmgr install tabularray` |
| Table too wide | Fixed widths exceed page | Use smaller Q[width] values or X for flexible |
| Text not wrapping | Column spec missing width | Use Q[width] instead of c/l/r for wrapping |
| Alignment issues | Mixed column types | Ensure all columns have consistent spec |
| Compile error on colspec | Invalid syntax | Check for missing commas or typos in column spec |
| hlines not appearing | Missing from spec | Add `hlines` to the spec: `{colspec={...}, hlines}` |
| Row style not applied | Wrong row index | Remember row{1} is first row (1-indexed) |
| Package version too old | TeX Live outdated | `sudo tlmgr update --self --all` |
## Post-Execution Reflection
After this skill completes, check before closing:
1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.
© terrylica · MIT · terrylica/cc-skills
Similar skills
All skills for Writing and docs →latex-tables by other authors comes first.