# Chart Visualization Agent Skills

> Transform complex datasets into intuitive visual charts with AntV Chart Visualization Skills, offering 26+ chart types and AI-powered generation. Start creating impactful data stories effortlessly.

- Canonical: https://nanoskill.ai/skills/chart-visualization-skills
- Markdown: https://nanoskill.ai/skills/chart-visualization-skills.md
- Author: antvis
- Published: 2026-06-09T05:00:00.000Z
- Updated: 2026-07-25T04:33:38.870Z
- Language: en
- Source type: github
- Popularity signal: 523

## Sources

- https://github.com/antvis/chart-visualization-skills

## Install

```shell
npx skills add https://github.com/antvis/chart-visualization-skills
```

## About

AntV Chart Visualization Skills offer a professional suite of visualization solutions designed to transform complex datasets into intuitive visual charts efficiently and accurately. Initiated by Ant Group, this collection of skills empowers users to navigate the entire workflow from chart design and interactive exploration to in-depth data analysis, significantly lowering the barrier to creation through intelligent design specifications and a rich library of components. It provides robust support for daily reporting, dynamic dashboards, and sophisticated interactive analysis, making data visible and understandable.

The suite includes specialized skills like "chart-visualization" for generating 26+ chart types, "infographic-creator" for transforming text into engaging visual infographics with 50+ templates, and "narrative-text-visualization" for converting unstructured data into semantically rich reports using T8 Syntax. These capabilities are further enhanced by AI integration, streamlining and automating the generation and optimization of visualizations, allowing analysts to focus more on uncovering insights and driving business decisions.

Developers can also leverage dedicated skills such as "antv-s2-expert" for multi-dimensional cross-analysis tables, "antv-g6-graph" for generating G6 v5 graph visualizations, and "antv-g2-chart" for creating G2 v5 statistical charts. These tools provide accurate, runnable code following best practices, covering core functionalities, various layout algorithms, component types, and interactions. The skills can be integrated into Node.js projects via CLI or API, offering flexibility for different development needs.

## Key features

- **Comprehensive Chart Generation**: Access 26+ intelligent chart types for diverse data visualization needs, including time series, comparisons, relationships, and geographic data.
- **AI-Powered Infographic Creation**: Generate beautiful infographics from text content using 50+ templates, transforming information into perceptible visual language with intuitive symbols.
- **Structured Narrative Text Visualizations**: Convert unstructured data into semantically rich narrative reports using T8 Syntax, a Markdown-like language for data narratives with entity annotations and mini charts.
- **Multi-Dimensional Cross-Analysis Tables**: Utilize the AntV S2 Expert for developing pivot tables, table sheets, and custom cells, offering comprehensive guidance for multi-dimensional data analysis.
- **Advanced Graph and Statistical Chart Generation**: Generate accurate G6 graph code for network, tree, and flow charts, and G2 chart code for statistical visualizations like bar, line, and pie charts, following best practices.

## Use cases

- **Create Daily Reports and Dynamic Dashboards**: Quickly transform complex datasets into intuitive visual charts for daily reporting and dynamic dashboards, enabling efficient data-driven decision-making.
- **Develop Sophisticated Interactive Analysis Tools**: Leverage AntV's robust toolkit to build advanced interactive analysis applications, providing in-depth data exploration and visualization capabilities.
- **Generate AI-Optimized Visualizations**: Streamline and automate the generation and optimization of data visualizations with integrated AI capabilities, allowing analysts to focus on insights.
- **Transform Data into Engaging Infographics**: Convert data, information, and knowledge into visually appealing infographics using a variety of templates to communicate complex ideas clearly and memorably.

## Result preview

Explore a professional AI-powered data visualization report powered by this Skill.

