安全与治理 · 详细指南 · 验证于 2026-08-28

skillspector：详细版

AI agent 技能安全扫描器：安装前检测漏洞、恶意模式与安全配置（NVIDIA 出品）

← 快速上手（简单版） 所属问题域：安全与治理

相关组合包：安全前置（agentshield + skillspector）

相关问题：Agent 工具链全家桶能一起装吗？（17 工具 57 对实测兼容清单） ｜ pip install skillspector 找不到包（No matching distribution） ｜ Failed building wheel for yara-python（构建依赖缺失） ｜ MCP 模式 stdio 挂起（可选依赖缺失） ｜ 依赖版本冲突警告 ｜ 风险评分 >50 输出 DO NOT INSTALL ｜ 等 7 个

skillspector 详细指南

版本 2.10.0~2.10.0 ｜ 分类 security ｜ 安全（已审查） ｜ 素材：项目官方文档（英文 README）+ 本市场实测（2026-08-28）
配套：站内文档（manifest + guide + 证据）｜ 快速版：站内文档

1. 场景：什么时候会用它

SkillSpector（NVIDIA 出品，Apache-2.0，约 1.5 万星）是 AI agent 技能的安全扫描器：在安装社区技能/插件前扫描本地目录、Git 仓库、URL 或 zip，检测漏洞（如外部脚本拉取 curl | bash）、恶意模式、工具链滥用与安全配置问题，输出风险评分和修复建议。有 CLI 和 MCP server 两种形态，静态模式免 API key。

一句话：和 AgentShield（扫配置）互补——它专门扫"技能"本身干不干净。

这个工具解决什么问题：装技能前先安检。SkillSpector（NVIDIA 出品）扫描技能（SKILL.md/目录/仓库）找漏洞、恶意模式与不安全配置——装 agent-skills、superpowers 这类技能包之前，先扫一遍再启用。

什么时候用：

  • 你要从网上下载技能装进 Agent（装前扫描，装后安心）；
  • 你要静态扫描（免 API key，--no-llm）；
  • 你要把扫描作为 MCP server 接入 Agent 流程（官方形态）。

什么时候别用：只信任自己的技能、不装外部技能时——扫描器本身是只读的，装上备用即可。

和相邻工具的边界：与 agentshield（Claude Code 配置审计）互补——它扫技能内容，agentshield 扫 Agent 配置；两者都只读、无后台进程。

2. 能力清单
能力作用
技能漏洞扫描（SC2 外部脚本拉取等）见 Agent 执行版 guide
恶意模式检测见 Agent 执行版 guide
工具链滥用检测见 Agent 执行版 guide
MCP 服务器模式见 Agent 执行版 guide
LLM 语义分析（可选）见 Agent 执行版 guide
终端/JSON/Markdown 报告见 Agent 执行版 guide

3. 快速安装
note: 本环境实测路径；国内建议清华镜像
# 来源: Trove 详细指南 · 验证于 2026-08-28
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple skillspector==2.10.0
skillspector --version

预期输出: 2.10.0（无 --version 标志时以 --help 为准）

第 1 步：确认安装与静态扫描（免 key）

讲解：skillspector --version 确认版本；--no-llm 静态扫描跑出带 Score/Severity/Issues 的报告，说明核心链路通，且不需要任何 API key。

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector --version
skillspector scan ./skills/my-skill --no-llm

预期输出: 2.10.0；SkillSpector Security Report（Score/Severity/Components/Issues 清单）

卡住怎么办：

  • 报缺 key → 确认用了 --no-llm（不带它会尝试 LLM 分析，无 key 自动跳过并警告，不算错误）；
  • 命令找不到 → venv 场景先激活 venv。

第 2 步：确认 LLM 分析 / MCP 形态（按需）

讲解：不带 --no-llm 能跑出 semantic 分析器说明 LLM 链路可用（需 key）；skillspector mcp 能启动说明 MCP server 形态就位（本环境未实测）。

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector scan ./skills/my-skill

预期输出: 静态 + 语义分析报告（semantic_developer_intent/quality_policy/security_discovery；无 key 时自动跳过并警告）

卡住怎么办：

  • 无 key 时语义段缺失 → 属预期行为（自动跳过并警告），配 OPENAI_API_KEY 或 SKILLSPECTOR_PROVIDER 后重跑；
  • MCP 起不来 → 以官方文档为准（本环境未实测）。

