跳转到使用指南
chart-visualization作者 AntV

Chart Visualization Skill.

一个用于图表和数据可视化的 Claude Code 和 Codex skill,通过 AntV API 将数据渲染为柱状图、折线图、饼图、雷达图、桑基图、思维导图和流程图。

  • Diagrams & Data Visualization
  • 图表图像
antvis/chart-visualization-skills · skills/chart-visualization/SKILL.mdSKILL.md
--- name: chart-visualization description: 将数据可视化为图表。当用户需要生成柱状图、折线图、饼图、散点图、雷达图、桑基图、思维导图、流程图等图表时调用此技能,通过 curl 工具调用 AntV API 生成图表图片 --- ## 步骤 ## 图表选择指南 ## API 接口 ## 支持的图表类型 ## 通用可选参数 ## 各图表 data 格式
从上游文件读取的前言和章节标题,2026-09-14 · 完整 3,736 字符

01 功能说明

chart-visualization Skill 在 Claude Code 和 Codex 中的作用

摘要、工作流与产物,均读自该 skill 的 SKILL.md。

来自 SKILL.md读取于 2026-09-14 · 非实际运行记录

以 skill 自身的术语

该 skill 通过调用 AntV 的图表生成 API,将用户数据转换为图表。它会分析数据以及用户的请求,从丰富的图表类型(柱状图、折线图、饼图、雷达图、桑基图、思维导图、流程图等)中选出最合适的一种,构建包含所需 type 和 source 字段的 JSON 请求体,使用 curl 调用 API,并将返回的图片 URL 以 Markdown 图片的形式输出。

它记录了约 20 种受支持图表类型各自的数据结构约定,以及 theme、width、height、title 等共用可选参数,为 Agent 提供了构建有效请求的具体参考,而不必去猜测格式。

它产出什么

  • 一个 JSON API 响应,包含一个 success 标志和一个 resultObj 图片 URL
查看示例提示词 ↗

工作方式

  1. 01
    选择图表类型

    分析用户的数据和需求,选择最合适的图表类型。

  2. 02
    构建请求体

    构建一个符合 API 规范的 JSON 请求体。

  3. 03
    调用 API

    使用 curl 工具调用 API 并生成图表图像。

  4. 04
    输出图像

    以 Markdown 图像格式输出返回的图像 URL。

02 找到适合场景

何时在 Claude Code 或 Codex 中使用 chart-visualization Skill

当工作是此类图表和图表工作时,请在 Claude Code 或 Codex 中使用 chart-visualization skill。适用范围和限制取自该 skill 的自有文件。

适合场景

  • 用折线图呈现时间序列趋势,或用面积图呈现累积趋势
  • 用条形图横向比较类别,或用柱状图纵向比较类别
  • 用饼图展示比例构成,或用矩形树图展示层级占比
  • 用桑基图映射类别间的流动关系,或用散点图展示相关性
  • 用组织架构图或思维导图呈现层级或树状结构

了解边界

  • 需要 AntV APISKILL.md 中列出了此依赖项;没有它该 skill 无法在你的项目中工作。

需要提供的信息

  • 特定图表的数据数组每种图表类型都需要特定的数据形状,例如条形图/柱状图需要 {category, value, group?} 数组,桑基图需要 {source, target, value} 数组。
  • 可选的显示参数可以提供 theme、width、height、title、style.texture,对于坐标轴图表还可提供 axisXTitle/axisYTitle,以自定义输出效果。

03 Skill 内部

chart-visualization skill 为 Claude Code 和 Codex 提供的规则

SKILL.md 为 Agent 设定的 7 条具体指令、默认值与限制——正是文件中真正改变结果的部分。

  1. 必填字段

    每个请求体都必须包含一个 type 字段,以及一个设为 "chart-visualization-skills" 的 source 字段。

  2. 固定端点

    图表通过向单一固定 API 端点发送 POST 请求生成。

  3. 默认画布尺寸

    图表宽度默认为 600,高度默认为 400,除非另行指定。

  4. 主题选项

    主题默认为 "default",也可设为 "academy" 或 "dark"。

  5. 纹理样式

    style.texture 默认为 “default”,但可以设置为 “rough” 以获得手绘风格效果。

  6. 堆叠默认值

    条形图(bar charts)默认 stack: true,而柱状图(column charts)默认 group 为 true。

  7. 输出格式

    API 响应中的 resultObj URL 必须使用该模式作为 Markdown 图片渲染。

