Skip to content

A Claude Code skill bundle for bug hunting and external red-team work - 82 skills, 15 slash commands, 681 disclosed-report patterns curated across 24 core vulnerability classes, plus enterprise identity + infrastructure attack matrices.

docs: fix stale 51->82 counts + add CHANGELOG entry for the 82-skill release (#46)

Sachin Sharma7dce329e2470
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 12d2cc6..4cabfed 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,12 +7,17 @@ versioning is loosely [SemVer](https://semver.org/) at the bundle level.
## [Unreleased]
### Added
+- **Skill library expanded 71 → 82** — 9 new hunt skills (`hunt-jwt-crypto`, `hunt-rag-vector`,
+ `hunt-shadow-api`, `hunt-captcha-bypass`, `hunt-clickjacking`, `hunt-html-injection`,
+ `hunt-forgot-password`, `hunt-exceptional-conditions`, `ios-redteam-pipeline`) plus `hunt-spa-api`
+ and `recon-scope-triage`; 11 existing skills expanded with verified technique content. Hunt
+ sub-stack 48 → 57. `hunt-ai-attacks` folded into `hunt-llm-ai` (was a frontmatter-less duplicate).
- **Claude Code plugin marketplace** — `.claude-plugin/marketplace.json` + `.claude-plugin/plugin.json`
make the bundle installable natively: `/plugin marketplace add elementalsouls/Claude-BugHunter`
then `/plugin install claude-bughunter@elementalsouls`. Skills load namespaced under
`claude-bughunter:` and update on version bump. The `scripts/install.sh` copy method stays as a
fallback. This is the convention used by Anthropic's own marketplaces and Trail of Bits.
-- **Multi-harness install** — the 71 Agent Skills now run on **OpenCode, OpenAI Codex CLI, and
+- **Multi-harness install** — the 82 Agent Skills now run on **OpenCode, OpenAI Codex CLI, and
Hermes Agent**, not just Claude Code. `scripts/install.sh` gains `--agents` (→ `~/.agents/skills/`,
read by Codex + OpenCode), `--hermes` (→ `~/.hermes/skills/`), `--all`, and `--burp-mcp` (translates
the existing Burp MCP into each harness's config via `scripts/setup_harness_mcp.py`; OpenCode JSON +
@@ -21,11 +26,21 @@ versioning is loosely [SemVer](https://semver.org/) at the bundle level.
remain Claude-Code-only. New guide: `docs/multi-harness.md`.
### Fixed
+- `hunt-clickjacking`, `hunt-html-injection`: quoted the `description` — an unquoted `: ` (`Targets:`,
+ `surfaces:`) broke strict YAML / Codex. Also genericized lab/harness-specific language in the new
+ skills for cross-harness portability.
- `hunt-ntlm-info`: quoted the `description` — it contained an unquoted `` `WWW-Authenticate: NTLM` ``
(`: ` makes strict YAML parsers read a nested mapping). Claude/OpenCode/Hermes tolerated it; **Codex
rejected it**. Surfaced by real multi-harness testing.
### Changed
+- **Dispatch dedup (description-scoping only — bodies unchanged)** — `hunt-jwt-crypto` set as the
+ JWT-crypto owner (`hunt-ato`/`hunt-auth-bypass`/`hunt-api-misconfig` defer to it); `bb-local-toolkit`
+ differentiated from `bug-bounty` (had a byte-identical description); scoped `hunt-sqli`↔`hunt-nosqli`,
+ `hunt-auth-bypass`↔`hunt-saml`, `hunt-cache-poison`↔`hunt-host-header`,
+ `report-writing`/`security-arsenal`↔`triage-validation`, and `hunt-spa-api`↔`hunt-source-leak`/`hunt-shadow-api`.
+- Metrics synced to **82 skills** across README, banner, catalog (regenerated), INSTALL, USAGE, and
+ docs (architecture/credits/index/multi-harness + capability-map/architecture-overview diagrams).
- `install.sh --agents` **auto-truncates** descriptions > 1024 chars to ≤1024 in the `~/.agents/skills`
(Codex) copy only — Codex hard-rejects longer ones; `~/.claude`/`~/.hermes` keep full descriptions.
Affects the 3 aggregator router skills.
diff --git a/USAGE.md b/USAGE.md
index ca0f2c5..a49e78b 100644
--- a/USAGE.md
+++ b/USAGE.md
@@ -1,6 +1,6 @@
# Claude-BugHunter — Usage Guide
-A practical guide to using the 51-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).
+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).
> 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.
@@ -12,9 +12,9 @@ This section is for people who have **never used the bundle before, never used C
### What is this bundle, in plain English?
-It's a collection of 51 markdown files (called **skills**) that turn Claude Code into a methodical bug-hunting assistant.
+It's a collection of 82 markdown files (called **skills**) that turn Claude Code into a methodical bug-hunting assistant.
-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 574+ disclosed reports, the exact payloads that have worked, and a validation gate that prevents you from filing a false-positive bug report.
+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.
You don't "learn" the bundle. You install it once, then describe what you're testing in plain English, and the relevant skill auto-loads. You read it together with Claude and follow the steps.
@@ -31,7 +31,7 @@ You don't "learn" the bundle. You install it once, then describe what you're tes
- ❌ You don't need to know how to write exploits. The skills include working payloads.
- ❌ You don't need to know Burp Suite. It's optional. Skills work with curl + browser.
- ❌ You don't need a bug bounty account yet. You can practice on OWASP Juice Shop first.
-- ❌ You don't need to read all 51 skills. They auto-load when relevant.
+- ❌ You don't need to read all 82 skills. They auto-load when relevant.
- ❌ You don't need Python beyond `python3 --version` working.
### Your first 30 minutes
@@ -44,7 +44,7 @@ mkdir -p ~/security-research && cd ~/security-research
git clone https://github.com/elementalsouls/Claude-BugHunter.git
cd Claude-BugHunter
-# 2. Install (copies 51 skills + 15 commands into Claude Code)
+# 2. Install (copies 82 skills + 15 commands into Claude Code)
./scripts/install.sh
# 3. Reload your shell so the 'hunt' command becomes available
@@ -149,7 +149,7 @@ See [docs/architecture.md](docs/architecture.md) for a more detailed breakdown.
---
-## 2. Skill inventory (51 skills total)
+## 2. Skill inventory (82 skills total)
### Workflow skills — the spine of any engagement
@@ -167,7 +167,7 @@ See [docs/architecture.md](docs/architecture.md) for a more detailed breakdown.
| `web2-recon` | Subdomain enumeration, host discovery, URL crawling | "find all subdomains of X" |
| `bb-local-toolkit` | Router for local cloned bug-bounty repos | "which tool for X", refers to local stack |
-### Hunt — 24 per-class web skills
+### Hunt — 57 per-class web skills
Each focuses on one vulnerability class with detection patterns, payloads, bypass tables, and chain opportunities drawn from disclosed bug-bounty reports.
@@ -378,7 +378,7 @@ Cross-reference this UUID in any chained submissions you file later.
If another pentester wants to replicate this stack, the install steps are in [INSTALL.md](INSTALL.md). The short version:
1. Clone this repo
-2. Run `./scripts/install.sh` (installs all 51 skills, 15 commands, and hunt scaffold in one step)
+2. Run `./scripts/install.sh` (installs all 82 skills, 15 commands, and hunt scaffold in one step)
3. Set up Burp MCP (BApp Store extension + `claude mcp add burp ...`)
4. (Optional) Refresh upstream snapshots via `./scripts/install-community-skills.sh`
5. (Optional) Set up the skill regenerator with Anthropic + H1 API keys
diff --git a/assets/architecture-overview.svg b/assets/architecture-overview.svg
index a69b11c..ce3d2f5 100644
--- a/assets/architecture-overview.svg
+++ b/assets/architecture-overview.svg
@@ -1,6 +1,6 @@
<svg viewBox="0 0 1200 880" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc" preserveAspectRatio="xMidYMid meet" style="height: auto;">
<title id="title" style="fill:rgb(0, 0, 0);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:&quot;Anthropic Sans&quot;, -apple-system, &quot;system-ui&quot;, &quot;Segoe UI&quot;, sans-serif;font-size:16px;font-weight:400;text-anchor:start;dominant-baseline:auto">Claude-BugHunter — architecture and usage</title>
- <desc id="desc" style="fill:rgb(0, 0, 0);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:&quot;Anthropic Sans&quot;, -apple-system, &quot;system-ui&quot;, &quot;Segoe UI&quot;, sans-serif;font-size:16px;font-weight:400;text-anchor:start;dominant-baseline:auto">A 6-phase bug-bounty workflow (Scope, Recon, Hunt, Validate, Capture, Report) with 51 skills mapped to phases, a per-class hunt sub-stack, integration layer (Burp MCP, hunt shell command, Anthropic + H1 APIs), and a usage decision tree for picking the right skill per task.</desc>
+ <desc id="desc" style="fill:rgb(0, 0, 0);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:&quot;Anthropic Sans&quot;, -apple-system, &quot;system-ui&quot;, &quot;Segoe UI&quot;, sans-serif;font-size:16px;font-weight:400;text-anchor:start;dominant-baseline:auto">A 6-phase bug-bounty workflow (Scope, Recon, Hunt, Validate, Capture, Report) with 82 skills mapped to phases, a per-class hunt sub-stack, integration layer (Burp MCP, hunt shell command, Anthropic + H1 APIs), and a usage decision tree for picking the right skill per task.</desc>
<defs>
<marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto">
@@ -12,7 +12,7 @@
<rect x="0" y="0" width="1200" height="880" fill="#ffffff"/>
<!-- ==================== TITLE ==================== -->
- <text x="24" y="28" style="fill:rgb(17, 24, 39);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:17px;font-weight:700;text-anchor:start;dominant-baseline:auto">Claude-BugHunter — 51 skills, 6-phase workflow</text>
+ <text x="24" y="28" style="fill:rgb(17, 24, 39);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:17px;font-weight:700;text-anchor:start;dominant-baseline:auto">Claude-BugHunter — 82 skills, 6-phase workflow</text>
<text x="24" y="48" style="fill:rgb(107, 114, 128);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:11px;font-weight:500;font-style:italic;text-anchor:start;dominant-baseline:auto">Each phase has a small set of skills. Skills compose left-to-right. Use the decision tree at the bottom to pick the right skill for a given task.</text>
<!-- ==================== PHASE BANDS (top row) ==================== -->
@@ -89,7 +89,7 @@
<!-- Hunt-* per-class group container -->
<rect x="416" y="118" width="186" height="226" rx="6" fill="#ede9fe" stroke="#7c3aed" stroke-width="1.5" style="fill:rgb(237, 233, 254);stroke:rgb(124, 58, 237);color:rgb(255, 255, 255);stroke-width:1.5px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:&quot;Anthropic Sans&quot;, -apple-system, &quot;system-ui&quot;, &quot;Segoe UI&quot;, sans-serif;font-size:16px;font-weight:400;text-anchor:start;dominant-baseline:auto"/>
- <text x="509" y="138" text-anchor="middle" style="fill:#5b21b6;;fill:rgb(91, 33, 182);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:13px;font-weight:600;text-anchor:middle;dominant-baseline:auto">27 hunt-* skills</text>
+ <text x="509" y="138" text-anchor="middle" style="fill:#5b21b6;;fill:rgb(91, 33, 182);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:13px;font-weight:600;text-anchor:middle;dominant-baseline:auto">57 hunt-* skills</text>
<text x="509" y="153" text-anchor="middle" style="fill:#5b21b6;;fill:rgb(91, 33, 182);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:9.5px;font-weight:400;text-anchor:middle;dominant-baseline:auto">one per vuln class · auto-trigger by topic</text>
<!-- Two-column list of hunt-* names -->
diff --git a/assets/capability-map.svg b/assets/capability-map.svg
index e35d479..59f39a0 100644
--- a/assets/capability-map.svg
+++ b/assets/capability-map.svg
@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1100" width="1920" height="1100" role="img" aria-label="Claude-BugHunter Capability Map — 3-layer architecture with 51 skills">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1100" width="1920" height="1100" role="img" aria-label="Claude-BugHunter Capability Map — 3-layer architecture with 82 skills">
<defs>
<linearGradient id="cm-bg" x1="0" y1="0" x2="1" y2="1">
<stop offset="0%" stop-color="#0a0a0e"/>
@@ -37,7 +37,7 @@
<g font-family="ui-monospace, 'SF Mono', Menlo, monospace" font-size="14" fill="#5a5a6a" letter-spacing="2">
<text x="60" y="60">▸ CAPABILITY MAP</text>
- <text x="780" y="60">· 51 SKILLS · 3 LAYERS · 7 DOMAINS · 574+ DISCLOSED PATTERNS ·</text>
+ <text x="780" y="60">· 82 SKILLS · 3 LAYERS · 7 DOMAINS · 681+ DISCLOSED PATTERNS ·</text>
<text x="1860" y="60" text-anchor="end">DOC ▸ ARCHITECTURE.0X02</text>
</g>
<line x1="40" y1="78" x2="1880" y2="78" stroke="#2a2a35" stroke-width="1"/>
diff --git a/docs/assets/architecture-overview.svg b/docs/assets/architecture-overview.svg
index a69b11c..ce3d2f5 100644
--- a/docs/assets/architecture-overview.svg
+++ b/docs/assets/architecture-overview.svg
@@ -1,6 +1,6 @@
<svg viewBox="0 0 1200 880" xmlns="http://www.w3.org/2000/svg" role="img" aria-labelledby="title desc" preserveAspectRatio="xMidYMid meet" style="height: auto;">
<title id="title" style="fill:rgb(0, 0, 0);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:&quot;Anthropic Sans&quot;, -apple-system, &quot;system-ui&quot;, &quot;Segoe UI&quot;, sans-serif;font-size:16px;font-weight:400;text-anchor:start;dominant-baseline:auto">Claude-BugHunter — architecture and usage</title>
- <desc id="desc" style="fill:rgb(0, 0, 0);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:&quot;Anthropic Sans&quot;, -apple-system, &quot;system-ui&quot;, &quot;Segoe UI&quot;, sans-serif;font-size:16px;font-weight:400;text-anchor:start;dominant-baseline:auto">A 6-phase bug-bounty workflow (Scope, Recon, Hunt, Validate, Capture, Report) with 51 skills mapped to phases, a per-class hunt sub-stack, integration layer (Burp MCP, hunt shell command, Anthropic + H1 APIs), and a usage decision tree for picking the right skill per task.</desc>
+ <desc id="desc" style="fill:rgb(0, 0, 0);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:&quot;Anthropic Sans&quot;, -apple-system, &quot;system-ui&quot;, &quot;Segoe UI&quot;, sans-serif;font-size:16px;font-weight:400;text-anchor:start;dominant-baseline:auto">A 6-phase bug-bounty workflow (Scope, Recon, Hunt, Validate, Capture, Report) with 82 skills mapped to phases, a per-class hunt sub-stack, integration layer (Burp MCP, hunt shell command, Anthropic + H1 APIs), and a usage decision tree for picking the right skill per task.</desc>
<defs>
<marker id="arr" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto">
@@ -12,7 +12,7 @@
<rect x="0" y="0" width="1200" height="880" fill="#ffffff"/>
<!-- ==================== TITLE ==================== -->
- <text x="24" y="28" style="fill:rgb(17, 24, 39);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:17px;font-weight:700;text-anchor:start;dominant-baseline:auto">Claude-BugHunter — 51 skills, 6-phase workflow</text>
+ <text x="24" y="28" style="fill:rgb(17, 24, 39);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:17px;font-weight:700;text-anchor:start;dominant-baseline:auto">Claude-BugHunter — 82 skills, 6-phase workflow</text>
<text x="24" y="48" style="fill:rgb(107, 114, 128);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:11px;font-weight:500;font-style:italic;text-anchor:start;dominant-baseline:auto">Each phase has a small set of skills. Skills compose left-to-right. Use the decision tree at the bottom to pick the right skill for a given task.</text>
<!-- ==================== PHASE BANDS (top row) ==================== -->
@@ -89,7 +89,7 @@
<!-- Hunt-* per-class group container -->
<rect x="416" y="118" width="186" height="226" rx="6" fill="#ede9fe" stroke="#7c3aed" stroke-width="1.5" style="fill:rgb(237, 233, 254);stroke:rgb(124, 58, 237);color:rgb(255, 255, 255);stroke-width:1.5px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:&quot;Anthropic Sans&quot;, -apple-system, &quot;system-ui&quot;, &quot;Segoe UI&quot;, sans-serif;font-size:16px;font-weight:400;text-anchor:start;dominant-baseline:auto"/>
- <text x="509" y="138" text-anchor="middle" style="fill:#5b21b6;;fill:rgb(91, 33, 182);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:13px;font-weight:600;text-anchor:middle;dominant-baseline:auto">27 hunt-* skills</text>
+ <text x="509" y="138" text-anchor="middle" style="fill:#5b21b6;;fill:rgb(91, 33, 182);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:13px;font-weight:600;text-anchor:middle;dominant-baseline:auto">57 hunt-* skills</text>
<text x="509" y="153" text-anchor="middle" style="fill:#5b21b6;;fill:rgb(91, 33, 182);stroke:none;color:rgb(255, 255, 255);stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;opacity:1;font-family:system-ui, -apple-system, sans-serif;font-size:9.5px;font-weight:400;text-anchor:middle;dominant-baseline:auto">one per vuln class · auto-trigger by topic</text>
<!-- Two-column list of hunt-* names -->
diff --git a/docs/assets/capability-map.svg b/docs/assets/capability-map.svg
index e35d479..59f39a0 100644
--- a/docs/assets/capability-map.svg
+++ b/docs/assets/capability-map.svg
@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1100" width="1920" height="1100" role="img" aria-label="Claude-BugHunter Capability Map — 3-layer architecture with 51 skills">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1920 1100" width="1920" height="1100" role="img" aria-label="Claude-BugHunter Capability Map — 3-layer architecture with 82 skills">
<defs>
<linearGradient id="cm-bg" x1="0" y1="0" x2="1" y2="1">
<stop offset="0%" stop-color="#0a0a0e"/>
@@ -37,7 +37,7 @@
<g font-family="ui-monospace, 'SF Mono', Menlo, monospace" font-size="14" fill="#5a5a6a" letter-spacing="2">
<text x="60" y="60">▸ CAPABILITY MAP</text>
- <text x="780" y="60">· 51 SKILLS · 3 LAYERS · 7 DOMAINS · 574+ DISCLOSED PATTERNS ·</text>
+ <text x="780" y="60">· 82 SKILLS · 3 LAYERS · 7 DOMAINS · 681+ DISCLOSED PATTERNS ·</text>
<text x="1860" y="60" text-anchor="end">DOC ▸ ARCHITECTURE.0X02</text>
</g>
<line x1="40" y1="78" x2="1880" y2="78" stroke="#2a2a35" stroke-width="1"/>