安装变体
路径命令实测
主路径（实测）curl -sL -o skillspector-2.10.0-py3-none-any.whl https://gh-proxy.com/https://gi…✅ 本市场实测
镜像/代理见快速版与 semi_auto_note；国内安装按 skillspector 指引实测
半自动说明：实测命令 = release wheel 安装（2026-08-28 本环境 venv 验证，v2.10.0，gh-proxy 下载 wheel 476KB；pip 依赖走清华镜像）；注意：skillspector 不在 PyPI（PyPI/清华镜像均 404，pip install skillspector 必失败）——发行渠道 = GitHub Release wheel；CLI = skillspector scan/mcp/baseline；静态扫描用 --no-llm 免 API key；LLM 语义分析（semantic_* 分析器）需 OPENAI_API_KEY 或 SKILLSPECTOR_PROVIDER（可选）；无后台进程
  • Python 版本：>= 3.10；wheel 任意 Python 3 版本可用（收录实测）。
  • 只读工具：零写面、无后台进程——扫技能目录、Agent 配置都是只读，不产生残留。
  • LLM 分析：可选；无 key 用 --no-llm 静态模式即可覆盖日常安全检查。
  • 共装：与 agentshield 互补不冲突（扫技能内容 vs 扫 Agent 配置，都只读）。

4. 为什么会这样（机制与共享面）

它怎么工作：pip 包 skillspector（或 release wheel）。skillspector scan <目标> --no-llm 静态扫描（免 key），输出 SkillSpector Security Report（Score/Severity/Components/Issues 清单，含 SC2 外部脚本拉取、TM2 工具链滥用等检出）；不带 --no-llm 时尝试 LLM 语义分析（需 OPENAI_API_KEY 或 SKILLSPECTOR_PROVIDER，无 key 自动跳过并警告）。支持扫描目录/文件、Git 仓库/URL/zip（官方支持，未实测）；skillspector mcp 起 MCP server（官方形态，未实测）。

关键概念：

  • --no-llm：静态模式（免 API key）；
  • Report：Score/Severity/Components/Issues 结构化报告；
  • mcp：MCP server 形态（供 agent 工具调用）。

装完它动哪里：零写面（只读扫描器，无后台进程）。

实测命令 = release wheel 安装（2026-08-28 本环境 venv 验证，v2.10.0，gh-proxy 下载 wheel 476KB；pip 依赖走清华镜像）；注意：skillspector 不在 PyPI（PyPI/清华镜像均 404，pip install skillspector 必失败）——发行渠道 = GitHub Release wheel；CLI = skillspector scan/mcp/baseline；静态扫描用 --no-llm 免 API key；LLM 语义分析（semantic_* 分析器）需 OPENAI_API_KEY 或 SKILLSPECTOR_PROVIDER（可选）；无后台进程

5. 常用操作

第 1 步：装（为什么锁版本：2.10.0 为收录实测版本）

讲解：pip 安装（国内用清华镜像）。装完验证版本（2.10.0；若包无 --version 标志以 --help 为准）。

# 来源: Trove 详细指南 · 验证于 2026-08-28
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple skillspector==2.10.0
skillspector --version

预期输出: 2.10.0（无 --version 标志时以 --help 为准）

装好确认：

  • 版本输出或 --help 正常。

卡住怎么办：

  • pip 慢 → 确认带清华镜像前缀；
  • 命令找不到 → venv 场景先激活 venv。

第 2 步：静态扫描第一个技能目录（本环境实测，免 API key）

讲解：--no-llm 是静态模式，不需要任何 key。扫你的技能目录（如 ./skills/my-skill），输出安全报告。

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector scan ./skills/my-skill --no-llm

预期输出: SkillSpector Security Report（Score/Severity/Components/Issues 清单，含 SC2 外部脚本拉取、TM2 工具链滥用等检出）

装好确认：

  • 报告有 Score/Severity/Issues；
  • 无 key 也不报错（--no-llm 模式）。

卡住怎么办：

  • 报缺 key → 确认用了 --no-llm（不带它会尝试 LLM 分析，无 key 自动跳过并警告，不算错误）。

第 3 步：带 LLM 语义分析 / 扫远端 / MCP（按需）

讲解：不带 --no-llm 时做静态 + 语义分析（需 OPENAI_API_KEY 或 SKILLSPECTOR_PROVIDER）；扫 Git 仓库/URL/zip 官方支持（未实测）；MCP server 形态（未实测）。

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector scan ./skills/my-skill

预期输出: 静态 + 语义分析报告（semantic_developer_intent/quality_policy/security_discovery 分析器；无 key 时自动跳过并警告）

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector scan https://github.com/owner/repo

预期输出: 同报告格式（Source 显示远端地址）

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector mcp

预期输出: MCP server 启动（供 agent 工具调用）

卡住怎么办：

  • 远端仓库不可达 → 确认网络与仓库地址（官方支持形态，未实测）；
  • MCP 起不来 → 以官方文档为准（本环境未实测）。

启动与入口

CLI 按需调用；无常驻服务。

