← Back to Skills Marketplace
215
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install chart-mpl
Description
Generate PNG/SVG charts (line, bar, hbar, pie, stacked, scatter, area) from CSV data using matplotlib. Use when the user asks to visualize tabular data, prod...
README (SKILL.md)
Chart MPL
Generate chart images from CSV files with scripts/chart_mpl.py.
Setup
Create a virtual environment and install matplotlib (one-time):
python3 -m venv ~/.openclaw/workspace/.venv_chart
~/.openclaw/workspace/.venv_chart/bin/pip install matplotlib
Quick start
Run from workspace root:
~/.openclaw/workspace/.venv_chart/bin/python skills/chart-mpl/scripts/chart_mpl.py \
--csv /path/to/data.csv \
--xcol Mois \
--ycol Valeur \
--kind line \
--title "Monthly trend" \
--xlabel "Month" \
--ylabel "Value"
Output defaults to:
~/.openclaw/workspace/exports/images
Inputs
--csvpath to CSV file--xcolcolumn for X axis--ycolnumeric column(s) for Y axis — comma-separated for multi-series (e.g.Sales,Costs)--kindchart type:line,bar,hbar,pie,stacked,scatter,area- Optional:
--delimif auto-detection fails (;,,,|) - Optional:
--outcustom output path (PNG or SVG — format detected from extension) - Optional:
--title,--xlabel,--ylabel - Optional:
--top Nshow only top N categories by value (bar, hbar, pie, stacked). Multi-series ranks by row total. - Optional:
--sortsort data before plotting:x-asc,x-desc,y-desc,none(default:none) - Optional:
--numfmtnumber format on Y axis:fr(1,5M) oren(1.5M) — default:fr
Chart types
| Kind | Description | Multi-series |
|---|---|---|
line |
Line chart with markers | yes |
bar |
Vertical bar chart (grouped when multi-series) | yes |
hbar |
Horizontal bar chart (grouped when multi-series) | yes |
pie |
Pie chart (first Y column only) | no |
stacked |
Stacked vertical bar (requires 2+ Y) | yes |
scatter |
Scatter plot | yes |
area |
Filled area chart | yes |
Notes
- Script auto-detects delimiters when possible.
- Script tolerates European and US numeric formats (
1 234,56,1,234.56). - Non-numeric values in
ycolare converted toNaNwith a warning. - Handles BOM-encoded CSV files (
utf-8-sig). - Multi-series charts automatically show a legend and cycle through an 8-color palette.
- Y-axis ticks use human-readable formatting (K, M, G suffixes) with French or English decimals.
--top Nkeeps the N highest categories. For pie charts, the remainder is aggregated into an "Other" slice. For bar/hbar/stacked, the rest are excluded.- Output format (PNG or SVG) is detected from the
--outfile extension. Default is PNG.
End-to-end flow with SQL skill
- Export query result to CSV using the
mssqlskill. - Run this script on that CSV.
- Share the generated PNG path.
Usage Guidance
This skill appears to do what it claims (create charts from CSV) and relies on a bundled Python script plus matplotlib. However, the provided script content was truncated in the package listing, so you should not run it unreviewed. Before installing or running: (1) review the full scripts/chart_mpl.py file for any subprocess, networking, or filesystem operations beyond reading the CSV and writing the image (search for os.system, subprocess, socket, requests, urllib, open to unexpected paths, or code that posts files); (2) run pip installs inside an isolated virtual environment or sandbox; (3) if you will supply CSVs exported from other skills, ensure those CSVs don't contain sensitive data you don't want processed or written to disk; (4) consider running the script on a non-production machine first. If you can provide the complete script (no truncation), I can re-evaluate and raise confidence to high if nothing suspicious appears.
Capability Analysis
Type: OpenClaw Skill
Name: chart-mpl
Version: 1.1.0
The chart-mpl skill is a legitimate utility for generating various chart types (line, bar, pie, etc.) from CSV data using matplotlib. The Python script scripts/chart_mpl.py implements robust data parsing, numeric sanitization, and visualization logic without any indicators of malicious intent, data exfiltration, or unauthorized execution. It includes safety measures such as filename sanitization in the default_out function to prevent path traversal.
Capability Assessment
Purpose & Capability
Name/description, required binary (python3), SKILL.md usage, and included scripts all align: the skill provides a Python script that reads CSV and renders charts with matplotlib — this is coherent and expected.
Instruction Scope
SKILL.md instructs creating a venv in ~/.openclaw/workspace/.venv_chart, installing matplotlib, and running the bundled script against a provided CSV. Those steps are within scope. It does write outputs to ~/.openclaw/workspace/exports/images (or to a user-specified --out). The audit is limited because the provided scripts/chart_mpl.py was truncated in the package listing, so the latter part of runtime logic (after beginning of scatter branch and any remaining code) could not be inspected.
Install Mechanism
No install spec is present (instruction-only); the SKILL.md recommends a venv and pip install matplotlib. There is no external download of code — the script is included in the package — so install risk is just the normal PyPI install of matplotlib and its dependencies.
Credentials
The skill requests no environment variables or credentials. It reads CSV files supplied by the user and writes image files to the workspace or a user-provided --out path, which is proportionate to the stated purpose.
Persistence & Privilege
always:false and user-invocable:true. The skill creates its own venv and output directories under ~/.openclaw/workspace, which is a reasonable level of persistence and scoped to its own files; it does not request elevated platform privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install chart-mpl - After installation, invoke the skill by name or use
/chart-mpl - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
v1.1.0 — New chart types, multi-series, and BI improvements
- Added 5 new chart types: hbar, pie, stacked, scatter, area
- Multi-series support via comma-separated --ycol (e.g. Sales,Costs)
- Grouped bars for multi-series bar/hbar (no more overlap)
- --top N: keep top N categories; pie aggregates remainder into "Other"
- --sort: explicit sort modes (x-asc, x-desc, y-desc, none)
- --numfmt: human-readable Y axis with FR (1,5M) or EN (1.5M) formatting
- SVG output support (detected from --out extension)
- Accounting negatives (1,234.56) now parsed correctly
- Self-contained setup instructions in SKILL.md
- Fixed crash when --out is a filename without directory
v1.0.0
Initial release — PNG charts from CSV via matplotlib, auto-detect delimiters, European/US number formats
Metadata
Frequently Asked Questions
What is Chart MPL?
Generate PNG/SVG charts (line, bar, hbar, pie, stacked, scatter, area) from CSV data using matplotlib. Use when the user asks to visualize tabular data, prod... It is an AI Agent Skill for Claude Code / OpenClaw, with 215 downloads so far.
How do I install Chart MPL?
Run "/install chart-mpl" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Chart MPL free?
Yes, Chart MPL is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Chart MPL support?
Chart MPL is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Chart MPL?
It is built and maintained by Umbra (@mohamed-hammane); the current version is v1.1.0.
More Skills