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.
Python ai-securityanthropicapplication-securitybug-bountybugbountybugcrowdclaudeclaude-codeclaude-skillsethical-hackinghackeroneoffensive-securitypentestingred-teamsecurity-toolsweb-security
docs: fix stale 51->82 counts + add CHANGELOG entry for the 82-skill release (#46)
Sachin Sharma7dce329e2470
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 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 afallback. 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, andHermes Agent**, not just Claude Code. `scripts/install.sh` gains `--agents` (→ `~/.agents/skills/`,read by Codex + OpenCode), `--hermes` (→ `~/.hermes/skills/`), `--all`, and `--burp-mcp` (translatesthe 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; **Codexrejected 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.mdindex 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-researchgit clone https://github.com/elementalsouls/Claude-BugHunter.gitcd 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 skillsEach 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 keysdiff --git a/assets/architecture-overview.svg b/assets/architecture-overview.svgindex 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:"Anthropic Sans", -apple-system, "system-ui", "Segoe UI", 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:"Anthropic Sans", -apple-system, "system-ui", "Segoe UI", 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:"Anthropic Sans", -apple-system, "system-ui", "Segoe UI", 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:"Anthropic Sans", -apple-system, "system-ui", "Segoe UI", 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.svgindex 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.svgindex 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:"Anthropic Sans", -apple-system, "system-ui", "Segoe UI", 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:"Anthropic Sans", -apple-system, "system-ui", "Segoe UI", 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:"Anthropic Sans", -apple-system, "system-ui", "Segoe UI", 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:"Anthropic Sans", -apple-system, "system-ui", "Segoe UI", 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.svgindex 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"/>