You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: INSTALL.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -58,7 +58,7 @@ pwsh ./scripts/install.ps1
58
58
> script aborts with a `syntax error` and cannot fix itself.
59
59
60
60
This copies:
61
-
- All 82 skills → `~/.claude/skills/` (macOS/Linux) or `%USERPROFILE%\.claude\skills\` (Windows)
61
+
- All 83 skills → `~/.claude/skills/` (macOS/Linux) or `%USERPROFILE%\.claude\skills\` (Windows)
62
62
- All 15 slash commands → `~/.claude/commands/`
63
63
- The `hunt` scaffolder → `~/.claude/scripts/hunt.sh` (sourced from your `.zshrc`/`.bashrc`) on macOS/Linux, or `~\.claude\scripts\hunt.ps1` (dot-sourced from your PowerShell `$PROFILE`) on Windows
@@ -295,7 +295,7 @@ Operational tradecraft accumulated across bug-bounty engagements and authorized
295
295
296
296
**Sister project:**[Claude-OSINT](https://github.com/elementalsouls/Claude-OSINT) — paired skills for the recon phase that this bundle picks up after. Its two recon skills (`offensive-osint`, `osint-methodology`) are **canonically maintained here** and re-exported there, so the two are byte-identical. **Installing both is safe:** each bundle's installer (`install.sh` on macOS/Linux, `install.ps1` on Windows) records a manifest, the script skips re-copying an identical skill, and `--uninstall` keeps any skill the other bundle still owns — uninstalling one never breaks the other.
**Generator tool used (not vendored):**[shuvonsec/public-skills-builder](https://github.com/shuvonsec/public-skills-builder) — used to scaffold per-class skills from H1 disclosed reports
Copy file name to clipboardExpand all lines: SECURITY.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -50,7 +50,7 @@ If you reach domain-admin-class objectives during an engagement, the bundle's ex
50
50
51
51
## Verifying what you install (supply-chain trust)
52
52
53
-
You are installing 82`SKILL.md` files plus shell and Python helpers into your AI agent's context. Agent Skills are third-party code — treat them like any dependency you run. Independent research (Snyk "ToxicSkills", 2026) found prompt injection in a meaningful fraction of public skills, so verification matters.
53
+
You are installing 83`SKILL.md` files plus shell and Python helpers into your AI agent's context. Agent Skills are third-party code — treat them like any dependency you run. Independent research (Snyk "ToxicSkills", 2026) found prompt injection in a meaningful fraction of public skills, so verification matters.
Copy file name to clipboardExpand all lines: USAGE.md
+10-9Lines changed: 10 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
# Claude-BugHunter — Usage Guide
2
2
3
-
A practical guide to using the 82-skill Claude-BugHunter bundle for bug hunting (bounty programs, authorized pentesting, CTFs, vuln research) **and external red-team engagements** against enterprise targets. This document covers what's in the bundle, how it composes, and how to use it on a real engagement from intake through paid bounty (or final client deliverable).
3
+
A practical guide to using the 83-skill Claude-BugHunter bundle for bug hunting (bounty programs, authorized pentesting, CTFs, vuln research) **and external red-team engagements** against enterprise targets. This document covers what's in the bundle, how it composes, and how to use it on a real engagement from intake through paid bounty (or final client deliverable).
4
4
5
5
> Built and validated through authorized red-team and bug-bounty engagements — exposed four bug-bounty capability gaps and five additional gaps around platform attack chains, mid-engagement IR detection, and client-facing reporting. The final stack documented here addresses both modes.
6
6
@@ -12,7 +12,7 @@ This section is for people who have **never used the bundle before, never used C
12
12
13
13
### What is this bundle, in plain English?
14
14
15
-
It's a collection of 82 markdown files (called **skills**) that turn Claude Code into a methodical bug-hunting assistant.
15
+
It's a collection of 83 markdown files (called **skills**) that turn Claude Code into a methodical bug-hunting assistant.
16
16
17
17
Without the bundle, asking Claude *"is this XSS?"* gets you a generic answer. With the bundle installed, the same question loads the `hunt-xss` skill — which contains specific detection patterns from 681+ disclosed reports, the exact payloads that have worked, and a validation gate that prevents you from filing a false-positive bug report.
18
18
@@ -31,7 +31,7 @@ You don't "learn" the bundle. You install it once, then describe what you're tes
31
31
- ❌ You don't need to know how to write exploits. The skills include working payloads.
32
32
- ❌ You don't need to know Burp Suite. It's optional. Skills work with curl + browser.
33
33
- ❌ You don't need a bug bounty account yet. You can practice on OWASP Juice Shop first.
34
-
- ❌ You don't need to read all 82 skills. They auto-load when relevant.
34
+
- ❌ You don't need to read all 83 skills. They auto-load when relevant.
35
35
- ❌ You don't need Python beyond `python --version` working (run `python3 --version` on macOS/Linux).
36
36
37
37
### Your first 30 minutes
@@ -45,7 +45,7 @@ mkdir -p ~/security-research && cd ~/security-research
|**3. Hunt**| Active testing for bugs in specific vuln classes |57`hunt-*` skills + 7 enterprise-platform skills (M365/Okta/cloud-IAM/vCenter/VPN/SharePoint/APK) + `security-arsenal`|
162
+
|**3. Hunt**| Active testing for bugs in specific vuln classes |58`hunt-*` skills + 7 enterprise-platform skills (M365/Okta/cloud-IAM/vCenter/VPN/SharePoint/APK) + `security-arsenal`|
163
163
|**4. Validate**| Decide whether a lead is actually a reportable bug |`triage-validation` (7-Question Gate) via `/triage` or `/validate`|
164
164
|**5. Capture**| PoC screenshots, HAR files, evidence redaction |`evidence-hygiene`|
165
165
|**6. Report**| Draft and submit |`report-writing`, `bugcrowd-reporting`|
@@ -168,7 +168,7 @@ See [docs/architecture.md](docs/architecture.md) for a more detailed breakdown.
168
168
169
169
---
170
170
171
-
## 2. Skill inventory (82 skills total)
171
+
## 2. Skill inventory (83 skills total)
172
172
173
173
### Workflow skills — the spine of any engagement
174
174
@@ -186,7 +186,7 @@ See [docs/architecture.md](docs/architecture.md) for a more detailed breakdown.
186
186
|`web2-recon`| Subdomain enumeration, host discovery, URL crawling | "find all subdomains of X" |
187
187
|`bb-local-toolkit`| Router for local cloned bug-bounty repos | "which tool for X", refers to local stack |
188
188
189
-
### Hunt — 57 per-class web skills
189
+
### Hunt — 58 per-class web skills
190
190
191
191
Each focuses on one vulnerability class with detection patterns, payloads, bypass tables, and chain opportunities drawn from disclosed bug-bounty reports.
192
192
@@ -219,6 +219,7 @@ Each focuses on one vulnerability class with detection patterns, payloads, bypas
Plus `hunt-dispatch` — the meta-router that the `/hunt` slash command uses to pick Red Team vs WAPT mode and load the right skill set.
224
225
@@ -397,7 +398,7 @@ Cross-reference this UUID in any chained submissions you file later.
397
398
If another pentester wants to replicate this stack, the install steps are in [INSTALL.md](INSTALL.md). The short version:
398
399
399
400
1. Clone this repo
400
-
2. Run the installer — `bash scripts/install.sh` (macOS/Linux) or `pwsh ./scripts/install.ps1` (Windows) — installs all 82 skills, 15 commands, and the `hunt` scaffold in one step
401
+
2. Run the installer — `bash scripts/install.sh` (macOS/Linux) or `pwsh ./scripts/install.ps1` (Windows) — installs all 83 skills, 15 commands, and the `hunt` scaffold in one step
401
402
3. Set up Burp MCP (BApp Store extension + `claude mcp add burp ...`)
402
403
4. (Optional) Refresh upstream snapshots via `./scripts/install-community-skills.sh` (macOS/Linux) or `pwsh ./scripts/install-community-skills.ps1` (Windows)
403
404
5. (Optional) Set up the skill regenerator with Anthropic + H1 API keys
Copy file name to clipboardExpand all lines: docs/architecture.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,15 +4,15 @@ The Claude-BugHunter bundle maps to a 6-phase workflow that supports both bug hu
4
4
5
5
## Primary view — phase-by-phase architecture
6
6
7
-
82 skills mapped to 6 phases, with a 57-skill `hunt-*` sub-stack, an 8-skill enterprise-platform attack layer, integration layer, and usage decision tree. This is the main reference for "which skill do I use when?".
7
+
83 skills mapped to 6 phases, with a 58-skill `hunt-*` sub-stack, an 8-skill enterprise-platform attack layer, integration layer, and usage decision tree. This is the main reference for "which skill do I use when?".
The "Source" column in the per-phase tables below tags each skill: **`original`** = author's work in this repo, `community` = community-contributed (v3), `vendored` = from [shuvonsec/claude-bug-bounty](https://github.com/shuvonsec/claude-bug-bounty) (MIT). Of 82 skills: 54 original, 20 community (v3), 8 vendored.
11
+
The "Source" column in the per-phase tables below tags each skill: **`original`** = author's work in this repo, `community` = community-contributed (v3), `vendored` = from [shuvonsec/claude-bug-bounty](https://github.com/shuvonsec/claude-bug-bounty) (MIT). Of 83 skills: 55 original, 20 community (v3), 8 vendored.
12
12
13
13
## Alternate view — 3-layer capability stack
14
14
15
-
The same 82 skills, regrouped by **role in an engagement** rather than by phase. Methodology + Recon (bottom) feeds the Hunt Arsenal (middle), which produces findings that flow up through Ship It (top) to a paid submission or client deliverable.
15
+
The same 83 skills, regrouped by **role in an engagement** rather than by phase. Methodology + Recon (bottom) feeds the Hunt Arsenal (middle), which produces findings that flow up through Ship It (top) to a paid submission or client deliverable.
16
16
17
17

18
18
@@ -55,12 +55,12 @@ The 6-phase workflow expanded into a pipeline showing per-phase active skills, t
55
55
56
56
| Skill | Source | Purpose |
57
57
|---|---|---|
58
-
|**57`hunt-*` skills**| original + community | Per vuln class / framework, curated from disclosed H1 reports + v3 community expansion — auto-trigger by topic |
58
+
|**58`hunt-*` skills**| original + community | Per vuln class / framework, curated from disclosed H1 reports + v3 community expansion — auto-trigger by topic |
Plus alternates: `hunt-cache-poison`, `hunt-race-condition`, `hunt-subdomain`. Plus the meta-router `hunt-dispatch` (used internally by the `/hunt` slash command — not user-invoked).
@@ -79,7 +79,7 @@ Built from authorized red-team engagements (enterprise targets including on-prem
79
79
### Tooling and docs
80
80
81
81
-**`hunt <target>` command** — Engagement-folder scaffolding: creates `~/Targets/<name>/` with `CLAUDE.md`, `scope.md`, `findings/`, `evidence/`, `submissions.txt`, `notes.md`, and a sensible `.gitignore` for engagement artifacts. Ships as `scripts/hunt.sh` (bash) and `scripts/hunt.ps1` (PowerShell).
82
-
-**Bundle packaging** — Single-step installer that copies all 82 skills, 15 commands, and the hunt scaffold into `~/.claude/`: `scripts/install.sh` (macOS/Linux) and `scripts/install.ps1` (Windows/PowerShell).
82
+
-**Bundle packaging** — Single-step installer that copies all 83 skills, 15 commands, and the hunt scaffold into `~/.claude/`: `scripts/install.sh` (macOS/Linux) and `scripts/install.ps1` (Windows/PowerShell).
83
83
-**Autopilot ledger (`engine/memory.py`) + the `/remember`, `/memory-gc`, `/pickup` commands** — Original design and implementation (cross-engagement capture + skip-decision for the engine hunt loop). Not derived from any external memory implementation.
0 commit comments