# ai2pentesttool-installer

ai2pentesttool-installer — a skill that drives a Python installer for pentest and security tools: it reports what is already on the machine, adds the rest, and retries a step that failed.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 246 installs · ★ 13 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/security-skills/tree/HEAD/skills/ai2pentesttool-installer/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/ai2pentesttool-installer

## What it does

The skill drives a command-line installer. `python main.py install nmap` handles one utility, `install-default` walks the shipped set, `install-file my_tools.txt` reads names from a file. Two read-only commands, `list` and `show-tools`, tell you what is present and what the installer knows about.

Four Python modules do the work: `ai_agent.py` asks the model for an install plan, `tool_installer.py` runs commands and copes with failures, `config.py` holds per-OS recipes for macOS, Linux and Windows, `main.py` is the entry point. Your own utility goes in as one more `TOOLS_INFO` entry. 200+ tools are claimed; the config lists 15 core ones, from `nmap` and `masscan` to `sqlmap`, `nikto` and `sslyze`.

Python comes first: pull in `requirements.txt` before anything runs. `OPENAI_API_KEY` is optional — with a key the agent drafts the plan, without one the run follows the commands already sitting in `config.py`. Some Linux installs want `sudo python main.py install sqlmap`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill ai2pentesttool-installer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ai2pentesttool-installer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ai2pentesttool-installer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill ai2pentesttool-installer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ai2pentesttool-installer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill ai2pentesttool-installer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ai2pentesttool-installer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/security-skills skills/ai2pentesttool-installer
```

2. **Manually: put the files in place**
- File: `.github/skills/ai2pentesttool-installer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill ai2pentesttool-installer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/security-skills --path skills/ai2pentesttool-installer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ai2pentesttool-installer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/security-skills --skill ai2pentesttool-installer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/security-skills/tree/HEAD/skills/ai2pentesttool-installer/SKILL.md

## When to use it
- install `nmap` and `sqlmap` on a fresh box
- run a whole tool list from `my_tools.txt` in one go
- see which security utilities the machine already has
- register a custom tool with recipes for macOS, Linux and Windows
- recover from a failed install and see which step broke

## Example prompts
- Install `nmap` and `sqlmap` one after another and confirm each one runs.
- Take the list in `my_tools.txt`, install everything on it, then tell me what failed.
- Check which pentest tools are already on this machine and add the missing ones from the default set.

## Similar
- [huawei-cloud-terraform-installer](https://affpapa.org/en/nevibecode/skills/huawei-cloud-terraform-installer.md) — skill · 19100 installs
- [agent-installer](https://affpapa.org/en/nevibecode/agents/agent-installer.md) — subagent · 363 installs
- [hve-core-installer](https://affpapa.org/en/nevibecode/skills/hve-core-installer.md) — skill · ★ 1627 repo stars
- [skill-installer](https://affpapa.org/en/nevibecode/skills/anthropics-skill-installer.md) — skill · 631 installs
- [symmetric-cipher-attacks](https://affpapa.org/en/nevibecode/skills/symmetric-cipher-attacks.md) — skill · 3900 installs
- [metasploit-framework](https://affpapa.org/en/nevibecode/skills/metasploit-framework.md) — skill · ★ 4719 repo stars

From the same set: [reason-machines/security-skills](https://affpapa.org/en/nevibecode/by/reason-machines/security-skills.md) — 129 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
