vivarium-reportlisted
Install: claude install-skill Jason-0409-G/vivarium
# vivarium-report — publication-grade figures from comparative-genomics results
Turn an analysis table (an ANI matrix, a CAZy/COG count table, a dN/dS summary, a tree) into a figure that defends a claim and survives review — not a pretty plot in isolation. Figures come out journal-ready: Arial, small fonts, editable text, a restrained palette, exported as **SVG (editable) + PDF + TIFF (600 dpi)**.
## Step 0 — figure contract, before any code
State these four things first; they decide the plot, not the aesthetics:
1. **Claim**: the one sentence this figure must defend (e.g. "L5 and M7 are conspecific, >95% ANI").
2. **Figure type / data**: which analysis output feeds it (table below).
3. **Backend**: **Python or R?** This is a blocking choice — if the user has not said which, ask "Python or R?" and stop. Both are bundled; use the chosen one exclusively (don't render an R figure with Python or vice-versa).
4. **Export**: final size + formats. Default SVG + PDF + TIFF (600 dpi), editable text.
## Step 1 — map the result to a figure type
| Result (vivarium output) | Figure | Bundled? |
|---|---|---|
| ANI / AAI matrix (square TSV) | annotated heatmap | ✅ `heatmap` |
| CAZy / COG / KEGG category counts per genome (TSV) | grouped or stacked bars | ✅ `bars` |
| Gene-family presence/absence, small matrix | heatmap (0/1) | ✅ `heatmap` |
| dN/dS (ω) per orthogroup | lollipop / sorted bars | use `bars` (one series) or draw directly |
| Phylogenetic tree (Newick + support) | tree |