cisco-ai-defense/skill-scanner

这是什么？

核心功能

• 01结合 YAML 与 YARA-X 规则检测与 AST、数据流分析。
• 02可选 LLM 裁判对告警做语义复核，支持多种模型提供方。
• 03支持 JSON、Markdown、SARIF 和交互式 HTML 报告输出。
• 04提供可复用的 GitHub Actions 工作流与 pre-commit 钩子。
• 05支持策略预设和自定义 YAML 策略，用于调节误报。

适用场景

• 安装第三方 Agent 技能前进行安全审查。
• 在 CI 中通过 SARIF 结果在 GitHub Code Scanning 中拦截风险改动。
• 借助 pre-commit 在每次提交时扫描团队的技能仓库。
• 批量审计技能目录，并检查技能之间的描述重叠。

快速上手

1. 1

   使用 uv 安装扫描器

   uv pip install cisco-ai-skill-scanner
2. 2

   设置 LLM 判定器的 API 密钥

   export SKILL_SCANNER_LLM_API_KEY="your_api_key"
3. 3

   使用 LLM 判定器和 balanced 预设扫描一个技能

   skill-scanner scan /path/to/skill --use-llm --policy balanced --fail-on-severity high

使用前须知

• !仅提供尽力而为的检测；没有发现问题并不保证技能安全。
• !推荐方案需要 LLM 判定器的 API 密钥，因为仅靠规则只能发现约 8% 的held-out恶意技能。
• !元数据中许可证显示为 NOASSERTION，使用前应自行核实许可条款。

收录于专题

标签

常见问题

skill-scanner 是什么？

面向 AI Agent Skills 的best-effort安全扫描器，用于检测提示注入、数据外泄和恶意代码模式。 Skill Scanner 用于在安装或分享 AI Agent Skills 之前检查其中的风险内容。它结合了基于模式的检测（YAML 与 YARA-X 规则）、对 Python 代码的 AST 与数据流分析，以及可选的 LLM 语义复核。扫描结果可输出为 JSON、Markdown、SARIF 或可交互的 HTML 报告。

skill-scanner 可以免费使用吗？用的什么许可证？

skill-scanner 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

skill-scanner 还在维护吗？

活跃维护中。skill-scanner 最近一次提交是在 2026年11月6日。

skill-scanner 适合用来做什么？

安装第三方 Agent 技能前进行安全审查。 在 CI 中通过 SARIF 结果在 GitHub Code Scanning 中拦截风险改动。 借助 pre-commit 在每次提交时扫描团队的技能仓库。 批量审计技能目录，并检查技能之间的描述重叠。

skill-scanner 怎么安装和运行？

使用 uv 安装扫描器: uv pip install cisco-ai-skill-scanner 设置 LLM 判定器的 API 密钥: export SKILL_SCANNER_LLM_API_KEY="your_api_key" 使用 LLM 判定器和 balanced 预设扫描一个技能: skill-scanner scan /path/to/skill --use-llm --policy balanced --fail-on-severity high

在哪里获取 skill-scanner？

源代码和安装说明在 GitHub 上：https://github.com/cisco-ai-defense/skill-scanner