How do I install the Chartli skill?

Run npx skillmds@latest add ahmadawais/chartli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Chartli skill do?

Install and use chartli to render terminal charts from numeric text files or stdin. It is listed under Coding & Dev Tools on SkillMD.

Is Chartli safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Chartli?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Chartli free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Chartli?

ahmadawais (@ahmadawais) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Chartli by ahmadawais — Agent Skill

Name: Chartli
Author: ahmadawais

File contents

chartli Skill

Use this skill when an agent needs to visualize numeric data in the terminal as ASCII/Unicode/SVG charts.

Install

npx skills add ahmadawais/chartli

CLI install/use

Instant use:

npx chartli --help

Global install:

npm i -g chartli

What chartli can do

Render chart types: ascii, spark, bars, columns, heatmap, unicode, braille, svg
Read from file path input
Read from stdin when no file is passed
Control output dimensions with --width and --height
Render SVG with --mode circles|lines
Add x and y axis titles with --x-axis-label and --y-axis-label
Add custom tick/category labels with --x-labels and --series-labels
Show raw values on the plotted data with --data-labels
Promote the first numeric column into x-axis labels with --first-column-x

Command templates

From file:

npx chartli <file> -t <type> [--width N] [--height N] [--mode circles|lines] [--x-axis-label LABEL] [--y-axis-label LABEL] [--x-labels a,b,c] [--series-labels foo,bar] [--data-labels] [--first-column-x]

From stdin:

printf 'x y\n1 10\n2 20\n3 15\n' | npx chartli -t ascii -w 24 -h 8

Labeled two-column chart:

printf 'day value\n1 10\n2 20\n3 15\n' | npx chartli -t ascii -w 24 -h 8 --first-column-x --data-labels

Per-type examples:

npx chartli data.txt -t ascii -w 24 -h 8
npx chartli data.txt -t spark
npx chartli data.txt -t bars -w 28
npx chartli data.txt -t columns -h 8
npx chartli data.txt -t heatmap
npx chartli data.txt -t unicode
npx chartli data.txt -t braille -w 16 -h 6
npx chartli data.txt -t svg -m lines -w 320 -h 120

Input format

Whitespace-separated numeric rows; optional header row is allowed.

day sales costs profit
1 10 8 2
2 14 9 5
3 12 11 3

When --first-column-x is set, the first numeric column becomes the x-axis labels. If a header row exists, chartli uses the first header cell as the x-axis title and the remaining headers as series labels. For common two-column input, the second header cell becomes the y-axis title.

Repository example assets

examples/assets/core-single-series.txt
examples/assets/core-multi-series.txt
examples/assets/image-data.txt
examples/assets/image-columns-variant.txt

---name: chartlidescription: Install and use chartli to render terminal charts from numeric text files or stdin.---# chartli SkillUse this skill when an agent needs to visualize numeric data in the terminal as ASCII/Unicode/SVG charts.## Install```shnpx skills add ahmadawais/chartli```## CLI install/useInstant use:```shnpx chartli --help```Global install:```shnpm i -g chartli```## What chartli can do- Render chart types: `ascii`, `spark`, `bars`, `columns`, `heatmap`, `unicode`, `braille`, `svg`- Read from file path input- Read from stdin when no file is passed- Control output dimensions with `--width` and `--height`- Render SVG with `--mode circles|lines`- Add `x` and `y` axis titles with `--x-axis-label` and `--y-axis-label`- Add custom tick/category labels with `--x-labels` and `--series-labels`- Show raw values on the plotted data with `--data-labels`- Promote the first numeric column into x-axis labels with `--first-column-x`## Command templatesFrom file:```shnpx chartli <file> -t <type> [--width N] [--height N] [--mode circles|lines] [--x-axis-label LABEL] [--y-axis-label LABEL] [--x-labels a,b,c] [--series-labels foo,bar] [--data-labels] [--first-column-x]```From stdin:```shprintf 'x y\n1 10\n2 20\n3 15\n' | npx chartli -t ascii -w 24 -h 8```Labeled two-column chart:```shprintf 'day value\n1 10\n2 20\n3 15\n' | npx chartli -t ascii -w 24 -h 8 --first-column-x --data-labels```Per-type examples:```shnpx chartli data.txt -t ascii -w 24 -h 8npx chartli data.txt -t sparknpx chartli data.txt -t bars -w 28npx chartli data.txt -t columns -h 8npx chartli data.txt -t heatmapnpx chartli data.txt -t unicodenpx chartli data.txt -t braille -w 16 -h 6npx chartli data.txt -t svg -m lines -w 320 -h 120```## Input formatWhitespace-separated numeric rows; optional header row is allowed.```textday sales costs profit1 10 8 22 14 9 53 12 11 3```When `--first-column-x` is set, the first numeric column becomes the x-axis labels. If a header row exists, chartli uses the first header cell as the x-axis title and the remaining headers as series labels. For common two-column input, the second header cell becomes the y-axis title.## Repository example assets- `examples/assets/core-single-series.txt`- `examples/assets/core-multi-series.txt`- `examples/assets/image-data.txt`- `examples/assets/image-columns-variant.txt`

Frequently asked questions

Chartli