Skill 安装
多 Agent 安装npx skills add https://github.com/anthropics/knowledge-work-plugins --skill create-viz
使用 npx skills 快速安装,支持将 Skill 添加到多个兼容的 AI Agent。
Skill 调研报告
Skill 详细介绍
create-viz 是 Anthropic 官方 knowledge-work-plugins 仓库中的一个 Skill,用于让 AI Agent 帮助用户创建可视化内容。它位于该仓库的 create-viz 目录下,名称中的 viz 是 visualization(可视化)的缩写。
这个 Skill 本质上是一套指令与工作流,不是一个独立运行的软件或服务。安装后,Agent 会获得一套关于如何将数据、概念、流程或信息转化为可视化表达的指导,从而在用户提出可视化需求时,按照更专业、更一致的方式生成结果。
核心用途:
- 把数据或信息转化为图表、图形或其他可视化形式
- 帮助用户选择适合的可视化类型
- 生成可视化所需的代码、描述或结构
- 将抽象概念、流程或关系用图形方式呈现
它不是什么:
- 它不是一个独立的绘图软件
- 它不是数据可视化库本身(如 D3、ECharts、Matplotlib)
- 它不提供托管服务或在线图表生成接口
- 它不替代用户对数据含义和展示目标的判断
典型使用场景:
- 需要把一组数据快速转成合适的图表
- 需要为一个报告或文稿设计图形化表达
- 需要把流程、架构或关系画成示意图
- 需要把一段文字描述转成可视化结构建议
工作方式:
该 Skill 通过为 Agent 注入可视化相关的指令与最佳实践来工作。当用户提出可视化需求时,Agent 会按照 Skill 中定义的思路去理解需求、选择合适的可视化形式,并输出相应的结果(例如代码、绘图描述或结构)。具体输出形式取决于用户所用的 Agent 能力以及可视化目标。
适合的用户:
- 需要快速生成图表或示意图的人
- 做报告、演示、文档时需要可视化支持的人
- 希望 Agent 在可视化任务上表现更稳定的人
不适合的需求:
- 需要精确到像素级的专业设计排版
- 需要实时交互式数据大屏
- 需要接入特定 BI 平台的生产级方案(除非 Agent 侧额外具备相关能力)
该 Skill 属于 Anthropic 官方 knowledge-work-plugins 集合的一部分,定位偏向知识工作场景下的实用辅助能力。
Skill 安全评估
总体判断:create-viz 属于指令型 Skill,本身不包含可执行程序、不申请账号、不内置网络调用,风险面较小。但实际安全性取决于它所在的 Agent 环境以及它让 Agent 生成和执行什么内容。
来源可信度:
该 Skill 来自 Anthropic 官方的 knowledge-work-plugins 仓库。相较于来源不明的第三方 Skill,官方仓库的可信度更高。仍建议在安装前确认所拉取的是官方源,而非同名 fork 或镜像。
Skill 本身的行为:
- 不内置账号体系,通常不需要 API Key 或 Token
- 不主动联网,不主动读写文件
- 不包含安装脚本或可执行二进制
需要关注的风险点:
- 生成内容的不确定性:可视化结果(尤其是生成的代码)可能包含错误或不符合用户预期,需要用户自行检查,不宜直接用于生产环境。
- Agent 权限放大:如果 Agent 同时具有 Shell、文件写入权限,它可能执行 Skill 建议的绘图命令或写入文件。是否允许应由用户按需控制。
- 提示词注入:如果用户把外部不可信数据交给 Agent 并让其可视化,理论上存在数据中夹带指令影响 Agent 行为的可能。处理不可信来源数据时应保持谨慎。
- 供应链:如果可视化方案依赖第三方绘图库(如某些 npm / pip 包),这些依赖的安全性由上游库决定,不在 create-viz 本身范围内。
降低风险的建议:
- 只从官方仓库获取该 Skill。
- 如果只需要生成可视化代码,可以关闭 Agent 自动执行 Shell 的权限,由用户手动运行生成的绘图命令。
- 对 Agent 生成的可视化代码进行审查后再运行。
- 不要把敏感数据交给来路不明的可视化流程。
Skill 使用要求
一、Agent / 客户端
create-viz 来自 Anthropic 官方 Skills 体系,主要面向 Claude Code。在 Claude Code 中使用兼容性最好。
官方没有提供完整的第三方 Agent 兼容列表。从 Agent Skill 的通用工作机制来看,在支持 Skills、自定义 Skill 或类似指令加载机制的环境中,Codex、Cursor、Trae、OpenClaw、WorkBuddy 等主流 Agent 通常也可以尝试使用,但不同 Agent 的 Skill 加载方式和兼容程度不同,实际表现以对应 Agent 当前版本为准。
二、运行环境 / 依赖
create-viz 本身是指令型 Skill,通常不强制要求本地安装特定运行时。实际需要什么,取决于它让你生成并执行的可视化结果。
| 项目 | 要求 |
| Agent | Claude Code 优先,其他兼容 Agent 可尝试 |
| Node.js | 仅当生成并运行 JS 可视化代码时需要 |
| Python | 仅当生成并运行 Python 可视化代码时需要 |
| 网络 | 仅当可视化依赖在线库或在线渲染时需要 |
官方未明确列出具体版本要求,不建议自行假设版本。
三、权限
- 文件读取:可选。取决于是否需要读取数据或已有文件。
- 文件写入:可选。取决于是否需要保存生成的图表、代码或图片。
- Shell:可选。仅当需要执行绘图脚本或渲染命令时。
- 网络:可选。仅当可视化方案需要在线资源时。
四、账号 / API Key
create-viz 本身通常不需要账号、API Key 或 Token。
需要区分的是:你后续用它生成或操作的项目是否依赖外部凭证。例如某些可视化平台或数据源可能需要登录或密钥,这属于具体项目的需求,不是该 Skill 的门槛。
最小使用条件:
- 一个支持该 Skill 的 AI Agent(Claude Code 优先)。
- 一个明确的可视化需求。
- 需要时可用的绘图运行时(Node.js 或 Python)与相应权限。
Skill 安装、使用与卸载教程
一、安装
可以直接复制本页面提供的 Skill 安装指令,粘贴到对应 Agent 或终端中执行。
如果不确定自己的 Agent 如何安装 Skill,可以直接询问当前 AI Agent:
如何安装 anthropics/knowledge-work-plugins#create-viz?
如何在 Claude Code 中安装 anthropics/knowledge-work-plugins#create-viz?
如何在 Cursor 中安装 anthropics/knowledge-work-plugins#create-viz?
让 Agent 根据自身 Skill 加载与管理机制给出安装步骤。不同 Agent 的安装方式可能不同,以其当前版本说明为准。
二、安装后如何使用
安装后,当你的需求涉及数据、信息或概念的可视化表达时,Agent 会按该 Skill 的思路来处理。
适合交给它的任务:
- 把数据转成图表
- 把流程或关系画成示意图
- 为报告或文档设计可视化方案
- 生成可视化所需的结构或代码
自然语言使用示例:
使用 create-viz,把这组月度销售数据做成合适的图表。
使用 create-viz,帮我把这个审批流程画成流程图。
使用 create-viz,为我的技术报告设计一套可视化表达方案。
三、卸载
不同 Agent 的 Skill 安装位置和管理方式可能不同。如果没有统一的卸载命令,直接询问当前 Agent 如何移除通常更稳妥:
如何卸载 anthropics/knowledge-work-plugins#create-viz?
也可以在对应 Agent 或 Skill 管理器中找到该 Skill 并删除。
常见问题
1. 安装后 Agent 没有识别到 create-viz 怎么办?
先确认安装路径是否符合当前 Agent 的 Skill 目录要求,再确认是否需要重启或重新加载 Agent。不同 Agent 对 Skill 的加载时机不同,部分需要重新启动会话后生效。
2. 可以在多个 Agent 中同时安装吗?
通常可以。Skill 以文件形式存在,多个 Agent 各自配置时互不影响。需要注意的是不同 Agent 对 Skill 格式和加载方式的支持程度可能不同。
3. Skill 更新后需要重新安装吗?
取决于你使用的安装方式。如果通过包管理器或同步源安装,通常可以随源更新;如果是手动复制的文件,需要手动替换才能更新。
4. 中国大陆使用有网络要求吗?
该 Skill 本身不主动联网,安装和使用通常不依赖特定网络环境。但如果可视化方案依赖海外服务或库(例如某些在线渲染或 CDN),可能需要考虑网络可达性。
5. create-viz 会不会修改我已有的项目文件?
它本身不会主动改动文件。是否会写文件取决于你的 Agent 权限配置以及你在任务中给出的指令。若不想让它写入,可以限制 Agent 的文件写入权限。
6. 可以关闭 Shell 权限使用吗?
可以。如果只是需要它给出可视化方案或代码,完全可以关闭 Shell 自动执行权限,由你手动运行生成的命令。这样更可控。
7. 生成的可视化结果能直接用于生产环境吗?
建议先人工检查。Agent 生成的可视化代码或方案可能存在错误、偏差或不符合实际数据语义的情况,用于生产前应经过验证。