claude-pentest-framework — Claude Code skill: AI pentest agents
claude-pentest-framework — a Claude skill that runs a structured pentest with 15 executor agents and 63 attack categories, asking the operator for approval before anything is exploited.
no license 261 installs ★ 13 updated 2026-10-09
npx skills add reason-machines/security-skills --skill claude-pentest-framework -a claude-codeWhat claude-pentest-framework does
Fifteen executor agents work under six domain coordinators, and the whole set covers 63 attack categories. Every agent follows the same routine: gather information, propose vectors, wait for a sign-off, then run. Nothing gets exploited on the agent's own initiative.
Each finding ships with proof. A working poc.py, its captured output in poc_output.txt, HTTP evidence and Playwright screenshots, all written to outputs/{engagement}/ as JSON and markdown. Scope, attack profile and Kali settings sit in .pentest-scope.json, .pentest-attacks.json and .pentest-mks.json at the project root.
nmap, sqlmap, gobuster and Metasploit only answer through MCP-Kali-Server, deployed on a Kali Linux host and registered at an address like http://192.168.1.10:5000. Skip that host and you still get web-side checks, so network scanning takes preparation up front.
What it helps with
- map a target's attack surface before sending real traffic
- pick attack categories that fit a web app or an API
- attach a runnable PoC and HTTP evidence to each finding
- route nmap and sqlmap calls to a separate Kali box
- close the engagement with a severity-bucketed summary
Example prompts for the agent
- Run
/pentest:pentestagainsthttps://demo.testfire.netwith a 2 hour budget and Medium thoroughness - Set the engagement scope with
/pentest:pentest-scope: target, out-of-scope hosts, credentials - Do recon and injection checks on the web application profile, but hold exploitation until I approve
How to install claude-pentest-framework
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill claude-pentest-framework -a claude-code2Manually: put the files in place
~/.claude/skills/claude-pentest-framework/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/claude-pentest-framework/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill claude-pentest-framework -a codex2Manually: put the files in place
.agents/skills/claude-pentest-framework/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill claude-pentest-framework -a cursor2Manually: put the files in place
.cursor/skills/claude-pentest-framework/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/security-skills skills/claude-pentest-framework2Manually: put the files in place
.github/skills/claude-pentest-framework/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill claude-pentest-framework -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/security-skills --path skills/claude-pentest-frameworkManually: put the files in place
.devin/skills/claude-pentest-framework/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill claude-pentest-framework -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about claude-pentest-framework
How do I install claude-pentest-framework in Claude Code?
Run npx skills add reason-machines/security-skills --skill claude-pentest-framework -a claude-code. The skill file lands at ~/.claude/skills/claude-pentest-framework/SKILL.md.
What does claude-pentest-framework do?
It coordinates 15 agents across 63 attack categories and pauses for operator approval before any active exploitation. Findings come with a PoC, its output, HTTP evidence and screenshots.
Does the skill need a Kali server?
Web checks run without one. nmap, sqlmap, gobuster and Metasploit need MCP-Kali-Server deployed on a Kali host, whose address you register through /pentest:pentest-kali.