Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/security-skills --skill claude-pentest-framework -a claude-code
Open on GitHub

What 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:pentest against https://demo.testfire.net with 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-code

2Manually: put the files in place

~/.claude/skills/claude-pentest-framework/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/claude-pentest-framework/

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.

Similar skills

All skills for Security →

From the same set129

The whole set →
pentest-r1-autonomous-penetration-testing pentest-r1-autonomous-penetration-testing guides setup of a two-stage reinforcement learning pipeline for autonomous penetration testing. Ideal for training security models in interactive sandboxes. CX Codex +1 271installs solana-security-standard solana-security-standard is a Claude Code skill that detects 37 vulnerability classes in Solana and Anchor programs during development and CI. CX Codex +1 268installs jellyfin-security-plugin jellyfin-security-plugin walks your coding agent through adding two-factor login, passkeys, OIDC single sign-on and IP bans to a Jellyfin 10.11+ server. CX Codex +1 265installs deepseek-pentest-ai-burp-extension deepseek-pentest-ai-burp-extension guides configuration and usage of a DeepSeek-driven Burp Suite extension to automate parameter detection and security fuzzing. CX Codex +1 262installs pentester-mcp-security-tools pentester-mcp-security-tools connects over 200 penetration testing tools to AI coding agents via MCP. Useful for automated port scanning and directory fuzzing from chat. CX Codex +1 261installs drm-pentesting-toolkit The drm-pentesting-toolkit skill guides agents through a plugin-based DRM testing toolkit for device files, MPD manifests, and license-server requests. Use it for authorized testing. CX Codex +1 261installs skill-security-scanner skill-security-scanner audits Claude skills for command injection, unauthorized network calls, and sensitive file access before you install them. CX Codex +1 253installs gandalf-llm-pentester gandalf-llm-pentester automates security testing of prompt defenses across 7 challenge tiers on Lakera Gandalf. Useful when checking how language models resist injection attempts. CX Codex +1 252installs

Project sponsors

Companies that keep this analytics open