ava-skills
๐พ AI-native Visual Analytics framework build for agents.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/antvis/AVA with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/antvis/AVA'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/antvis--ava)HTML
<a href="/listings/antvis--ava"><img src="/api/listings/antvis--ava/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
๐ฆ Installation
Install the v4 beta with Node.js 22.13+:
npm install @antv/ava@beta
๐ป Usage
Investigate a monthly sales decline: measure the change, identify the largest contributors, and visualize the breakdown.
Load data
Download [sales.csv](__tests__/datasets/sales.csv) to your working directory. The sample contains 240 orders across 2025, with products, regions, channels, sales, and profit.
import { AVA } from '@antv/ava';
const ava = new AVA({
llm: {
model: '<your-model>',
apiKey: '<your-api-key>',
// baseURL: '<your-provider-api-url>',
},
});
await ava.source({ type: 'csv-file', options: { path: './sales.csv' } });Ask questions
Measure the overall change using `sales`, the amount after discounts:
const overview = await ava.analyze(` Compare total sales in January and February 2025 using the sales column. Include the change and percentage change. `); console.log(overview.text);
Expected: sales fell from **38,897.18 to 21,804.11**, down **17,093.07 (43.94%)**.
Find the products contributing to the decline:
const result = await ava.analyze(` Compare January and February 2025 sales by product using the sales column. Show both months and the change, ordered by the largest decline. `); console.log(result.text); console.table(result.data);
Expected breakdown:
| Product | January sales | February sales | Change | | --- | ---: | ---: | ---: | | Laptop | 19,688.10 | 3,596.00 | โ16,092.10 | | Standing Desk | 9,655.80 | 5,546.10 | โ4,109.70 | | Monitor | 6,536.25 | 4,731.00 | โ1,805.25 | | Pen Set | 232.20 | 127.71 | โ104.49 | | Bookshelf | 1,225.50 | 1,251.30 | +25.80 | | Copy Paper | 59.19 | 137.06 | +77.87 | | Notebook | 31.50 | 137.03 | +105.53 | | Keyboard | 215.64 | 1,015.31 | +799.67 | | Office Chair | 1,253.00 | 5,262.60 | +4,009.60 |
Laptops contributed the largest decline, while office chairs delivered the largest increase.
Visualize charts
Chart each product's contribution to the sales change:
import { writeFile } from 'node:fs/promises';
const chart = await ava.visualize({
query: 'Plot the sales change by product from January to February 2025 as a bar chart.',
data: result.data,
});
if (chart) {
await writeFile('sales-change.html', chart.html);
}Open `sales-change.html` in a browser with internet access.
Find questions to explore
Get suggested questions for your data:
const suggestions = await ava.suggest(); console.log(suggestions);
> ๐ก **Suggested questions** > > How do sales change month by month? > > Which products contribute the most profit? > > How do sales compare across channels?
Understand your data
Check missing values and sales ranges:
console.log(await ava.schema());
console.log(await ava.profile({ metrics: ['row_count', 'null_count', 'min', 'max'] }));The sample has one missing `region` and one missing `quantity`.
Release resources when finished:
await ava.dispose();
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json ยท Manifest ยท 19 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "ava-skills",
- "owner": {
- "name": "AntV Visualization Team"
- },
- "metadata": {
- "description": "AVA skills for data analysis and visualization",
- "version": "1.0.0"
- },
- "plugins": [
- {
- "name": "ava",
- "description": "Explore, query, analyze, and visualize structured data with the AVA CLI.",
- "source": "./",
- "strict": false,
- "skills": ["./skills/ava"]
- }
- ]
- }
README.md ยท README ยท 277 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- **English** | [็ฎไฝไธญๆ](./README.zh-CN.md)
- <div align="center">
- <h1>AVA, AI-native Visual Analytics</h1>
- <img width="200" height="120" src="https://mdn.alipayobjects.com/huamei_qa8qxu/afts/img/A*yOHIQ48aRwgAAAAAAAAAAAAADmJ7AQ/original" alt="AVA logo">
- </div>
- <p align="center">
- <a href="https://ava.antv.vision">
- <img src="https://img.shields.io/badge/Website-2F54EB?style=for-the-badge" alt="Website" />
- </a>
- <a href="https://ava.antv.vision/documentation/">
- <img src="https://img.shields.io/badge/Docs-722ED1?style=for-the-badge" alt="Documentation" />
- </a>
- <a href="https://ava.antv.vision/ai/">
- <img src="https://img.shields.io/badge/AI%20Agent-EB2F96?style=for-the-badge" alt="AI Agent" />
- </a>
- <a href="https://sive.antv.antgroup.com/" title="A data analysis app built with AVA">
- <img src="https://img.shields.io/badge/Try%20Sive-13A8A8?style=for-the-badge" alt="Try Sive" />
- </a>
- <a href="https://github.com/antvis/ava">
- <img src="https://img.shields.io/badge/GitHub-000000?style=for-the-badge&logo=github&logoColor=white" alt="GitHub" />
- </a>
- <a href="https://ava.antv.vision/llms.txt">
- <img src="https://img.shields.io/badge/LLMS-FA8C16?style=for-the-badge" alt="llms" />
- </a>
- </p>
- [AVA](https://github.com/antvis/AVA) (<img src="https://mdn.alipayobjects.com/huamei_qa8qxu/afts/img/A*QzIsSrfsCW0AAAAAAAAAAAAADmJ7AQ/original" width="16" alt="AVA examples"> Visual Analytics) is a technology framework designed for more convenient visual analytics. **A** stands for AI-native, Automated, and Augmented; **VA** stands for Visual Analytics.
- <p align="center">
- <a href="https://ava.antv.vision/">
- <img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*MMXYTJ0KhukAAAAAgEAAAAgAegfkAQ/original" width="100%" alt="AVA agent workflow: data access, schema inspection, profiling, metric definitions, analysis, visualization, and follow-up questions, with verifiable SQL and results." />
- </a>
- </p>
- > [!NOTE]
- > **Think of AVA as PandasAI for JavaScript. ๐ฌ๐๐ค**
- >
- > It brings natural-language data analysis and visualization to your apps and AI agents.
- ## โจ Why AVA?
- <table width="100%">
- <tr>
- <td width="33%" valign="top">
- <h3>๐ Analysis across data sources</h3>
- <p>Join data from files and databases <strong>in a single query</strong>.</p>
- <a href="https://ava.antv.vision/documentation/data/sources/#connect-multiple-sources">Connect multiple sources โ</a>
- </td>
- <td width="33%" valign="top">
- <h3>๐ Grounded answers</h3>
- <p>Inspect the <strong>queries and results</strong> behind each answer.</p>
- <a href="https://ava.antv.vision/documentation/analysis/overview/">Trusted analysis โ</a>
- </td>
- <td width="33%" valign="top">
- <h3>๐ Smart visualization</h3>
- <p>Get charts guided by <strong>your question and data</strong>.</p>
- <a href="https://ava.antv.vision/documentation/visualization/overview/">Visualization โ</a>
- </td>
- </tr>
- <tr>
- <td width="33%" valign="top">
- <h3>๐ป Local execution</h3>
- <p>Choose <strong>where analysis runs</strong> and which model endpoint it uses.</p>
- <a href="https://ava.antv.vision/documentation/engines/overview/">Execution engines โ</a>
- </td>
- <td width="33%" valign="top">
- <h3>๐ฏ Published benchmarks</h3>
- <p>Check accuracy against <strong>reference answers</strong> under published test conditions.</p>
- <a href="https://ava.antv.vision/documentation/reference/benchmarks/">Benchmarks โ</a>
- </td>
- <td width="33%" valign="top">
- <h3>๐ค Agent integration</h3>
- <p>Your agent reasons; <strong>AVA executes</strong> the data workflow.</p>
- <a href="https://ava.antv.vision/documentation/agent-skill/">Agent integration โ</a>
- </td>
- </tr>
- </table>
- ## ๐ Getting started
- Install AVA with Node.js 22.13+:
- ```bash
- npm install @antv/ava
- ```
- ## ๐ป Usage
- Download [sales.csv](__tests__/datasets/sales.csv) and configure your model:
- ```typescript
- import { AVA } from '@antv/ava';
- const ava = new AVA({
- llm: {
- model: '<your-model>',
- apiKey: '<your-api-key>',
- // baseURL: '<your-provider-api-url>',
- },
- });
- ```
- ### 1. Load
- ```typescript
- await ava.source({ type: 'csv-file', options: { path: './sales.csv' } });
- ```
- > [!NOTE]
- > **Data preview**
- >
- > First 3 of 240 rows, selected columns:
- >
- > | order_date | product | sales |
- > | --- | --- | ---: |
- > | 2025-01-01 | Monitor | 224.10 |
- > | 2025-01-02 | Office Chair | 680.20 |
- > | 2025-01-04 | Monitor | 2,191.20 |
- ### 2. Explore
- Inspect the structure and data quality, then add [business definitions](https://ava.antv.vision/documentation/data/semantic/):
- ```typescript
- const schema = await ava.schema();
- const profile = await ava.profile({ metrics: ['row_count', 'null_count'] });
- await ava.semantic(undefined, () => ({
- description: 'Use the sales column for amounts after discounts and order_date for monthly comparisons.',
- }));
- ```
- > [!NOTE]
- > **Analysis context**
- >
- > | Context | Details |
- > | --- | --- |
- > | Structure | `data`: 12 columns |
- > | Quality | 240 rows; 1 missing `region` and 1 missing `quantity` |
- > | Semantics | `sales` is after discounts; monthly comparisons use `order_date` |
- ### 3. Suggest
- ```typescript
- const suggestions = await ava.suggest(3);
- ```
- > [!NOTE]
- > **Suggested questions** (examples)
- >
- > - How did sales change from January to February 2025?
- > - Which products contributed most to the sales decline?
- > - How do sales and profit vary by region?
- ### 4. Analyze
- ```typescript
- const result = await ava.analyze(
- 'Compare January and February 2025 sales by product. Show both months and the change, ordered by the largest decline.'
- );
- ```
- > [!NOTE]
- > **Analysis result**
- >
- > Total sales fell **43.94%**, led by a **16,092.10** decline in laptop sales.
- >
- > First 3 of 9 products:
- >
- > | Product | January sales | February sales | Change |
- > | --- | ---: | ---: | ---: |
- > | Laptop | 19,688.10 | 3,596.00 | โ16,092.10 |
- > | Standing Desk | 9,655.80 | 5,546.10 | โ4,109.70 |
- > | Monitor | 6,536.25 | 4,731.00 | โ1,805.25 |
- ### 5. Visualize
- ```typescript
- const chart = await ava.visualize({
- query: 'Plot the sales change by product from January to February 2025 as a bar chart.',
- data: result.data,
- });
- ```
- > [!NOTE]
- > **Chart preview**
- >
- > <img src=".github/assets/sales-change.png" width="800" alt="Sales change by product from January to February 2025, with decreases in red and increases in green.">
- >
- > *Powered by [GPT-Vis](https://gpt-vis.antv.vision/).*
- ## ๐ Connect your data
- <table width="100%">
- <tr>
- <td align="center" width="12.5%"><a href="https://ava.antv.vision/documentation/data/sources/#csv"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*SEIZRJCeCuYAAAAAQBAAAAgAegfkAQ/original" width="32" height="32" alt="CSV" /><br />CSV</a></td>
- <td align="center" width="12.5%"><a href="https://ava.antv.vision/documentation/data/sources/#json"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*VBNjQJDMvMIAAAAAHYAAAAgAegfkAQ/original" width="32" height="32" alt="JSON" /><br />JSON</a></td>
- <td align="center" width="12.5%"><a href="https://ava.antv.vision/documentation/data/sources/#parquet"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*-_h8RrPPA54AAAAAFkAAAAgAegfkAQ/original" width="32" height="32" alt="Parquet" /><br />Parquet</a></td>
- <td align="center" width="12.5%"><a href="https://ava.antv.vision/documentation/data/sources/#excel"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*GfCXT7Mb_5gAAAAAQCAAAAgAegfkAQ/original" width="32" height="32" alt="Excel" /><br />Excel</a></td>
- <td align="center" width="12.5%"><a href="https://ava.antv.vision/documentation/data/sources/#text"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*XrY8SK_9fGwAAAAAEsAAAAgAegfkAQ/original" width="32" height="32" alt="Text" /><br />Text</a></td>
- <td align="center" width="12.5%"><a href="https://ava.antv.vision/documentation/data/online-services/feishu-bitable/"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*Rly3Rou8Wv8AAAAAQFAAAAgAegfkAQ/original" width="32" height="32" alt="Feishu Bitable" /><br />Feishu Bitable</a></td>
- <td align="center" width="12.5%"><a href="https://ava.antv.vision/documentation/data/online-services/tencent-smartsheet/"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*wH-PT4nF70wAAAAAMkAAAAgAegfkAQ/original" width="32" height="32" alt="Tencent Docs" /><br />Tencent Docs</a></td>
- <td align="center" width="12.5%"><a href="https://ava.antv.vision/documentation/data/online-services/github/"><img src="site/public/logos/github.svg" width="32" height="32" alt="GitHub" /><br />GitHub</a></td>
- </tr>
- <tr>
- <td align="center"><a href="https://ava.antv.vision/documentation/data/sources/#sqlite"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*3xulRYi0wWkAAAAAQBAAAAgAegfkAQ/original" width="32" height="32" alt="SQLite" /><br />SQLite</a></td>
- <td align="center"><a href="https://ava.antv.vision/documentation/data/sources/#mysql"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*8TDeSpgXAi0AAAAAQEAAAAgAegfkAQ/original" width="32" height="32" alt="MySQL" /><br />MySQL</a></td>
- <td align="center"><a href="https://ava.antv.vision/documentation/data/sources/#postgresql"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*h6xsS5N0EbcAAAAAQFAAAAgAegfkAQ/original" width="32" height="32" alt="PostgreSQL" /><br />PostgreSQL</a></td>
- <td align="center"><a href="https://ava.antv.vision/documentation/data/sources/#sql-server"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*XVBPSaYT6p0AAAAAQJAAAAgAegfkAQ/original" width="32" height="32" alt="SQL Server" /><br />SQL Server</a></td>
- <td align="center"><a href="https://ava.antv.vision/documentation/data/sources/#mongodb"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*5VYbTakXL7EAAAAAIlAAAAgAegfkAQ/original" width="32" height="32" alt="MongoDB" /><br />MongoDB</a></td>
- <td align="center"><a href="https://ava.antv.vision/documentation/data/sources/#supabase"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*IWbeTqNDuu4AAAAAFFAAAAgAegfkAQ/original" width="32" height="32" alt="Supabase" /><br />Supabase</a></td>
- <td align="center"><a href="https://ava.antv.vision/documentation/data/sources/#clickhouse"><img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*o0VuQ5NvHZ8AAAAAELAAAAgAegfkAQ/original" width="32" height="32" alt="ClickHouse" /><br />ClickHouse</a></td>
- <td align="center"><a href="https://ava.antv.vision/documentation/data/sources/#snowflake"><img src="site/public/logos/snowflake.svg" width="32" height="32" alt="Snowflake" /><br />Snowflake</a></td>
- </tr>
- </table>
- > [!TIP]
- > **Missing a data source? ๐ก๐ ๏ธ**
- >
- > **[๐ฌ Open an issue](https://github.com/antvis/AVA/issues/new/choose)** ยท **[๐ ๏ธ Submit a pull request](https://github.com/antvis/AVA/compare)**
- ## ๐ฏ Benchmarks
- We evaluate AVA on established benchmarks to measure the accuracy and efficiency of its data analysis.
- <img src="https://mdn.alipayobjects.com/huamei_aphk1k/afts/img/A*XjhtSbWcb70AAAAAUlAAAAgAegfkAQ/original" width="100%" alt="DataBench and Spider2-Lite evaluation results comparing raw data, schema and profile, and semantic context.">
- [Evaluation setup and reports โ](https://ava.antv.vision/documentation/reference/benchmarks/)
- ## ๐งฉ More ways to use AVA
- ### Use with an Agent
- Ask your AI agent:
- ```text
- Install the AVA skill with `npx skills add antvis/AVA`, then follow its setup instructions.
- ```
- [Agent setup guide โ](https://ava.antv.vision/documentation/agent-skill/)
- ### Use from the CLI
- Load and analyze data from your terminal:
- ```bash
- ava source ./sales.csv
- ava analyze '<dataset-id>' 'Compare January and February 2025 sales by product.'
- ```
- See the [CLI guide](https://ava.antv.vision/documentation/reference/cli/) for setup and commands.
- ## ๐ Resources
- - [Documentation](https://ava.antv.vision/documentation/) โ Guides and examples
- - [Analysis strategies](https://ava.antv.vision/documentation/analysis/strategies/) โ Direct and loop execution
- - [API Reference](https://ava.antv.vision/documentation/reference/api/) โ Methods and configuration
- - [AI](https://ava.antv.vision/ai/) โ Try out AVA in the browser environment
- - [Benchmarks](https://ava.antv.vision/documentation/reference/benchmarks/) โ Evaluation results
- - [Issues](https://github.com/antvis/AVA/issues) โ Bug reports and feature requests
- ## ๐ค๐ ๏ธ Contributing
- Contributions are welcome. Include tests, examples, and documentation with new features.
- Run `npm test` to test your changes. For model-backed tests, copy `.env.example` to `.env` and add your model settings.
- ## ๐ Papers
- [VizLinter](https://vegalite-linter.idvxlab.com/) - Chen, Q., Sun, F., Xu, X., Chen, Z., Wang, J. and Cao, N., 2021. VizLinter: A Linter and Fixer Framework for Data Visualization. *IEEE transactions on visualization and computer graphics*, 28(1), pp.206-216.
- [ใๆฐๆฎๅฏ่งๅ่ฎพ่ฎก็็ฑปๅๅญฆๅฎ่ทตใ๏ผExploring the Typology of Visualization Design๏ผ](https://oversea.cnki.net/KCMS/detail/detail.aspx?dbcode=CJFD&dbname=CJFDAUTO&filename=MSDG202203021&uniplatform=OVERSEAS_EN&v=HcZsiecIxauSoKEB1s92_BImgnrMiazYsfZUpb-gcl0zXYx_MEwv5alz1UgtPjz1) - ่ๆๅฎ, ็ๅๅ. ๆฐๆฎๅฏ่งๅ่ฎพ่ฎก็็ฑปๅๅญฆๅฎ่ทต, ใ็พๆฏๅคง่งใ, 2022(3), 149-152.
- ## โ๏ธ License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itโs helped, pass it on.