agentleFS
Sign inStart free
MicrosoftKnown publishermicrosoft/cat-agent-skills/submissions/chart-builder/SKILL.md

chart-builder

Skill95 starsChanged 6 days agoMITView on GitHub

Use this skill whenever the user asks to visualize, chart, plot, or graph data (bar, line, scatter, histogram, pie) from a CSV, table, or DataFrame. It gives the agent prebuilt, parameterized matplotlib functions so charts are produced faster and more reliably — with consistent styling and sane defaults — instead of hand-writing matplotlib each time.

We split this skill into the rules it gives an agent

1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈1

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Call the function for the chart you need, passing the column names:

    line 14

≈ “Common” is an estimate: at least 1 in 5 of the 308,232 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Generate charts from tabular data via the bundled scripts/charts.py toolkit. Each function takes a DataFrame or a file path plus the columns to plot, and saves a PNG (returning the path). It handles theming, figure sizing, label rotation, NaN dropping, legend placement, and saving.

Instructions

  1. Provide the data source: a pandas DataFrame, or a path to a .csv / .tsv / .json file.
  2. Call the function for the chart you need, passing the column names:
    • bar(data, x, y) — one value per category (horizontal=True for barh)
    • grouped_bar(data, x, y, group) — value per category split by group (stacked=True to stack)
    • line(data, x, y, group=None) — value over an ordered axis, one line per group
    • scatter(data, x, y, group=None, size=None) — two numeric columns
    • histogram(data, y, bins=20, group=None) — distribution of one column
    • pie(data, x, y, donut=False) — share of y per category x
  3. Optional keyword args on every chart: title, xlabel, ylabel (derived from column names if omitted), out (default "chart.png"; pass None to skip saving), dpi (default 150), figsize, palette.
  4. The function returns the saved image path. See references/cheatsheet.md for full signatures and a chart-selection table.

Usage

Import:

from charts import bar, line, pie
bar("sales.csv", x="region", y="revenue", title="Revenue by region",
    out="revenue.png")

CLI:

python scripts/charts.py grouped_bar sales.csv \
    --x region --y revenue --group quarter --stacked --out by_quarter.png

Bundled files

  • scripts/charts.py — the toolkit: load_data, apply_theme, save_fig, and six chart functions (bar, grouped_bar, line, scatter, histogram, pie), plus a CLI. Depends on matplotlib and pandas; runs headless.
  • references/cheatsheet.md — chart-selection table, full signatures, and copy-paste CLI examples.
  • assets/sample_sales.csv — a small demo dataset that exercises every chart.

Defaults

  • Colorblind-friendly palette and a shared theme across charts.
  • Figure size, x-label rotation, and legend placement adapt to the data.
  • Rows with missing values in the plotted columns are dropped before drawing.
  • Output is a saved PNG at 150 DPI by default (override out and dpi).

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free