Skip to content

Commit e81acda

Browse files
authored
Merge pull request #3 from prithvee07/claude/contribution-docs-review-sy001c
feat(skills): add hunt-fintech-graphql
2 parents 995ae5b + 2f4ac9c commit e81acda

10 files changed

Lines changed: 281 additions & 34 deletions

File tree

INSTALL.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ pwsh ./scripts/install.ps1
5858
> script aborts with a `syntax error` and cannot fix itself.
5959
6060
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)
6262
- All 15 slash commands → `~/.claude/commands/`
6363
- 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
6464

README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
# claude-bughunter
44

5-
> A self-contained Claude skill bundle for bug hunting and external red-team work · **82 skills** · 15 slash commands · **681 disclosed-report patterns** across 24 core vulnerability classes · enterprise identity + infrastructure attack matrices · engagement-folder scaffolding · Burp MCP integration · battle-tested across authorized red-team and bug-hunting engagements, plus public training platforms (DVWA, OWASP Juice Shop, Hacker101, testphp.vulnweb.com).
5+
> A self-contained Claude skill bundle for bug hunting and external red-team work · **83 skills** · 15 slash commands · **681 disclosed-report patterns** across 24 core vulnerability classes · enterprise identity + infrastructure attack matrices · engagement-folder scaffolding · Burp MCP integration · battle-tested across authorized red-team and bug-hunting engagements, plus public training platforms (DVWA, OWASP Juice Shop, Hacker101, testphp.vulnweb.com).
66
77
Built by **[Sachin Sharma](https://www.linkedin.com/in/sachinsharma8080/)** — Bug Hunting & GenAI Security Research.
88

@@ -26,7 +26,7 @@ Built by **[Sachin Sharma](https://www.linkedin.com/in/sachinsharma8080/)** —
2626
Four layers stack:
2727

2828
- **Think**`bb-methodology` + `redteam-mindset`: the 5-phase non-linear workflow, critical-thinking framework, and red-team operator discipline.
29-
- **Hunt webapps**57 `hunt-*` skills curated from 681 disclosed HackerOne reports: per-class detection patterns, payloads, bypass tables, and chain templates.
29+
- **Hunt webapps**58 `hunt-*` skills curated from 681 disclosed HackerOne reports: per-class detection patterns, payloads, bypass tables, and chain templates.
3030
- **Hit the perimeter** — enterprise platform chains (M365/Entra, Okta, vCenter, SSL-VPN appliances, SharePoint, cloud IAM): current 2024–2026 CVE chains + post-credential escalation.
3131
- **Ship it**`triage-validation` + reporting + `evidence-hygiene`: the 7-Question Gate, VRT-aware severity, OOS rebuttals, PII redaction, and red-team deliverables.
3232

@@ -43,7 +43,7 @@ All triggered automatically by topic — describe what you're testing in plain E
4343
/plugin install claude-bughunter@elementalsouls
4444
```
4545

46-
All 82 skills + 15 commands load namespaced under `claude-bughunter:` and update when you bump the plugin version — no files copied into `~/.claude/`.
46+
All 83 skills + 15 commands load namespaced under `claude-bughunter:` and update when you bump the plugin version — no files copied into `~/.claude/`.
4747

4848
**Option B — copy install (no plugin system / pin to a clone):**
4949

@@ -64,7 +64,7 @@ Both copy the skills + commands into `~/.claude/` (macOS/Linux) or `%USERPROFILE
6464

6565
**What each install path gives you:**
6666

67-
| Path | 82 skills + 15 slash commands | `cbh` CLI | `hunt` scaffolder |
67+
| Path | 83 skills + 15 slash commands | `cbh` CLI | `hunt` scaffolder |
6868
|---|---|---|---|
6969
| **A — plugin** | ✅ namespaced under `claude-bughunter:` | ➕ separate `pipx install` | ❌ clone-only |
7070
| **B — copy install** | ✅ copied into `~/.claude/` | ✅ from the clone | ✅ from the clone |
@@ -158,11 +158,11 @@ If you're running an internal red team that includes domain-takeover chains via
158158

159159
## What's inside
160160

161-
**82 skills**, auto-loaded by topic — no invocation by name. Coverage across the external attack surface:
161+
**83 skills**, auto-loaded by topic — no invocation by name. Coverage across the external attack surface:
162162

163163
| Category | # | Examples |
164164
|---|---|---|
165-
| Hunt — web app vuln classes | 57 | XSS, SQLi, SSRF, IDOR, LFI, SSTI, XXE, CSRF, CORS, open-redirect, SharePoint, ASP.NET/NTLM |
165+
| Hunt — web app vuln classes | 58 | XSS, SQLi, SSRF, IDOR, LFI, SSTI, XXE, CSRF, CORS, open-redirect, SharePoint, ASP.NET/NTLM |
166166
| Enterprise platform attack ★ | 10 | M365/Entra, Okta, cloud-IAM-deep, vCenter, enterprise VPN, APK/iOS red-team pipelines, supply-chain recon |
167167
| Reporting & validation | 6 | triage-validation, evidence-hygiene, report-writing, bugcrowd-reporting |
168168
| Recon & OSINT | 5 | web2-recon, offensive-osint, osint-methodology, recon-scope-triage |
@@ -261,7 +261,7 @@ The per-class `hunt-*` skills address gap-zero (*"what should I look for in weba
261261

262262
- [ ] HackerOne MCP integration (currently only Burp MCP wired in)
263263
- [ ] Per-engagement memory layer — pattern recall across targets
264-
- [ ] Industry-specific hunt skills — `hunt-fintech-graphql`, `hunt-healthcare-fhir`, `hunt-gov-compliance`
264+
- [x] Industry-specific hunt skills — `hunt-fintech-graphql` shipped; `hunt-healthcare-fhir`, `hunt-gov-compliance` still open
265265
- [ ] Program-rules-parser skill — auto-generate structured `scope.md` from program text
266266
- [ ] Refresh `hunt-*` skills with newer disclosed reports (re-run `public-skills-builder`)
267267
- [ ] Additional enterprise-platform skills — `citrix-netscaler-deep`, `f5-bigip-attack`, `ad-cs-attack` (AD Certificate Services)
@@ -295,7 +295,7 @@ Operational tradecraft accumulated across bug-bounty engagements and authorized
295295

296296
**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.
297297

298-
**Vendored foundation:** [shuvonsec/claude-bug-bounty](https://github.com/shuvonsec/claude-bug-bounty) — methodology, validation, reporting, payload library (8 of 82 skills + 15 slash commands)
298+
**Vendored foundation:** [shuvonsec/claude-bug-bounty](https://github.com/shuvonsec/claude-bug-bounty) — methodology, validation, reporting, payload library (8 of 83 skills + 15 slash commands)
299299

300300
**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
301301

SECURITY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,7 @@ If you reach domain-admin-class objectives during an engagement, the bundle's ex
5050

5151
## Verifying what you install (supply-chain trust)
5252

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.
5454

5555
**What we do on our side:**
5656

USAGE.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Claude-BugHunter — Usage Guide
22

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).
44

55
> 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.
66
@@ -12,7 +12,7 @@ This section is for people who have **never used the bundle before, never used C
1212

1313
### What is this bundle, in plain English?
1414

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.
1616

1717
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.
1818

@@ -31,7 +31,7 @@ You don't "learn" the bundle. You install it once, then describe what you're tes
3131
- ❌ You don't need to know how to write exploits. The skills include working payloads.
3232
- ❌ You don't need to know Burp Suite. It's optional. Skills work with curl + browser.
3333
- ❌ 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.
3535
- ❌ You don't need Python beyond `python --version` working (run `python3 --version` on macOS/Linux).
3636

3737
### Your first 30 minutes
@@ -45,7 +45,7 @@ mkdir -p ~/security-research && cd ~/security-research
4545
git clone https://github.com/elementalsouls/Claude-BugHunter.git
4646
cd Claude-BugHunter
4747

48-
# 2. Install (copies 82 skills + 15 commands into Claude Code)
48+
# 2. Install (copies 83 skills + 15 commands into Claude Code)
4949
bash scripts/install.sh
5050

5151
# 3. Reload your shell so the 'hunt' command becomes available
@@ -63,7 +63,7 @@ cd "$HOME\security-research"
6363
git clone https://github.com/elementalsouls/Claude-BugHunter.git
6464
cd Claude-BugHunter
6565
66-
# 2. Install (copies 82 skills + 15 commands into Claude Code)
66+
# 2. Install (copies 83 skills + 15 commands into Claude Code)
6767
pwsh ./scripts/install.ps1
6868
6969
# 3. Reload your profile so the 'hunt' command becomes available
@@ -159,7 +159,7 @@ The stack maps to a 6-phase bug-bounty workflow. Each phase has its own skill se
159159
|---|---|---|
160160
| **1. Scope** | Reading program rules, deciding what's in/out, scaffolding the engagement folder | `bug-bounty`, `bb-methodology`, `osint-methodology` + `hunt <target>` shell command |
161161
| **2. Recon** | Asset discovery, subdomain enum, endpoint mapping, secret hunting | `offensive-osint`, `web2-recon`, `bb-local-toolkit` |
162-
| **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` |
163163
| **4. Validate** | Decide whether a lead is actually a reportable bug | `triage-validation` (7-Question Gate) via `/triage` or `/validate` |
164164
| **5. Capture** | PoC screenshots, HAR files, evidence redaction | `evidence-hygiene` |
165165
| **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.
168168

169169
---
170170

171-
## 2. Skill inventory (82 skills total)
171+
## 2. Skill inventory (83 skills total)
172172

173173
### Workflow skills — the spine of any engagement
174174

@@ -186,7 +186,7 @@ See [docs/architecture.md](docs/architecture.md) for a more detailed breakdown.
186186
| `web2-recon` | Subdomain enumeration, host discovery, URL crawling | "find all subdomains of X" |
187187
| `bb-local-toolkit` | Router for local cloned bug-bounty repos | "which tool for X", refers to local stack |
188188

189-
### Hunt — 57 per-class web skills
189+
### Hunt — 58 per-class web skills
190190

191191
Each focuses on one vulnerability class with detection patterns, payloads, bypass tables, and chain opportunities drawn from disclosed bug-bounty reports.
192192

@@ -219,6 +219,7 @@ Each focuses on one vulnerability class with detection patterns, payloads, bypas
219219
| `hunt-sharepoint` | SharePoint on-prem (ToolShell chain, anon SOAP, SafeControl enum, FormDigest) |
220220
| `hunt-ntlm-info` | NTLM Type-2 anonymous AD topology disclosure |
221221
| `hunt-misc` | Catch-all for less-common classes |
222+
| `hunt-fintech-graphql` | Money-movement GraphQL mutations, ledger IDOR, decimal-precision abuse, idempotency-key bypass |
222223

223224
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.
224225

@@ -397,7 +398,7 @@ Cross-reference this UUID in any chained submissions you file later.
397398
If another pentester wants to replicate this stack, the install steps are in [INSTALL.md](INSTALL.md). The short version:
398399

399400
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
401402
3. Set up Burp MCP (BApp Store extension + `claude mcp add burp ...`)
402403
4. (Optional) Refresh upstream snapshots via `./scripts/install-community-skills.sh` (macOS/Linux) or `pwsh ./scripts/install-community-skills.ps1` (Windows)
403404
5. (Optional) Set up the skill regenerator with Anthropic + H1 API keys

docs/architecture.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,15 @@ The Claude-BugHunter bundle maps to a 6-phase workflow that supports both bug hu
44

55
## Primary view — phase-by-phase architecture
66

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?".
88

99
![architecture overview](assets/architecture-overview.svg)
1010

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 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.
1212

1313
## Alternate view — 3-layer capability stack
1414

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.
1616

1717
![capability map](assets/capability-map.svg)
1818

@@ -55,12 +55,12 @@ The 6-phase workflow expanded into a pipeline showing per-phase active skills, t
5555

5656
| Skill | Source | Purpose |
5757
|---|---|---|
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 |
5959
| `security-arsenal` | vendored | Payload library (XSS / SSRF / SQLi / SSTI / etc.) |
6060
| `web3-audit` | vendored | Smart-contract audit (10 bug classes, Foundry PoC) |
6161
| `meme-coin-audit` | vendored | Token rug-pull detection |
6262

63-
### Per-class hunt skills (57)
63+
### Per-class hunt skills (58)
6464

6565
```
6666
hunt-api-misconfig hunt-mfa-bypass
@@ -93,7 +93,7 @@ hunt-jwt-crypto hunt-forgot-password
9393
hunt-shadow-api hunt-exceptional-conditions
9494
hunt-spa-api hunt-captcha-bypass
9595
hunt-rag-vector hunt-clickjacking
96-
hunt-html-injection
96+
hunt-html-injection hunt-fintech-graphql
9797
```
9898

9999
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).

docs/credits.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@ This is a **bundle**: skills and commands are vendored directly into `skills/` a
1010

1111
| Category | Count | Source |
1212
|---|---|---|
13-
| **Original / personally-curated skills** | 54 | This repo |
13+
| **Original / personally-curated skills** | 55 | This repo |
1414
| Community-contributed skills (v3) | 20 | community PRs (e.g. #7) |
1515
| Vendored foundation skills | 8 | shuvonsec/claude-bug-bounty (MIT) |
1616
| Vendored slash commands | 12 | shuvonsec/claude-bug-bounty (MIT) |
17-
| **Total** | 82 skills + 15 commands | |
17+
| **Total** | 83 skills + 15 commands | |
1818

1919
---
2020

@@ -79,7 +79,7 @@ Built from authorized red-team engagements (enterprise targets including on-prem
7979
### Tooling and docs
8080

8181
- **`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).
8383
- **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.
8484
- **`assets/banner-v2.svg`** — Hand-coded SVG banner.
8585
- **Documentation**`README.md`, `INSTALL.md`, `USAGE.md`, `CONTRIBUTING.md`, `docs/architecture.md`, this credits file.

docs/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ platform CVE chains, and the hygiene, and it stays in scope.
2222

2323
## What you get
2424

25-
- **82 skills** across recon, 57 web-app vuln-class + framework skills, enterprise
25+
- **83 skills** across recon, 58 web-app vuln-class + framework skills, enterprise
2626
platform attack, red-team tradecraft, and reporting — all **auto-loading by topic**,
2727
no invocation by name.
2828
- **681 disclosed-report patterns** curated from public HackerOne reports.

0 commit comments

Comments
 (0)