h-pentest-ai-platform — Claude Code skill: what it does
h-pentest-ai-platform — a skill that walks an agent through standing up H-Pentest: five LLM roles plan the test, suggest payloads, scan with Nuclei and write up what they find.
no license 248 installs ★ 13 updated 2026-10-09
npx skills add reason-machines/security-skills --skill h-pentest-ai-platform -a claude-codeWhat h-pentest-ai-platform does
The skill teaches your agent to stand up and drive H-Pentest, a pentest platform split across five LLM roles. A meta supervisor calls time on the run, a strategic one redraws the plan each round, a worker follows a reason-act-observe loop, a payload role offers vectors every 3 rounds, and a report role turns the transcript into attack paths. Behind them sits a knowledge base of 52+ attack documents covering IDOR, SQL injection, XSS, SSRF, XXE and file upload, fetched through retrieval.
Docker Compose brings the whole thing up, or you can run the pieces yourself: the Python backend needs pip install -r requirements.txt and python init_db.py, the frontend runs on npm. The API listens on http://localhost:8000 with docs at /docs, the UI on http://localhost:5173. Progress arrives over WebSocket, and a message to the intervention endpoint nudges a running agent. Python code runs inside a Docker sandbox alongside Nuclei and a directory scanner.
Both keys live in config.json: openai.api_key for the models, dashscope.api_key for embeddings. Knowledge-base search depends on the second one. There are two modes, ctf and realworld, and the meta supervisor takes the choice into account. Sandbox limits sit in the same file: execute_python gets 30 seconds and 512m of memory, Nuclei runs at critical, high and medium severity.
What it helps with
- bring the platform up from a Compose file
- create a
ctftask against a target URL - look up a bypass technique in the attack knowledge base
- wire Nuclei into the agent and filter findings by severity
- step into a running agent and point it at another endpoint
Example prompts for the agent
- Set up H-Pentest with Docker Compose and tell me which keys go into
config.json. - Create a
ctftask forhttp://target-ctf.example.comwith 25 rounds and follow it over WebSocket. - Run a
realworldscan on the staging app and send the worker to the/api/adminendpoint.
How to install h-pentest-ai-platform
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill h-pentest-ai-platform -a claude-code2Manually: put the files in place
~/.claude/skills/h-pentest-ai-platform/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/h-pentest-ai-platform/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill h-pentest-ai-platform -a codex2Manually: put the files in place
.agents/skills/h-pentest-ai-platform/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill h-pentest-ai-platform -a cursor2Manually: put the files in place
.cursor/skills/h-pentest-ai-platform/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/security-skills skills/h-pentest-ai-platform2Manually: put the files in place
.github/skills/h-pentest-ai-platform/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill h-pentest-ai-platform -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/security-skills --path skills/h-pentest-ai-platformManually: put the files in place
.devin/skills/h-pentest-ai-platform/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/security-skills --skill h-pentest-ai-platform -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 h-pentest-ai-platform
How do I install h-pentest-ai-platform in Claude Code?
Run npx skills add reason-machines/security-skills --skill h-pentest-ai-platform -a claude-code. The skill file lands at ~/.claude/skills/h-pentest-ai-platform/SKILL.md.
What does h-pentest-ai-platform do?
It gets your agent through the H-Pentest setup and then through real pentest runs: supervisor and worker roles, attack knowledge lookup, Python in a sandbox, Nuclei scans and a closing report of what was found.
Do I need my own API keys to run it?
Yes, two of them in config.json: openai.api_key for the models and dashscope.api_key for embeddings. The same file holds base_url and the model name, set separately for the main model and the supervisor.