Ggterm Publish
by shandley
Export terminal plots to publication-quality formats (PNG, SVG, PDF, HTML). Use when the user wants to save, export, publish, or create a high-quality version of a plot.
Skill Details
Repository Files
1 file in this skill directory
name: ggterm-publish description: Export terminal plots to publication-quality formats (PNG, SVG, PDF, HTML). Use when the user wants to save, export, publish, or create a high-quality version of a plot. allowed-tools: Bash(bun:, npx:, vl2*), Read, Write
Publication Export with ggterm
Export terminal plots to publication-quality formats using Vega-Lite.
Prerequisites
The Vega-Lite CLI tools must be installed:
npm install -g vega-lite vega-cli canvas
How It Works
When a plot is created with the CLI, ggterm saves:
.ggterm/last-plot.json- The PlotSpec (ggterm format).ggterm/last-plot-vegalite.json- The Vega-Lite spec
Export Commands
To PNG (Raster)
npx vl2png .ggterm/last-plot-vegalite.json > plot.png
To SVG (Vector)
npx vl2svg .ggterm/last-plot-vegalite.json > plot.svg
To PDF
npx vl2pdf .ggterm/last-plot-vegalite.json > plot.pdf
To HTML (Interactive)
cat > plot.html << 'EOF'
<!DOCTYPE html>
<html>
<head>
<script src="https://cdn.jsdelivr.net/npm/vega@5"></script>
<script src="https://cdn.jsdelivr.net/npm/vega-lite@5"></script>
<script src="https://cdn.jsdelivr.net/npm/vega-embed@6"></script>
</head>
<body>
<div id="vis"></div>
<script>
const spec = SPEC_PLACEHOLDER;
vegaEmbed('#vis', spec);
</script>
</body>
</html>
EOF
# Replace placeholder with actual spec
bun -e "
const spec = require('./.ggterm/last-plot-vegalite.json');
const html = require('fs').readFileSync('plot.html', 'utf-8');
const result = html.replace('SPEC_PLACEHOLDER', JSON.stringify(spec, null, 2));
require('fs').writeFileSync('plot.html', result);
"
Custom Dimensions
To export with different dimensions, modify the Vega-Lite spec first:
bun -e "
const spec = require('./.ggterm/last-plot-vegalite.json');
spec.width = 800;
spec.height = 600;
require('fs').writeFileSync('.ggterm/last-plot-vegalite.json', JSON.stringify(spec, null, 2));
"
npx vl2png .ggterm/last-plot-vegalite.json > plot-large.png
Workflow
- User creates a terminal plot using
/ggterm-plot - User asks to export it for publication
- This skill exports to the requested format
Troubleshooting
If vl2png/vl2svg fail, ensure dependencies are installed:
npm install -g vega-lite vega-cli canvas
On macOS, canvas may require additional setup:
brew install pkg-config cairo pango libpng jpeg giflib librsvg
npm install -g canvas --build-from-source
$ARGUMENTS
Related Skills
Attack Tree Construction
Build comprehensive attack trees to visualize threat paths. Use when mapping attack scenarios, identifying defense gaps, or communicating security risks to stakeholders.
Grafana Dashboards
Create and manage production Grafana dashboards for real-time visualization of system and application metrics. Use when building monitoring dashboards, visualizing metrics, or creating operational observability interfaces.
Matplotlib
Foundational plotting library. Create line plots, scatter, bar, histograms, heatmaps, 3D, subplots, export PNG/PDF/SVG, for scientific visualization and publication figures.
Scientific Visualization
Create publication figures with matplotlib/seaborn/plotly. Multi-panel layouts, error bars, significance markers, colorblind-safe, export PDF/EPS/TIFF, for journal-ready scientific plots.
Seaborn
Statistical visualization. Scatter, box, violin, heatmaps, pair plots, regression, correlation matrices, KDE, faceted plots, for exploratory analysis and publication figures.
Shap
Model interpretability and explainability using SHAP (SHapley Additive exPlanations). Use this skill when explaining machine learning model predictions, computing feature importance, generating SHAP plots (waterfall, beeswarm, bar, scatter, force, heatmap), debugging models, analyzing model bias or fairness, comparing models, or implementing explainable AI. Works with tree-based models (XGBoost, LightGBM, Random Forest), deep learning (TensorFlow, PyTorch), linear models, and any black-box model
Pydeseq2
Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.
Query Writing
For writing and executing SQL queries - from simple single-table queries to complex multi-table JOINs and aggregations
Pydeseq2
Differential gene expression analysis (Python DESeq2). Identify DE genes from bulk RNA-seq counts, Wald tests, FDR correction, volcano/MA plots, for RNA-seq analysis.
Scientific Visualization
Meta-skill for publication-ready figures. Use when creating journal submission figures requiring multi-panel layouts, significance annotations, error bars, colorblind-safe palettes, and specific journal formatting (Nature, Science, Cell). Orchestrates matplotlib/seaborn/plotly with publication styles. For quick exploration use seaborn or plotly directly.