pentester-setup-tools

A one-time setup guide for a penetration-testing environment, meaning tools used to find security weaknesses with permission. It prepares framework dependencies, wordlists, and testing utilities.

In plain words
What is it for?
Use it when preparing a first clone or pentest engagement, installing Playwright or Kali, fetching the PentesterSpecialDict wordlist, and checking tools before fuzzing or scanning.
Why use it?
It prevents engagements from failing because browsers, security tools, or wordlists are missing. It also explains how to check and provision tools for the selected environment.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/fb0sh/pentester/pentester-setup-tools
Any agent
npx skills add fb0sh/pentester --skill pentester-setup-tools
Clone the repo
git clone --depth 1 https://github.com/fb0sh/pentester

Made for: Claude Code, Codex.

Per session 55 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 743 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00055 $0.00743
Opus 5 $0.00028 $0.00371
Sonnet 5 $0.00011 $0.00149
Haiku 4.5 $0.00006 $0.00074

Measured 2d ago against content hash 9e27a03f80cb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

pentester-setup-tools scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/pentester-setup-tools/SKILL.md · 67 lines

How it starts

The opening of the file, as written. The whole thing — 67 lines — stays where its author put it; the contents beside it link to each section on GitHub.

pentester-setup-tools

Run once before an engagement. Three layers: framework, wordlists, tools.

1. Framework deps

Check Fix
Playwright / Chromium cd .agents/skills/pentester-playwright && npm run setup
Kali image (scan_env=docker) docker pull kalilinux/kali-rolling
Schema validator node .agents/schema/validate-target-schema.js prints usage

2. Wordlists — PentesterSpecialDict (git submodule)

Dicts live at .agents/wordlists/PentesterSpecialDict/ (upstream evilc0deooo/PentesterSpecialDict). Needs network on first pull; safe to re-run (idempotent).

node .agents/wordlists/ensure.js
# optional refresh: node .agents/wordlists/ensure.js --update
# preflight only:  node .agents/wordlists/ensure.js --check

Docker: mount .agents/wordlists/wordlists (see schema/env.md).
Before gobuster/ffuf/hydra/sqlmap fuzz, if --check fails → run ensure.

3. Pentest tools — resolve first, provision on demand

Engagement runtime should query the capability catalog instead of installing everything:

node .agents/tools/resolve.js --id ${ID} --phase <phase> --scan-env <host-kali|docker> --signals "..."
node .agents/tools/ensure.js --scan-env <host-kali|docker> --id ${ID} --dry-run <selected-tool>

Only replace --dry-run with --install after the tool is selected. Kali apt candidates and the curated DotSlash set share this interface.

Optional pre-provision of the curated DotSlash set

The maintenance command below installs DotSlash, fills the needs-gen hashes, and lands all 11 pinned tools (subfinder naabu httpx EHole dismap dddd nuclei afrog xray DefaultHound fscan) for the current scan_env. Needs network.

# host-kali — tools on the host (dotslash → ~/.local/bin by default)
bash .agents/tools/provision.sh --scan-env host-kali all

# docker — inside kali-target-${ID} (container must already be running)
bash .agents/tools/provision.sh --scan-env docker --id ${ID} all

Read the full file on GitHub · 67 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 67 lines · 55 tokens per session scan A 9e27a03f80cb

Subscribe to this mod's changes

pentester-setup-tools is a skill published in the GitHub repository fb0sh/pentester (23 stars, last pushed 1mo ago), licensed MIT. It adds 55 tokens to every session and 743 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

transilience-report-style

Threat Intelligence Report Design System — ReportLab-based PDF generation for A4 reports with Transilience branding, typography, and layout standards.

transilienceai/communitytools · 31 tokens

firewall-review

Evidence-safe firewall ruleset audit reference specification — 22 documented detector patterns (17 vendor-agnostic plus 5 FortiGate-specific), a 15-check semantic catalogue, CIS Fortinet FortiGate Benchmark guidance, a custom customer-policy benchmark, and consolidated network-team Excel profiles including grouped…

transilienceai/communitytools · 100 tokens

pentest-engagement

Run a professional penetration engagement OR a network vulnerability scan from a scope. WEB mode (apex domains / app URLs) — mandatory surface expansion, systematic OWASP attack-class coverage, reversible active exploitation, authoritative validation, Transilience PDF. NETWORK mode (a list of IPs/CIDRs, e.g. 1500…

transilienceai/communitytools · 140 tokens

attack-path-stitcher

Stitches confirmed single-asset findings into multi-hop attack paths across the organization. Builds a graph where nodes are assets and edges are confirmed exploit hops citing the findings that enable them.

transilienceai/communitytools · 42 tokens

coordination

Pentest coordination — orchestrates executor and validator agents with context-controlled spawning. Entry point for all engagements.

transilienceai/communitytools · 24 tokens

hackerone

HackerOne bug bounty automation - parses scope CSVs, deploys parallel pentesting agents per asset, validates PoCs, and generates platform-ready submission reports.

transilienceai/communitytools · 36 tokens