paper-plot-stub

Plots a results CSV as a two-line matplotlib chart and writes a PDF.

6.8k|540|Updated May 6, 2026
One-click install
npx skills add https://github.com/opensquilla/opensquilla --skill paper-plot-stub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-plot-stub
Source: https://github.com/opensquilla/opensquilla/tree/main/src/opensquilla/skills/bundled/paper-plot-stub
Command: npx skills add https://github.com/opensquilla/opensquilla --skill paper-plot-stub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires matplotlib, and includes scripts (resource) components.

What problem does it solve?

Turning raw experiment results into a publication-style figure usually requires writing ad-hoc plotting code. This Skill reads a CSV with columns x, y_baseline, and y_ours and produces a two-line comparison chart as a PDF in one step.

Core Features & Use Cases

  • CSV-to-PDF Plotting: Reads a results CSV with x, y_baseline, and y_ours columns and renders a two-line matplotlib chart.
  • Baseline vs. Ours Comparison: Automatically labels the two series as baseline and ours with markers, legend, and grid for paper-ready figures.
  • Use Case: After running an experiment that logs scores per step into results.csv, generate figure_1.pdf comparing your method against the baseline for inclusion in a paper draft.

Quick Start

Plot the results in paper/results.csv as a baseline-versus-ours line chart and save it as paper/figure_1.pdf.

Frequently Asked Questions about paper-plot-stub

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plot a CSV file as a line chart in Python?

Read the CSV with the csv module or pandas, extract the x and y columns as floats, then call matplotlib's plot function for each series and save the figure with savefig. This Skill does exactly that for x, y_baseline, and y_ours columns.

How to save a matplotlib figure as a PDF?

Call fig.savefig with a path ending in .pdf after building the plot. Using the Agg backend via matplotlib.use("Agg") lets the script render the PDF without a display, which is how this Skill operates.

What CSV format does the plotting script expect?

The CSV must have a header row with exactly the columns x, y_baseline, and y_ours, and every value must be parseable as a float. Missing or non-numeric values will cause the script to fail.

Does matplotlib plotting work without a display or GUI?

Yes, matplotlib supports headless rendering through the Agg backend, which this script sets before importing pyplot. The figure is written directly to a PDF file without opening any window.

Why does the plot script fail on my CSV file?

Failures occur when the CSV lacks the required x, y_baseline, or y_ours columns or contains non-numeric values, since the script converts every cell with float(). Verify the header names and data types match the expected schema.