![A chart visualizing 'Salary Distribution by Department' using box plots for Engineering, Design, Marketing, Sales, and Support. Each box plot shows median, interquartile ranges, whiskers, and outliers, with distinct color coding for each department. The chart clearly conveys salary spread and variability across departments.](https://file.nanoskill.ai/chart-outcome-1.png)

![A line chart titled 'Cumulative Growth Trajectory' showing growth over quarters from Q1 23 to Q4 24. Data points are labeled with numerical values and connected by a green line, with a shaded area beneath to highlight cumulative increase. The chart demonstrates steady upward growth from 1,200 to 6,100.](https://file.nanoskill.ai/chart-outcome-2.png)

![A composite image containing two data visualizations. The upper chart is a scatter plot titled 'Investment vs Performance' comparing investment amounts to performance scores for three groups, represented by color-coded circular markers of varying sizes. The lower chart is a bubble chart titled 'GDP vs Life Expectancy' showing GDP per capita versus life expectancy for countries including Japan, Sweden, USA, Germany, China, Brazil, India, and Kenya. Each country is represented by a colored bubble sized by an additional variable, highlighting global economic and health disparities.](https://file.nanoskill.ai/chart-outcome-3.png)

## Result walkthrough

### Install

Add the AntV Chart Visualization Skill to your AI agent.

![A screenshot of an AI assistant terminal showing the installation of the AntV chart-visualization-skills package. The assistant logs the execution of the command to add the skills repository via 'npx skills add', confirms interactive selection with the '--yes' flag, and lists all 9 installed skills including chart generation, graph visualization, multi-dimensional tables, editing engines, infographics, narrative visualizations, and skill maintenance. The log notes symlinking into Hermes Agent and a security assessment showing low/medium risk with nothing critical.](https://file.nanoskill.ai/chart-visualization-install.png)

### Describe

Describe the topic area you want visualized, including objectives, target audience, and preferred chart types or styles.

![A screenshot of an AI assistant task panel for creating a comprehensive AntV chart visualization package. The instructions specify generating multiple chart types, infographics from textual data with templates, and narrative-style reports. Emphasis is on a clean, modern, professional style, ensuring readability, hierarchy, interactivity, dynamic dashboards, drill-down exploration, cross-analysis, and production-ready code snippets for Node.js integration. The final output should be a structured PDF or interactive dashboard, balancing aesthetic elegance with functional clarity.](https://file.nanoskill.ai/chart-visualization-task.png)

### Optimize Visualizations

The Skill generates charts and dashboards optimized for clarity, layout, and insights.

![A screenshot showing the AI assistant output after loading AntV visualization skills and preparing a professional PowerPoint deck. The assistant indicates understanding of all AntV visualization tools and plans to build a data visualization showcase featuring real data across multiple chart types, infographics, narrative visualizations, network graphs, and S2 tables, ready for presentation in PPT format.](https://file.nanoskill.ai/chart-visualization-outcome.png)

## Skill definition

# Chart Visualization Skills

Turning data into a visual language for better thinking.

## Overview

In the era of data-driven decision-making, efficient and accurate data visualization and analysis are paramount. AntV offers a professional suite of visualization solutions, providing a robust toolkit and a comprehensive set of skills for the entire workflow—from chart design and interactive exploration to in-depth data analysis. It empowers users to swiftly transform complex datasets into intuitive visual charts, significantly lowering the barrier to creation through intelligent design specifications and a rich library of components. Whether for daily reporting, dynamic dashboards, or sophisticated interactive analysis, AntV delivers reliable support. By integrating AI capabilities, these tools further streamline and automate the generation and optimization of visualizations. This allows analysts to focus more on uncovering insights and driving business decisions, truly making data visible and understandable.

> [!WARNING]
> This project only merges AI-generated code.
>
> **How to contribute:**
> 1. Submit an issue describing the problem clearly
> 2. Assign it to @copilot with your requirements

## Usage

Add this marketplace to Claude Code:
```bash
/plugin marketplace add antvis/chart-visualization-skills
```

Or you can directly install the skills for your multiple agents:

```bash
npx skills add antvis/chart-visualization-skills
```

## Available Skills

- 📊 **chart-visualization**: A comprehensive chart generation skill powered by AntV that provides 26+ chart types for intelligent data visualization.

`Chart Visualization` intelligently selects the most appropriate chart type from 26+ available options, extracts parameters based on detailed specifications, and generates high-quality chart images. It covers time series, comparisons, part-to-whole, relationships, geographic, hierarchical, statistical, and specialized visualizations.

- 🎨 **infographic-creator**: Create beautiful infographics based on given text content. Use when users request to create infographics.

`Infographic Creator` uses AntV Infographic to transform data, information, and knowledge into a perceptible visual language. It combines visual design with data visualization, providing 50+ templates including lists, sequences, hierarchies, comparisons, relations, and charts. It compresses complex information with intuitive symbols to help audiences quickly understand and remember key points.

- 🖼️ **icon-retrieval**: Search and retrieve icon SVG strings from icon library. Returns up to 5 matching icons by default (customizable).

`Icon Search` helps users find appropriate icons for various use cases including infographics, web development, design, and more. Search by keywords to discover available icons and retrieve their SVG strings directly. Each search returns up to 5 matching icons by default (customizable via topK parameter) with their URLs and complete SVG content.

- 📝 **narrative-text-visualization**: Generate structured narrative text visualizations from data using T8 Syntax.

`Narrative Text Visualization` (T8) transforms unstructured data into semantically rich narrative reports using T8 Syntax - a declarative Markdown-like language for creating data narratives with entity annotations. It's LLM-friendly and framework-agnostic, working seamlessly with HTML, React, and Vue. Perfect for creating data analysis reports, summaries, and insights documents with entities like metrics, values, trends, and dimensions properly labeled. Features include built-in mini charts, standardized styling, and professional formatting. Supports authentic data sources and provides lightweight, technology-agnostic rendering.

- 📋 **antv-s2-expert**: S2 multi-dimensional cross-analysis table development assistant. Use when users need help with S2 pivot tables, table sheets, or any @antv/s2 related development.

`AntV S2 Expert` helps users develop with the S2 multi-dimensional cross-analysis table engine. It provides comprehensive guidance on `@antv/s2` core engine, `@antv/s2-react` and `@antv/s2-vue` framework bindings, `@antv/s2-react-components` advanced analysis components, and `@antv/s2-ssr` server-side rendering. Covers pivot tables, table sheets, custom cells, theming, events, interactions, sorting, totals, tooltips, frozen rows/columns, icons, pagination, and more.

- 🕸️ **antv-g6-graph**: G6 v5 graph visualization code generator. Use when users need to generate G6 graphs — network graphs, tree graphs, flow charts, mind maps, and any relational or graph-structured data visualization with the G6 library.

`AntV G6 Graph` generates accurate, runnable G6 v5 code following best practices. It covers core graph initialization, data structures (nodes, edges, combos), 10+ layout algorithms (force, dagre, circular, grid, mindmap, fishbone, etc.), all built-in node/edge/combo types, state management, 15+ behaviors (drag-canvas, zoom-canvas, click-select, lasso, etc.), 10+ plugins (minimap, tooltip, toolbar, legend, timebar, etc.), custom element development, transforms, and animation. Built-in guard rails prevent common v4→v5 migration pitfalls such as using deprecated `G6.Graph()` constructors, `graph.data()` APIs, or Mode-based behavior configuration.

- 📈 **antv-g2-chart**: G2 v5 chart code generator. Use when users need to generate G2 charts — bar charts, line charts, pie charts, scatter plots, area charts, heatmaps, and any statistical data visualization with the G2 library.

`AntV G2 Chart` generates accurate, runnable G2 v5 code following Spec Mode best practices. It covers 30+ chart types (interval, line, area, point, rect, cell, treemap, sankey, chord, wordCloud, gauge, and more), data transforms (stackY, dodgeX, binX, fold, etc.), coordinate systems (cartesian, polar, theta, radial), scales, interactions (brush, slider, legend filter), components (axis, legend, tooltip, annotation), and multi-view compositions. Built-in guard rails prevent common v4→v5 migration pitfalls such as using deprecated chain APIs, invalid palette names, or referencing `d3` in user code.

**Evaluation Results**

Harness Engineering approach has been rigorously tested against 174 chart generation test cases, demonstrating significant improvements over baseline methods:

| **Model** | **G2** | **G6** |
| :---: | :---: | :---: |
| qwen3-coder-480b-a35b-instruct | ✨ 98.2% <sup><sub>+17.7%</sub></sup> | 94.8% <sup><sub>+15.6%</sub></sup> |
| Kimi-K2.5 | 97.7% <sup><sub>+17.2%</sub></sup> | 96.9% <sup><sub>+17.7%</sub></sup> |
| GLM-5.1 | 93.6% <sup><sub>+13.1%</sub></sup> | 92.8% <sup><sub>+13.6%</sub></sup> |
| DeepSeek-V3.2 | 90.8% <sup><sub>+10.3%</sub></sup> | ✨ 97.9% <sup><sub>+18.7%</sub></sup> |
| Context7 <sub>Baseline</sub> | 80.5% | 79.2% |

The results show that Harness Engineering enables LLMs to achieve near-production-ready accuracy (up to 98.2%), significantly outperforming the Context7 baseline approach.

> [!TIP]
> More skills are coming soon.

## Library Usage

It can be used as a library in your Node.js projects with `CLI` and `API`.

### CLI Usage

We also provide a CLI tool named `antv` for easy usage in your terminal, Install globally:

```bash
npm install -g @antv/chart-visualization-skills
```

**Retrieve or list skills by query**:

```bash
# Retrieve skills by query (metadata only)
antv retrieve "bar chart" --library g2 --topk 10

# Retrieve skills with full markdown content (core constraints auto-prepended)
antv retrieve "bar chart" --library g2 --content

# Retrieve skills and output as JSON
antv retrieve "bar chart" --library g2 --output json

# Get a skill by its exact ID
antv get g2-mark-interval-basic --library g2

# List all available skills
antv list --library g2 --category core

# List skills and output as JSON
antv list --output json

# Show skill info (core constraints from SKILL.md)
antv info --library g2

# Show skill info as JSON
antv info --library g2 --output json
```

**Usage for the command**:

```
Usage: antv [options] [command]

CLI tool for AntV chart visualization skills retrieval

Options:
  -V, --version               output the version number
  -h, --help                  display help for command

Commands:
  retrieve [options] <query>  Search for skills matching a query
  get [options] <id>          Get a skill by its exact ID
  list [options]              List all available skills
  info [options]              Show skill info from SKILL.md
  help [command]              display help for command

Options for retrieve:
  --library <lib>             Filter by library (e.g. g2, g6)
  --topk <n>                  Number of results to return (default: 7)
  --content                   Include markdown content body in results; core constraints (SKILL.md Section 1-2) are always prepended as the first result
  --output <format>           Output format: json | text (default: "text")
```

> Note: `--content` always prepends the library's core constraints (Section 1 & 2 of SKILL.md, up to the `<!-- CONSTRAINTS:END -->` marker) as the first result, ensuring the model receives essential rules alongside the reference documents.

### API Usage

```typescript
import { retrieve } from '@antv/chart-visualization-skills';

// Metadata only (no content)
const skills = retrieve('bar chart', { library: 'g2', topK: 5 });

// With full markdown content (core constraints auto-prepended as first result)
const skills = retrieve('bar chart', { library: 'g2', topK: 5, content: true });

// With content but without core constraints
const skills = retrieve('bar chart', { library: 'g2', topK: 5, content: true, includeInfo: false });
```

```typescript
retrieve(query: string, options?: RetrieveOptions): Skill[]

interface RetrieveOptions {
  library?: string;   // Library filter, e.g. 'g2' or 'g6'
  topK?: number;      // Number of results (default: 7)
  content?: boolean;  // Include markdown content body (default: false)
  includeInfo?: boolean; // Prepend SKILL.md core constraints (default: same as content)
}
```

| Option | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `library` | `string` | all | Library filter (`g2` or `g6`) |
| `topK` | `number` | `7` | Number of results |
| `content` | `boolean` | `false` | Include markdown content body |
| `includeInfo` | `boolean` | same as `content` | Prepend SKILL.md core constraints (Section 1-2) as first result |

> Notes:
> - Default retrieval returns lightweight result objects without the `content` field.
> - `content: true` returns markdown content body (frontmatter metadata is excluded).
> - When `includeInfo` is true (the default when `content: true`), the core constraints block — SKILL.md up to `<!-- CONSTRAINTS:END -->` — is injected as the first element (id prefixed with `__info__`), ensuring the model always sees the essential rules.

```typescript
import { info } from '@antv/chart-visualization-skills';

const skillInfo = info('g2');
// => { name: 'antv-g2-chart', description: '...', content: '...', constraintsContent: '...' }
```

```typescript
info(library?: string): SkillInfo | undefined

interface SkillInfo {
  name: string;
  description: string;
  content: string;            // Full SKILL.md body (after frontmatter)
  constraintsContent: string; // SKILL.md body up to <!-- CONSTRAINTS:END --> marker; injected by retrieve when includeInfo: true
}
```

| Parameter | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `library` | `string` | `'g2'` | Library to get info for (`g2` or `g6`) |

## License

MIT License - see the [LICENSE](LICENSE) file for details.

## FAQ

### What are AntV Chart Visualization Skills?

AntV Chart Visualization Skills are a suite of tools and capabilities powered by AntV, designed to help users efficiently and accurately visualize and analyze data. They include features for chart generation, infographic creation, narrative text visualization, and specialized graph and statistical chart development.

### How many chart types does the chart-visualization skill support?

The chart-visualization skill provides 26+ chart types for intelligent data visualization, covering a wide range of data representations including time series, comparisons, relationships, and geographic data.

### Can I create infographics with these skills?

Yes, the infographic-creator skill allows you to create beautiful infographics based on given text content. It uses AntV Infographic and offers 50+ templates to transform data into a perceptible visual language.

### What is Narrative Text Visualization (T8 Syntax)?

Narrative Text Visualization (T8) transforms unstructured data into semantically rich narrative reports using T8 Syntax, a declarative Markdown-like language. It's designed for creating data narratives with entity annotations, mini charts, and professional formatting, suitable for analysis reports and insights documents.

### How do AntV Chart Visualization Skills help with multi-dimensional analysis?

The antv-s2-expert skill acts as a development assistant for the S2 multi-dimensional cross-analysis table engine. It provides comprehensive guidance for working with pivot tables, table sheets, custom cells, and various other features of @antv/s2.

### Are there tools for generating specific graph and statistical charts?

Yes, the antv-g6-graph skill generates G6 v5 code for graph visualizations like network graphs, tree graphs, and flow charts. The antv-g2-chart skill generates G2 v5 code for statistical charts such as bar charts, line charts, pie charts, and scatter plots, following best practices.
