Pentest-Skills Framework 是由 ara.so 提供的 Security Skills 集合中的一套技能,定位为面向 AI CLI 工具的模块化渗透测试框架。它支持 Claude Code、Gemini CLI、Cursor 等 AI 命令行工具,通过自然语言命令实现专业安全测试。每个技能由知识文档、自动化脚本、参考文档和资源文件组成。
用途
该框架为渗透测试工作流提供原子级能力,主要包括两类:
- 信息收集:端口扫描、子域枚举、目录扫描、指纹识别。
- 漏洞利用:SQL 注入、XSS、LFI、文件下载漏洞。
主要能力
- 自然语言接口:用平实语言描述测试目标,由 AI 选择工具并执行。
- 自动化分析:由 AI 解读结果并生成可操作报告。
- 模块化技能:每个技能可独立加载,包含完整文档、脚本与资源。
技能结构遵循统一模式:skill-name/ 下含 SKILL.md(核心文档,触发 AI)、scripts/(Python/Bash 自动化脚本)、references/(详细工具文档)、assets/(字典、payload、wordlist 等资源)。
可用技能列表:
- recon-port-scan:端口扫描与服务识别
- recon-subdomain:子域枚举与 DNS 侦察
- recon-dir-scan:目录与文件枚举
- recon-fingerprint:Web 指纹识别与 WAF 检测
- exploit-sqli:SQL 注入检测与利用
- exploit-xss:跨站脚本检测
- exploit-lfi:本地文件包含与目录遍历
- exploit-file-download:不安全文件下载与路径遍历
安装与使用方式
前置依赖:
- 基础工具(Ubuntu/Debian):sudo apt update && sudo apt install -y nmap python3 python3-pip git
- macOS:brew install nmap python3 git
- Go 工具(子域枚举、目录扫描需要):使用 go install 安装 subfinder、dnsx、httpx、nuclei、ffuf
- 其他工具:pip3 install sqlmap xsstrike dalfox
安装技能:
Clone the repository
git clone https://github.com/crazyMarky/pentest-skills.git cd pentest-skills
Copy all skills to Claude Code skills directory
mkdir -p ~/.claude/skills cp -r * ~/.claude/skills/
Or copy specific skills
cp -r recon-port-scan ~/.claude/skills/ cp -r exploit-sqli ~/.claude/skills/
重启 AI 编码代理以加载技能。
典型使用模式:
- 端口扫描:自然语言“扫描 localhost 的开放端口并分析服务版本”;也可直接用 nmap -sV -T4 localhost,或运行 scripts/port_scanner.py。
- 子域枚举:自然语言“查找 example.com 的所有子域”;也可用 subfinder、dnsx、httpx 组合命令,或运行 scripts/subdomain_enum.py。
- SQL 注入测试:自然语言“测试该 URL 是否存在 SQL 注入”;也可用 sqlmap 命令,或运行 scripts/sqli_tester.py。
- XSS 测试:自然语言“检查该表单参数是否存在 XSS 漏洞”;也可用 xsstrike、dalfox 命令,或运行 scripts/xss_tester.py。
- 目录枚举:自然语言“枚举 http://target.com 上的目录和文件”;也可用 ffuf、gobuster、feroxbuster。
配置方式:
- 通过环境变量存放敏感数据,如 SHODAN_API_KEY、VIRUSTOTAL_API_KEY、DB_HOST/DB_USER/DB_PASS、HTTP_PROXY/HTTPS_PROXY。
- 每个技能可带 config.yaml,配置默认时序、端口、输出格式与保存路径等。
组合与扩展:
- 可将多个技能串联为完整侦察流程(如 scripts/full_recon.py:端口扫描→子域枚举→目录扫描→指纹识别,输出 JSON)。
- 可通过 scripts/generate_report.py 生成含严重性分级的 HTML 渗透测试报告。
排错要点:权限不足时可用 sudo 或加入 pcap 组;工具找不到时检查 PATH 并配置 Go bin 目录;可设置限速、代理与超时。
适用场景
仅限获得明确书面授权的系统,用于授权渗透测试、CTF 竞赛或教育目的。
限制与合规
框架明确警告:未经授权的测试违法,可能依据网络犯罪法律(如美国 CFAA、英国 Computer Misuse Act)受到处罚。使用者须获取书面授权、遵守当地法律法规,并对自身行为承担全部责任。