04 投入使用

在 Claude Code 或 Codex 中安装 chart-visualization

一条 npx skills add 命令,然后在你的 Agent 中执行第一个任务和对结果的清单检查。

将 chart-visualization 添加到 Claude Code、Codex 或你的 Agent

在你的项目中运行;安装程序会询问要把它添加到哪个 Agent。

Terminal
npx skills add https://github.com/antvis/chart-visualization-skills --skill chart-visualization

用于 skills/chart-visualization/SKILL.md 的通用 skills CLI 形式;具体仓库可能会记录其自身路径。

给 Skill 分配第一个图表和图示任务

按 skill 自身的术语撰写;把括号中的部分换成你的内容。

Starter prompt
Please turn this monthly revenue data into a chart: [2025-01: 100, 2025-02: 150, 2025-03: 130]. I want to see the trend over time.

来源:依据 SKILL.md,按 skill 自身的术语撰写。

检查首次结果

SKILL.md 本身如何描述正确的结果:

  • 根据数据特征(时间序列、比较、比例、关系、层级),将所选图表类型与选择指南进行匹配

在 OpenDesign 中通过其 SKILL.md 链接导入 chart-visualization:Plugins → Add → Skill → Import from link,然后在顶部栏中选择它。

05 开源、可追溯

来源、许可与验证

本页面事实的来源,以及最后检查时间。

Author
AntV
Skill 文件
skills/chart-visualization/SKILL.md 内容校验和记录于验证时;提交 089b687
License
MIT 来自 LICENSE。
仓库星标数
489 GitHub 快照拍摄于 2026-09-14,针对整个 antvis/chart-visualization-skills 仓库,该仓库在本目录中包含 2 个 skill。不是 chart-visualization 的评分或使用次数。
已由 OpenDesign 验证
2026-09-14 已检查源文件、路径、许可文本和 star 数量。未内置在 OpenDesign 主程序(检查日期 2026-08-28);本页面未记录实际运行。

SKILL.md 内部

  1. 步骤四个步骤:分析数据、构建 JSON body、通过 curl 调用 API、输出 Markdown 图片
  2. 图表选择指南将数据特征(时间序列、比较、比例、关系、层级)映射到图表类型
  3. API 接口描述 POST 端点、必填字段,以及一个 curl 请求/响应示例
  4. 支持的图表类型按类别分组列出所有受支持图表类型的表格
  5. 通用可选参数共享的可选参数(theme、width、height、title、texture)及其默认值
  6. 各图表 data 格式每种图表类型所需的确切数据结构及可选字段
Skill 自身的描述
"将数据可视化为图表。当用户需要生成柱状图、折线图、饼图、散点图、雷达图、桑基图、思维导图、流程图等图表时调用此技能,通过 curl 工具调用 AntV API 生成图表图片"

SKILL.md 的 front-matter 描述。完整文件约 3,736 个字符。在 GitHub 上阅读完整文件。

06 安装之前

关于 chart-visualization Skill 的常见问题

以下回答来自 2026-09-14 读取到的 SKILL.md,而非某次实际运行的记录。

这个 skill 可以生成哪些图表类型

它支持广泛的图表目录,包括条形图(bar)、柱状图(column)、瀑布图(waterfall)、双轴图(dual-axes)、面积图(area)、折线图(line)、散点图(scatter)、箱线图(boxplot)、直方图(histogram)、小提琴图(violin)、漏斗图(funnel)、饼图(pie)、水波图(liquid)、词云(word-cloud)、组织架构图(organization-chart)、思维导图(mind-map)、矩形树图(treemap)、桑基图(sankey)、网络图(network-graph)、venn 图、流程图(flow-diagram)、鱼骨图(fishbone-diagram)、雷达图(radar)以及电子表格(spreadsheet)。

输出结果是什么格式

API 返回一个包含 resultObj URL 的 JSON 对象,该 skill 随后将其输出为 Markdown 图片链接。

Chart Visualization

在真实的图表和数据可视化任务中运行 chart-visualization。

下载 OpenDesign,从其 SKILL.md 链接导入 chart-visualization,粘贴上面的提示,在查看结果前先阅读计划。

终端
npx skills add https://github.com/antvis/chart-visualization-skills --skill chart-visualization

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows