安装
uv tool install git+https://github.com/NVIDIA/skillspector.git适合谁
SkillSpector 是 NVIDIA 在 GitHub 上提供的 AI agent skill 安全扫描器,官方定位是在安装 skill 之前检测漏洞、恶意模式与安全风险。它适合:
- 准备安装第三方 agent skill 的用户:例如从社区下载的 skill 压缩包、他人分享的仓库,想先确认里面没有恶意模式或明显漏洞,再装进本地 agent。
- 需要审查 skill 来源的维护者:扫描输入支持 Git 仓库、URL、zip 文件、目录或单个文件,能覆盖不同的分发形式。
- 本机已装有 uv,且使用的 agent 支持 MCP,希望把扫描当作 agent 可直接调用的工具的人。
不适合或需要留意的情况:
- 它只做静态检查:官方明确说明从不执行被扫描的 skill,skill 真实运行时的行为不在检查范围内,扫描通过不代表运行安全。
- 它面向 skill 包本身,不替代系统权限、依赖供应链等其他安全工作。
- 没有 uv 时,官方页面未给出其他安装方式,是否可用未确认。
- 扫描判定标准与规则覆盖范围官方未说明,未确认。
3 分钟完成第一次尝试
官方支持的最直接路径:先用 uv 从 GitHub 仓库把它装成命令行工具,再在支持 MCP 的本地 agent 里调用一次扫描。
前提:本机已安装 uv;agent 侧支持 MCP。
第 1 步,在终端执行官方安装命令:
uv tool install git+https://github.com/NVIDIA/skillspector.git
注意副作用:官方说明该项目会额外下载并安装其他第三方开源软件,确认接受后再执行。
第 2 步,把扫描接入本地 agent。官方说明它以 MCP 服务器形式运行,Claude Code、Codex CLI、Gemini CLI 这类本地 MCP agent 可以把扫描当作工具调用。MCP 服务器的具体注册方式(配置文件位置、启动命令与参数)官方页面未写明,本文不猜测,请以仓库内说明为准。
第 3 步,发起一次低风险扫描。在 agent 里用自然语言要求它扫描某个 skill 所在的目录或 zip 文件,例如:“扫描这个 skill 目录,检查有没有恶意模式和安全风险。”这是分析类操作,官方说明不会执行被扫描的 skill。
成功信号:第 1 步命令执行完毕且无报错;接入成功后,agent 能以工具形式发起扫描并拿到结果。扫描报告的具体格式与字段官方未描述,未确认,以实际返回为准。
使用案例
案例一:安装第三方 skill 前做安全预检。你从社区拿到一个 skill 的 zip 包,想装进自己的 agent。向支持 MCP 的 agent 发指令:“用扫描工具检查这个 zip 文件,报告里面的恶意模式和安全风险。”它会调用扫描流程处理这个 zip 文件(官方支持的输入类型),返回静态分析结果。你可以据此决定是否继续安装;由于检查不涉及运行,skill 的实际行为仍需自行留意。
案例二:审查自己维护的 skill 仓库。你维护一个放在 Git 仓库里的 skill,担心某次改动引入了危险模式。让 agent 扫描这个 Git 仓库或它的 URL,查看当前版本发现的问题;输入直接是仓库或 URL,不需要手动打包,适合作为合并改动后或定期执行的一次检查动作。
使用边界
- 文件与命令访问:扫描是静态分析,官方明确说明从不执行被扫描的 skill;它是否会写临时文件、是否访问网络,官方未说明,未确认。
- 安装副作用:安装命令会额外下载并安装第三方开源软件,这是执行前最明确的确认点。
- 环境与客户端前提:需要 uv;以 MCP 方式调用要求本地 agent 支持 MCP,官方点名 Claude Code、Codex CLI、Gemini CLI。其他 agent 能否使用未确认,既不应认为只限这三款,也不应认为都能用。
- 结果用途:扫描结果用于辅助判断,是否安装、如何处置仍由使用者决定;官方未说明结果能否直接作为安全审计结论,未确认。
- 尚未确认的信息:扫描报告格式、支持的操作系统、是否需要网络等官方页面未提及,使用前请以仓库最新说明为准。