常用操作

操作一：静态扫描技能目录（本环境实测；免 API key）

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector scan ./skills/my-skill --no-llm

预期输出: SkillSpector Security Report（Score/Severity/Components/Issues 清单，含 SC2 外部脚本拉取、TM2 工具链滥用等检出）

操作二：带 LLM 语义分析（可选；需 OPENAI_API_KEY 或 SKILLSPECTOR_PROVIDER）

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector scan ./skills/my-skill

预期输出: 静态 + 语义分析报告（semantic_developer_intent/quality_policy/security_discovery 分析器；无 key 时自动跳过并警告）

操作三：扫描 Git 仓库/URL/zip（官方支持，未实测）

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector scan https://github.com/owner/repo

预期输出: 同报告格式（Source 显示远端地址）

操作四：作为 MCP 服务器接入（官方形态，未实测）

# 来源: Trove 详细指南 · 验证于 2026-08-28
skillspector mcp

预期输出: MCP server 启动（供 agent 工具调用）

数据与目录

  • 零写面：不写配置、无缓存目录（只读扫描器）。

6. 冲突逐条（摘要）

与工具页矩阵同源，共 19 对（2 实测兼容 / 17 推断可能兼容 / 0 推断可能冲突）；完整对子、状态与证据见 冲突对子（共装矩阵）。

7. 排障速查
  • 症状：pip install skillspector 找不到包（No matching distribution）
  • 症状：Failed building wheel for yara-python（构建依赖缺失）
  • 症状：MCP 模式 stdio 挂起（可选依赖缺失）
  • 症状：依赖版本冲突警告
  • 症状：风险评分 >50 输出 DO NOT INSTALL
  • 症状：semantic_* 分析器警告（缺 API key）
四段式全文（症状→原因→解法→验证证据）：站内文档

8. 卸载与残留检查

 
# 来源: Trove 详细指南 · 验证于 2026-08-28
pip uninstall -y skillspector 2>/dev/null || true
note: pip 包自动卸载（幂等）；零写面
# 来源: Trove 详细指南 · 验证于 2026-08-28
pip uninstall -y skillspector 2>/dev/null || true
command -v skillspector >/dev/null 2>&1 && echo '残留: skillspector 仍存在' || echo 'skillspector removed: OK'

预期输出: skillspector removed: OK

9. FAQ
  • 运行环境预检（需 Python >= 3.10）
  • 官方 pip/release wheel 路径（本环境实测）；国内建议清华镜像
  • 每条操作 = 一个命令块 + 预期输出
  • pip 包自动卸载（幂等）；零写面
  • 只读：扫描不写任何文件（实测零写面），适合放进 Agent 流程做安装前检查
  • 问：没有 API key 能用吗？答：能。--no-llm 静态模式免 key（本环境实测）；不带 --no-llm 时无 key 会自动跳过 LLM 分析并警告。
  • 问：扫描会改我的文件吗？答：不会。只读扫描器，零写面，无后台进程。
  • 问：和 agentshield 重复吗？答：不重复——它扫技能内容（SC2/TM2 等检出），agentshield 扫 Claude Code 配置（密钥/权限/hooks/MCP）；建议装技能后两个都跑。
  • 问：使用问题向谁反馈？答：本市场安装/卸载问题走条目反馈入口；项目自身问题请向作者仓库反馈。
  • 版本：[2.10.0, 2.10.0] 锁定（收录实测版本）。
  • 环境：Python >= 3.10；wheel 任意 Python 3 版本可用（收录实测）。
  • 网络：pip 用清华镜像（国内建议）。
  • 写面：零（只读扫描器，无后台进程）。
  • LLM 分析：可选，需 OPENAI_API_KEY 或 SKILLSPECTOR_PROVIDER；无 key 用 --no-llm 静态模式。
  • 共装：与 agentshield 互补不冲突（扫技能内容 vs 扫 Agent 配置，都只读）。

10. 出处
  • 条目签名：NVIDIA/SkillSpector（Apache-2.0，原样收录 v2.10.0）
  • 实测：实测记录（本地留存）（2026-08-28，pip 安装 + version/help + 静态扫描冒烟）。
  • 未实测：LLM 语义分析（无 key）；远端仓库扫描与 MCP 形态（命令来自官方文档）。

外部教学（来源未实测）

第三方教学未逐条实测，仅供学习；有出入以本页与官方文档为准。

收录来源（已合并）

本页内容由多篇来源文章按哈希去重、实测验证、AI 重写后合并而来——来源不散落，全部挂在这一个页面上。

暂无已合并来源：本页为本地实测与多来源重写的沉淀；来源与验证细节见站内对应方案页。

← 返回 skillspector 方案页 ｜ 安全与治理 问题域