前言¶
做数据分析时，常见流程是：先读 CSV 或数据库结果，再手动选图表类型，最后用 Python（matplotlib、Plotly）或 BI 工具出图。图表选错、样式不统一、交付物只是静态 PNG 的情况很常见。若希望 Agent 根据数据特征自动推荐图表组合，并直接生成交互式 HTML 仪表板，可以把「画图 + 排版 + 导出」交给专门的 Skill，而不是在对话里反复描述绘图细节。
下面介绍 SkillHub 上的 智能数据可视化（坐标 @user_af28adda/generate-chart），以及如何在 Cursor 等环境中安装与使用。
这是什么¶
智能数据可视化 是 SkillHub 社区 Skill（发布者 user_af28adda，分类 data-analysis，当前版本 1.0.0）。页面标注 requires_api_key=false，安装后一般不需要额外配置第三方 API Key。
一句话定位：面向 AI 辅助的数据可视化——根据数据特征分析并推荐合适的图表组合，输出 交互式 HTML 仪表板。
- 官方 Skill 页：https://www.skillhub.cn/skills/user_af28adda/generate-chart
- 安装线索地址：https://api.skillhub.cn/user_af28adda/generate-chart
核心功能¶
以下能力均来自 SkillHub 页面简介，未在资料中出现的细节不作延伸。
- 多类图表：柱状图、折线图、饼图、散点图、直方图、箱线图、小提琴图、面积图、热力图、平行坐标图、旭日图等。
- 自动分析与推荐：根据数据特征分析，并推荐较合适的图表组合（具体推荐逻辑以 Skill 内说明为准）。
- 交付形态：生成 交互式 HTML 仪表板，便于在浏览器中查看与交互，而非仅输出静态图片。
SkillHub 统计（以脚本抓取页面为准，随平台更新可能变化）：评分 100000，下载 62112，安装 160。
安装与启用¶
SkillHub 官方安装说明见 https://skillhub.cn/install/skillhub.md。下面按「先 CLI、再装 Skill、再指向 Agent 目录」的顺序说明。
1. 检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本 Skill¶
安装时必须用 --dir 指向 当前 Agent 实际使用的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法加载。
skillhub install @user_af28adda/generate-chart --dir <你的 skills 目录>
常见客户端路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中，示例为：
skillhub install @user_af28adda/generate-chart --dir ~/.cursor/skills/
3. 通过对话让 AI 安装（可选）¶
SkillHub 页面也提供提示词方式：让 AI 根据 skillhub.md 安装 @user_af28adda/generate-chart。效果与上述 CLI 安装一致，关键是最终 Skill 文件落在正确的 skills 目录。
安装或更新 Skill 后，按你使用的 Agent 要求 重启或刷新会话，以便加载新 Skill。
典型用法¶
公开资料未提供单独的 SKILL.md 正文示例；用法应围绕简介中的能力来理解。
- 准备数据：在对话中提供表格数据（如 CSV 片段、查询结果、字段说明），或说明数据来源与希望回答的分析问题。
- 触发 Skill：在已启用该 Skill 的 Agent 会话中，明确要做「数据可视化 / 生成图表仪表板」类任务，由 Skill 指导模型完成分析与出图。
- 查看结果：预期产出为 交互式 HTML 仪表板；在 Agent 写入工作区后，用浏览器打开对应 HTML 文件查看交互效果。
若 Skill 内还有更细的触发词、输出路径或依赖（如 Python 库），以安装到本地的 Skill 文档为准；在线页面未列出部分不在此臆测。
适用场景与注意¶
适合：
- 探索性数据分析（EDA），需要快速尝试多种图表类型。
- 需要把分析结果以 可交互 HTML 形式交付，而不是单张静态图。
- 希望减少「选哪种图、怎么组合」的手动决策，交给 Skill 与模型根据数据特征推荐。
注意：
- 数据量过大或字段含义不清时，推荐图表可能偏离预期，需要你在对话中补充业务语义或抽样数据。
- HTML 仪表板依赖本地或部署环境的浏览器打开；若项目有安全策略，注意勿将敏感数据写入可被公开访问的路径。
- 社区 Skill（
source: community），行为与维护节奏以发布者与 SkillHub 版本为准；使用前可在 SkillHub 页核对版本 1.0.0 与更新说明。
结尾¶
智能数据可视化 把「选图、组合、生成交互式 HTML 仪表板」封装成 Agent Skill，适合在 Cursor、Claude Code、Codex 等支持 Skill 的环境里，用 @user_af28adda/generate-chart 处理表格类数据。安装与目录配置以 SkillHub 官方文档为准；功能与统计以 SkillHub 技能页为准。
