Agent skill

Chart Type Selection Guide

by pipeshub-ai in pipeshub-ai/pipeshub-ai

Picks the right chart type for a data question and applies readability rules like axis labels, colorblind palettes and legend restraint.

Apache-2.0Auto-check passedData & Analytics

Install Chart Type Selection Guide

skills CLI
$ npx skills add pipeshub-ai/pipeshub-ai --skill data-visualization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pipeshub-ai/pipeshub-ai data-visualization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pipeshub-ai/pipeshub-ai.git skills-src && mkdir -p .claude/skills && cp -r skills-src/backend/python/app/agents/agent_loop/skills/builtin_packs/data-visualization .claude/skills/data-visualization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
data-visualization
GitHub stars
3.8k
Token cost
~1.1k tokens
SKILL.md length
538 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
Apache-2.0

At a glance

Picks the right chart type for a data question and applies readability rules like axis labels, colorblind palettes and legend restraint.

  • Choosing a chart type for a specific data question
  • SKILL.md covers Choosing a chart type, Readability rules (apply to…, Library choice and Before finishing
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Fixing an unreadable or poorly labeled chart

What it does

The chart type follows the shape of the question rather than habit: a bar chart for comparing a metric across categories, a line chart for a trend over time, a histogram or box plot for a distribution, a scatter plot for a relationship between two numeric variables, and a stacked bar chart over a pie chart once there are more than four or five slices to compare, since a pie chart only stays readable at two to four slices. When a question doesn't clearly map to one of these, it defaults to a bar or line chart rather than reaching for something more unusual.

Readability rules apply to every chart: always set a title and axis labels with units, only add a legend when there's more than one series to distinguish, never leave long category labels rotated to the point of being hard to read, use a colorblind-safe palette instead of a plain red-green contrast, and sort categorical bars by value unless the categories already have a natural order. matplotlib, seaborn, plotly and kaleido are already available in the sandbox, so no package install step is needed.

When your agent uses it

  • Choosing a chart type for a specific data question
  • Fixing an unreadable or poorly labeled chart
  • Picking a colorblind-safe palette for a multi-series chart

Example prompts

  • “What chart type should I use to compare revenue across five regions?”
  • “Chart this by month and make sure the axis labels show units.”
  • “Fix the rotated labels on this bar chart with long category names.”

Requirements

  • matplotlib, seaborn and plotly available in the environment

What it can do on your machine

Read from SKILL.md and the folder at commit 8e3a124. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Chart Type Selection Guide loads about 1.1k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 538 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~95
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from pipeshub-ai/pipeshub-ai at commit 8e3a124, republished under its Apache-2.0 licence (© pipeshub-ai). 538 words, ~1,097 tokens.

Download SKILL.mdSave it as .claude/skills/data-visualization/SKILL.md (or your agent's skills folder).
name
data-visualization
description
Use this skill whenever the user asks for a chart, graph, plot, or visualization of data — 'chart this by month', 'show me a breakdown by category', 'visualize the trend'. Covers picking the right chart type for the question being asked, labeling/readability rules, and which plotting library to reach for. Pair with data-analysis for the underlying data prep.

Data visualization

matplotlib, seaborn, plotly, and kaleido are already installed in the sandbox — no install_packages call needed for any workflow below.

Choosing a chart type

Pick the chart type from the question being asked, not from habit — a bar chart is not the universal default:

Question shapeChart type
Comparing a metric across categories ("revenue by region")Bar chart (horizontal if category labels are long)
Trend over time ("revenue by month")Line chart
Distribution of a single variable ("how are order sizes distributed")Histogram, or box plot for comparing distributions across groups
Relationship between two numeric variables ("does price correlate with rating")Scatter plot
Composition of a whole ("market share by segment")Stacked bar chart — prefer this over a pie chart once there are more than ~4-5 slices, since angle/area comparisons get hard to read past that; a pie chart is defensible for 2-4 slices where the "parts of a whole" framing is the entire point

If the question doesn't clearly map to one of these, default to a bar or line chart (whichever fits the data shape) rather than reaching for something more exotic — a chart the user immediately understands beats a more "interesting" one they have to puzzle over.

Readability rules (apply to every chart)

  • Always set a title and axis labels with units ("Revenue ($K)", not just "Revenue") — a chart with unlabeled axes forces the viewer to guess what they're looking at.
  • Only add a legend when there's more than one series/category to distinguish. A legend on a single-series chart is clutter.
  • Never leave x-axis labels rotated to the point of being hard to read. If category names are long, use a horizontal bar chart instead of rotating vertical bar labels 90 degrees.
  • Use a colorblind-safe palette — matplotlib's "viridis"/"cividis" colormaps or seaborn's "colorblind" palette, rather than a default red/green distinction as the only signal between two series.
  • Sort categorical bar charts by value (descending), not alphabetically, unless the categories have a natural order (months, ordinal ratings) — alphabetical order makes it harder to spot the biggest/smallest category at a glance.
Show full SKILL.md (196 more words)Show less

Library choice

  • matplotlib/seaborn → static PNG. The default choice for a chart that's going into a report, an email, or anywhere it just needs to be an image. Save via plt.savefig("chart.png", dpi=150, bbox_inches="tight") — the bbox_inches="tight" avoids clipped axis labels, a common failure mode. Saved files surface to the user automatically as artifacts; you don't need to do anything extra to hand them over.
  • plotly (+ kaleido for static export) → when the user wants interactivity (hover tooltips, zoom/pan) or explicitly asks for an HTML output. Export interactive output via fig.write_html("chart.html"); if a static image is needed instead, fig.write_image("chart.png") (uses kaleido under the hood).
  • Default to matplotlib/seaborn unless the user's request specifically implies interactivity or a web-embeddable artifact — it's the lighter-weight choice and covers the vast majority of "make me a chart" requests.

Before finishing

Look at what you actually plotted against what was asked — a common failure mode is generating a technically-valid chart of the wrong slice of data (e.g. totals instead of averages, or the wrong grouping column) because a data-analysis step upstream computed something adjacent to, but not exactly, what was requested. Re-read the user's question once more against the chart's title and axes before presenting it.

© pipeshub-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in backend/python/app/agents/agent_loop/skills/builtin_packs/data-visualization of pipeshub-ai/pipeshub-ai.

Open the folder on GitHubat commit 8e3a124

Compare with similar skills

Chart Type Selection Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Chart Type Selection Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Chart Type Selection Guide this skillpipeshub-ai/pipeshub-ai3.8k—~1.1kAutomated safety check: PassApache-2.0
MatplotlibzLanqing/codex-claude-academic-skills4.6k17 repos~2.9kAutomated safety check: PassMIT
Scientific Visualizationmims-harvard/OptimusKG14619 repos~6.3kAutomated safety check: PassMIT
SeabornzLanqing/codex-claude-academic-skills4.6k16 repos~4.9kAutomated safety check: PassBSD-3-Clause
CJK Font Setup for Plotsxjtulyc/MedgeClaw6171 repos~1.3kAutomated safety check: PassNone
Tufte Data Vizcaylent/tufte-data-viz222—~3.5kAutomated safety check: PassMIT

Similar skills

  • Matplotlib

    zLanqing/codex-claude-academic-skills

    Low-level plotting library for full customization. An agent skill from zLanqing/codex-claude-academic-skills.

    4.6k GitHub starsUsed in 17 repos~2.9k tokens
    Data & AnalyticsAuto-check passed
  • Scientific Visualization

    mims-harvard/OptimusKG

    Create publication figures with matplotlib/seaborn/plotly. An agent skill from mims-harvard/OptimusKG.

    146 GitHub starsUsed in 19 repos~6.3k tokens
    Data & AnalyticsAuto-check passed
  • Seaborn

    zLanqing/codex-claude-academic-skills

    Statistical visualization with pandas integration. An agent skill from zLanqing/codex-claude-academic-skills.

    4.6k GitHub starsUsed in 16 repos~4.9k tokens
    Data & AnalyticsAuto-check passed
  • CJK Font Setup for Plots

    xjtulyc/MedgeClaw

    Detects a usable Chinese, Japanese or Korean font and configures matplotlib so chart labels, titles and legends render instead of showing empty boxes.

    617 GitHub starsUsed in 1 repo~1.3k tokens
    Data & AnalyticsAuto-check passed
  • Tufte Data Viz

    caylent/tufte-data-viz

    A skill your agent uses when creating, reviewing, or styling charts, graphs, dashboards, sparklines, or any data visualization.

    222 GitHub stars~3.5k tokensUpdated 7 mo ago
    Data & AnalyticsAuto-check passed
  • Create and audit truthful, accessible, publication-ready scientific figures with Matplotlib, Seaborn, or Plotly.

    205 GitHub stars~3.4k tokensUpdated yesterday
    Data & AnalyticsAuto-check: notes

More from pipeshub-ai/pipeshub-ai

All 9 skills in this repo
  • PipesHub Excel Spreadsheet Builder

    pipeshub-ai/pipeshub-ai

    Creates and edits .xlsx workbooks with real Excel formulas rather than hardcoded computed values, defaulting to exceljs in TypeScript with a static formula-safety check.

    3.8k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Office Open XML Utilities

    pipeshub-ai/pipeshub-ai

    Unpacks a .docx or .pptx into pretty-printed XML, lets you make small targeted edits, and repacks it into a file Office will open.

    3.8k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Picks the right library for generating a new PDF, filling an existing PDF form, or extracting text and tables, defaulting to Node where possible.

    3.8k GitHub stars~2.9k tokensUpdated yesterday
    Auto-check passed
  • PowerPoint Deck Builder

    pipeshub-ai/pipeshub-ai

    Creates new PowerPoint decks with pptxgenjs in TypeScript, reads existing decks with python-pptx, and applies a design-quality checklist so every slide has real visual hierarchy.

    3.8k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Verified Data Analysis with pandas

    pipeshub-ai/pipeshub-ai

    Loads, cleans, aggregates and joins tabular data with pandas under a verification rule: every number reported must be one that the code actually printed.

    3.8k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Word Document Creation And Editing

    pipeshub-ai/pipeshub-ai

    Routes a Word document request to the right approach: a TypeScript library for new files, XML editing for existing ones, and plain reading only.

    3.8k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed

Questions about Chart Type Selection Guide

What does Chart Type Selection Guide do?

Picks the right chart type for a data question and applies readability rules like axis labels, colorblind palettes and legend restraint. The chart type follows the shape of the question rather than habit: a bar chart for comparing a metric across categories, a line chart for a trend over time, a histogram or box plot for a distribution, a scatter plot for a relationship between two numeric variables, and a stacked bar chart over a pie chart once there are more than four or five slices to compare, since a pie chart only stays readable at two to four slices. When a question doesn't clearly map to one of these, it defaults to a bar or line chart rather than reaching for something more unusual.

When should I use Chart Type Selection Guide?

Chart Type Selection Guide fits situations like: choosing a chart type for a specific data question; fixing an unreadable or poorly labeled chart; picking a colorblind-safe palette for a multi-series chart.

How do I install Chart Type Selection Guide in Claude Code?

Run `npx skills add pipeshub-ai/pipeshub-ai --skill data-visualization -a claude-code`. Or copy the skill folder (backend/python/app/agents/agent_loop/skills/builtin_packs/data-visualization in pipeshub-ai/pipeshub-ai) into .claude/skills/data-visualization in your project. Claude Code loads it when a task matches its description.

How do I install Chart Type Selection Guide in Codex?

Run `npx skills add pipeshub-ai/pipeshub-ai --skill data-visualization -a codex`. Or copy the skill folder (backend/python/app/agents/agent_loop/skills/builtin_packs/data-visualization in pipeshub-ai/pipeshub-ai) into .agents/skills/data-visualization in your project. Codex loads it when a task matches its description.

Can I use Chart Type Selection Guide in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pipeshub-ai/pipeshub-ai --skill data-visualization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/data-visualization, .gemini/skills/data-visualization, .github/skills/data-visualization and .opencode/skills/data-visualization in your project.

What does Chart Type Selection Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Chart Type Selection Guide is instructions for the agent only. Our summary lists: matplotlib, seaborn and plotly available in the environment.

Does Chart Type Selection Guide access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Chart Type Selection Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Chart Type Selection Guide use?

Chart Type Selection Guide is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Chart Type Selection Guide use?

About 1.1k tokens (SKILL.md is roughly 4.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Chart Type Selection Guide?

Skills that share tags, products or a category with Chart Type Selection Guide: Matplotlib (zLanqing/codex-claude-academic-skills, 4.6k stars), Scientific Visualization (mims-harvard/OptimusKG, 146 stars), Seaborn (zLanqing/codex-claude-academic-skills, 4.6k stars) and CJK Font Setup for Plots (xjtulyc/MedgeClaw, 617 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Chart Type Selection Guide?

pipeshub-ai (a GitHub organization) maintains it in pipeshub-ai/pipeshub-ai, which has 3,813 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 7, 2026.

Source: pipeshub-ai/pipeshub-ai on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.