前言¶
业务侧经常把汇总表丢过来，要「做个能点的图」或「一页看板」。自己搭 BI 工具要接数据源、配权限；手写 ECharts 或 Plotly 又要重复写维度、度量、图表类型和导出 HTML 的胶水代码。若你已经在用带 Skills 的编码 Agent，可以把「读表 → 选图 → 出页面」收成一条对话流程。下面介绍 SkillHub 上的 BI数据看板生成Skill（@user_60120345/dashboard-gen），面向本地 Excel/CSV，按你指定的维度和度量生成交互式 HTML 看板。
这是什么¶
BI数据看板生成Skill 是社区来源（community）的 data-analysis 类 Skill，当前版本 1.0.0，发布者为 user_60120345（SkillHub 页面标注作者为紫云墨竹）。标签 requires_api_key=false，表示按 SkillHub 元数据无需额外 API Key。
定位可以概括为：用户上传 Excel/CSV，说明 维度、度量和图表类型，由 Agent 按 Skill 指引 自动生成交互式 HTML 数据看板。官方简介中的典型触发说法包括：「生成看板」「做个图表」「出报表」「数据可视化」等。
核心功能¶
以下能力均来自 SkillHub 官方简介与页面说明，未超出已公开描述：
- 数据输入：支持 Excel / CSV 文件（由用户上传或在工作区提供）。
- 图表类型：柱状图、折线图、饼图、散点图，以及 KPI 卡片 和 数据表格。
- 配置方式：在对话中指定 维度、度量、图表类型，由 Skill 驱动生成逻辑。
- 交付物：交互式 HTML 看板（可在浏览器中打开查看与交互）。
SkillHub 页面当前显示评分 100000，下载 2310 次（统计以页面为准，会随时间变化）。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装到当前 Agent 的 skills 目录，或把安装提示词发给 AI 让其按官方安装文档执行。
方式一：SkillHub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时可使用官方一键脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 识别的 skills 目录；默认装到 ./skills/ 可能不会被 Agent 加载。官方文档给出的常见路径示例：
| 环境 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形如：
skillhub install user_60120345/dashboard-gen --dir ~/.cursor/skills/
将 ~/.cursor/skills/ 换成你实际使用的 Agent 路径。安装后按各客户端要求 重启或重新加载 Agent，使 Skill 生效。
方式二：让 AI 按文档安装¶
SkillHub 技能页提供的提示词为：根据 SkillHub 安装与优先源配置，安装 @user_60120345/dashboard-gen。在 Cursor 等环境中，把该句发给 Agent 即可走同一套安装流程。
官方技能页与 API 入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_60120345/dashboard-gen
- 官方地址：https://api.skillhub.cn/user_60120345/dashboard-gen
典型用法¶
资料未给出逐步截图或固定 Prompt 模板，可复现的流程与官方简介一致：
- 在已启用该 Skill 的 Agent 中，准备好 Excel 或 CSV（上传文件或放在当前项目并由 Agent 读取）。
- 用自然语言说明需求，例如：「根据这份销售表 生成看板」，并写明 维度（如地区、月份）、度量（如销售额、订单量）以及希望的 图表类型（柱状图、折线图等）。
- 让 Agent 按 Skill 生成 HTML 看板；在本地用浏览器打开输出文件，检查图表与表格、KPI 卡片是否符合预期。
若需要表格类展示或单一指标强调，可在同一次对话里点名 数据表格 或 KPI 卡片，与简介中的支持类型对齐。
适用场景与注意¶
适合谁
- 已有表格数据、希望快速得到 可分享的 HTML 看板，又不想从零写前端图表代码的开发者或分析同学。
- 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里工作，并能接受「对话里指定维度和度量」的配置方式。
限制与注意
- 输入格式以 Excel/CSV 为主；字段含义、缺失值、表头是否规范会直接影响生成结果，上传前宜先整理表结构。
- Skill 描述的是 生成 HTML 看板，并非替代企业级 BI 平台的权限、调度与多人协作；复杂 ETL 或实时数仓仍应在数据层处理后再喂给 Skill。
- 安装路径错误是常见坑：务必使用
skillhub install ... --dir <正确目录>，并确认 Agent 已加载该目录下的 Skill。 - 评分、下载量等元数据以 SkillHub 页面为准；与第三方转载数据不一致时，以官方页面为准。
结尾¶
BI数据看板生成Skill 把「表格 + 维度/度量/图表类型」收敛成 Agent 可执行的看板生成任务，输出交互式 HTML，覆盖常见图表、KPI 与表格形态，且无需 API Key。若你要在对话里完成 数据可视化 或 出报表，可从 SkillHub 安装 @user_60120345/dashboard-gen：
https://www.skillhub.cn/skills/user_60120345/dashboard-gen
