Claude-BugHunter README

The project's README from github.com/elementalsouls/Claude-BugHunter. As one markdown file: README.md.

claude-bughunter banner

claude-bughunter

A self-contained Claude skill bundle for bug hunting and external red-team work · 83 skills · 15 slash commands · 681 disclosed-report patterns (433 now individually cited & auditable) 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).

Built by Sachin Sharma — Bug Hunting & GenAI Security Research.

SPONSORED BY
Atlas Cloud      ThreatWatch360


What is this?

claude-bughunter is a drop-in skill bundle for the Claude Code skills system. Install once and Claude Code stops being a chatbot and starts behaving like a senior bug-hunting researcher or red-team operator: it knows the techniques, the chain templates, the VRT mappings, the platform CVE chains, and the hygiene — and it stays in scope.

Four layers stack:

All triggered automatically by topic — describe what you're testing in plain English and the relevant skill loads. No invocation by name.


Quickstart

Option A — install as a Claude Code plugin (recommended). From inside Claude Code:

/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsouls

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

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

git clone https://github.com/elementalsouls/Claude-BugHunter.git
cd Claude-BugHunter
# macOS / Linux
bash scripts/install.sh

# Windows (PowerShell)
pwsh ./scripts/install.ps1

Both copy the skills + commands into ~/.claude/ (macOS/Linux) or %USERPROFILE%\.claude\ (Windows) and wire the hunt engagement scaffolder.

What each install path gives you:

Path 83 skills + 15 slash commands cbh CLI hunt scaffolder
A — plugin ✅ namespaced under claude-bughunter: ➕ separate pipx install ❌ clone-only
B — copy install ✅ copied into ~/.claude/ ✅ from the clone ✅ from the clone

The plugin is the fastest path to the skills + slash commands. The terminal-native cbh runner installs standalone — pipx install git+https://github.com/elementalsouls/Claude-BugHunter — so plugin users can add it without a full clone (see cbh CLI). The hunt engagement scaffolder ships with the clone (Option B).

That's it. Open Claude Code and describe what you're testing in plain English — the right skill loads automatically, no invocation by name:

> Testing acme.com — an in-scope HackerOne target. Run recon and rank the surface.

  ⟳ loading skills: web2-recon, offensive-osint, bb-methodology …
    → subdomain enum (subfinder + crt.sh) … 47 hosts
    → live hosts (httpx) … 12 · tech fingerprint … 6 distinct stacks
    → ranked surface: api.acme.com (GraphQL, introspection ON)  ← start here
                      auth.acme.com (OAuth, SSO)               ← hunt-oauth

  Next: want me to probe the GraphQL introspection + OAuth redirect_uri?

→ Full Installation guide · Usage guide · searchable skill catalog.

The block above is an illustrative transcript. To record a real demo of your own session: asciinema rec demo.cast → upload to asciinema.org and drop the badge here.


Runs on multiple agent harnesses

One install, agent harnesses — Claude Code, OpenCode, Codex CLI, Hermes Agent, Google AntiGravity

The skills are plain Agent Skills — the same SKILL.md format that Claude Code · OpenCode · OpenAI Codex CLI · Hermes Agent · Google AntiGravity all load. One command installs them everywhere:

# macOS / Linux
bash scripts/install.sh --all --burp-mcp

# Windows (PowerShell)
pwsh ./scripts/install.ps1 -All -BurpMcp
Harness Target Skill Directory Flag
Claude Code (baseline) ~/.claude/skills/ (default)
OpenCode reads ~/.claude/skills/ & ~/.agents/skills/ (default) / --agents
OpenAI Codex CLI ~/.agents/skills/ --agents
Hermes Agent ~/.hermes/skills/ --hermes
Google AntiGravity ~/.gemini/config/skills/ --antigravity

--all (-All) detects installed harnesses and copies skills to each harness's path (~/.claude/skills, ~/.agents/skills, ~/.hermes/skills, ~/.gemini/config/skills); --burp-mcp (-BurpMcp) wires the Burp MCP server into each. The full knowledge layer ports to all five — the slash commands and /hunt engine stay Claude-Code-only by design.

→ Multi-harness guide


Star History

Star history chart for Claude-BugHunter

Chart is self-hosted — regenerate with python3 scripts/gen_star_history.py (needs gh auth login). Refreshes automatically each day via .github/workflows/star-history.yml.


Scope — what this bundle is for, and what it isn't

This bundle covers the external attack surface — anything reachable from the internet without first compromising an internal endpoint.

In scope

Out of scope (deliberate — not gaps, design decisions)

If you're running an internal red team that includes domain-takeover chains via Kerberos or lateral movement, this bundle won't help you in those phases — and we'd rather say that up front than have you find out mid-engagement. The external surface handoff to internal-RT tooling (Impacket, NetExec, CrackMapExec, Rubeus, Certify, BloodHound) is intentionally outside our scope. Coverage for internal AD and post-exploit may come in a future update.


What's inside

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

Category # Examples
Hunt — web app vuln classes 58 XSS, SQLi, SSRF, IDOR, LFI, SSTI, XXE, CSRF, CORS, open-redirect, SharePoint, ASP.NET/NTLM
Enterprise platform attack ★ 10 M365/Entra, Okta, cloud-IAM-deep, vCenter, enterprise VPN, APK/iOS red-team pipelines, supply-chain recon
Reporting & validation 6 triage-validation, evidence-hygiene, report-writing, bugcrowd-reporting
Recon & OSINT 5 web2-recon, offensive-osint, osint-methodology, recon-scope-triage
Methodology & mindset 4 bb-methodology, bug-bounty, redteam-mindset, bb-local-toolkit

Full searchable catalog → docs/skills.md. Also ships 15 slash commands (/hunt, /recon, /report, …) and a deterministic engagement engine (engine/) that maps a target's attack surface and routes each finding to the skill that handles it.


How it works

A 6-phase, non-linear workflow — recon → map & rank → hunt → validate → report — with scope enforced in code and a 7-Question Gate before anything is submitted. Two ways to drive it:

→ Usage guide & worked example · 6-phase architecture & skill-to-phase map · cbh CLI


Authorization

These skills are intended for assets you own or have written authorization to assess (bug-bounty in-scope assets, pentest engagement letters, CTF challenges, your own infrastructure).

The skills include validation gates that auto-trigger when you point Claude at unverified third-party targets — triage-validation's 7-Question Gate explicitly asks whether the asset is in scope (Q3) and on the program's accepted-impact list (Q2). The bugcrowd-reporting skill includes researcher-side hygiene (Bugcrowdninja alias, account-state restoration, friendly-tester posture) that signals legitimate authorized testing to the target's fraud team.

The bundle explicitly excludes: weaponizing 0-days against unauthorized targets, post-exploitation tooling, malware development, mass-targeting infrastructure. See SECURITY.md for the full posture.

Heads-up — Anthropic runtime cyber safeguards. Anthropic's models apply real-time safeguards that block "vulnerability exploitation or offensive security tooling development" by default — so even authorized, in-scope work can hit a refusal that isn't this bundle's doing. If you do authorized offensive security (pentest / bug bounty / red team), enroll in Anthropic's free, application-based Cyber Verification Program (CVP) to get safeguards adjusted for legitimate dual-use work. (Mass data exfiltration and ransomware development stay prohibited and are not adjustable.) Details: Anthropic — real-time cyber safeguards.

Why your model switched mid-session

Separate from refusals, and easy to miss. On Opus 5, a narrow set of higher-risk cyber requests — Anthropic names exploit generation, binary-based vulnerability scanning and penetration testing — fall back to Opus 4.8 rather than being refused. You get a notice and the response is labelled with the model that answered, but in a long agentic run that is easy to scroll past, so it can look like Opus 5 quietly got worse. See why Claude switched models.

What to do depends on what you are actually doing:

Situation What helps
Auditing your own code — reviewing a repo you own for defects Say so. "Defensive review of my own repo", "check this against the OWASP Top 10", "secure refactor to remediate" describe the work accurately and read as remediation. This is not a workaround; the work genuinely is defensive.
Authorized offensive work — live engagement, PoC for a bounty submission This is what the bundle is for, and the supported route is CVP. Do not reword an offensive engagement to look defensive to get past a classifier — enroll instead.
You just want the switching off Settings → Capabilities disables automatic model switching.

/hunt states the engagement frame (authorized, scope-bounded, remediable finding) on its first turn for exactly this reason — engagement context belongs in the session explicitly, not implied.


Documentation

Doc Contents
README.md This file — overview, quickstart, scope, skill summary
INSTALL.md Full setup with Burp MCP integration and optional skill regenerator
USAGE.md Workflow walkthrough · decision tree · worked engagement example
docs/architecture.md 6-phase architecture · skill-to-phase mapping · engagement composition
docs/cbh-cli.md cbh CLI — native runner orchestrating recon + classify + triage + report
docs/cve-coverage.md CISA KEV coverage snapshot — refreshed weekly via the workflow template at docs/automation/cve-refresh.yml.template
docs/credits.md Full attribution: 43 original skills + 8 vendored from upstream
CONTRIBUTING.md PR guidelines · skill quality standards · scope
SECURITY.md Authorized-use posture · responsible disclosure · what's excluded
LICENSE MIT
NOTICE Upstream-skills attribution · no-redistribution note
LICENSE-CONTENT CC BY 4.0 (skill methodology, wordlists, docs)

Why this exists

Most bug-hunting Claude setups are either too generic (one big "security" prompt) or too fragmented (you bookmark 30 disclosed reports and re-read them every engagement). Neither scales past the second target.

This bundle was built and validated through authorized engagements that exposed different capability gaps:

Bug-bounty engagement — surfaced four gaps a starter 3-skill stack could not close:

  1. No hypothesis discipline — drafts written before validation → wasted hours, hurt validity ratio
  2. No per-program reporting tactics — VRT defaults auto-downgraded P3-worthy findings to P4
  3. No engagement coordination — findings, evidence, and submission IDs scattered across folders
  4. No evidence hygiene — screenshots leaked cookies and victim PII

External red-team engagement — exposed five additional gaps that bug-bounty defaults made worse:

  1. Conservative defaults retracted real findings — WAPT mindset stopped tests early on defended targets where red-team continuation would have surfaced bypass chains → redteam-mindset
  2. No mid-engagement situational awareness — client SOC patched confirmed SQLi within 30 min; external attacker locked 14 accounts during a live test session — both invisible without explicit detection methodology → mid-engagement-ir-detection
  3. No enterprise-platform attack chains — M365 + Entra ID, on-prem SharePoint, Cisco SSL VPN, vCenter, and 7 Android APKs all needed current 2024-2026 CVE knowledge and platform-specific tradecraft → m365-entra-attack, okta-attack, hunt-sharepoint, hunt-aspnet, hunt-ntlm-info, vmware-vcenter-attack, enterprise-vpn-attack, apk-redteam-pipeline
  4. No client-facing deliverable format — bug-bounty report templates don't fit enterprise red-team where output is a 50KB+ MD + DOCX with embedded screenshots → redteam-report-template
  5. No post-credential escalation model — when recon yielded credentials (AWS keys, JWTs, GCP JSON), it was unclear what they granted or how to escalate → cloud-iam-deep

The per-class hunt-* skills address gap-zero ("what should I look for in webapps") — the original 24 codifying patterns from 681 disclosed HackerOne reports, with 20+ framework/surface skills added by the community v3 expansion — Claude knows the actual chain templates real triagers paid for, not abstract OWASP Top 10. The enterprise-platform and red-team-tradecraft layers address what bug-bounty alone cannot: external red-team engagements against monitored enterprise targets.


Roadmap


Sponsors

Atlas Cloud

Atlas Cloud is a full-modal AI inference platform that gives developers a single AI API to access video generation, image generation, and LLM APIs. Instead of managing multiple vendor integrations, you connect once and get unified access to 300+ curated models across all modalities.

Check out Atlas Cloud's new coding plan promotion for more budget-friendly API access: https://www.atlascloud.ai/console/coding-plan

Claude-BugHunter (elementalsouls/Claude-BugHunter)

Searching Database…

这是什么?这是一套即插即用的 Claude Code 技能系统技能包,能把 Claude 变成漏洞挖掘研究员或红队操作员:内含 83 个技能、15 个斜杠命令,以及从 24 类漏洞的 681 份公开 HackerOne 报告中整理出的知识,外加企业身份与基础设施攻击矩阵。
这是独立应用,还是接入其他东西的插件?它以 Agent Skills 的形式接入 Claude Code(及其他代理 harness)——就是普通的 SKILL.md 文件,不是独立应用。同一套技能包也能加载到 OpenCode、OpenAI Codex CLI、Hermes Agent 和 Google AntiGravity 中。
它只能配合 Claude Code,还是其他编码代理也能用?Claude Code 是基线,但同一批技能可以通过一条安装命令(带针对各 harness 的参数)安装到 OpenCode、OpenAI Codex CLI、Hermes Agent 和 Google AntiGravity;斜杠命令和 /hunt 引擎则仅限 Claude Code 使用。
它也涵盖内网 Active Directory 攻击或 C2 技战术吗?不涵盖——这是有意排除的。该技能包只覆盖外部攻击面;内部 AD 攻击(BloodHound、Kerberoasting、DCSync)、C2 框架(Cobalt Strike、Sliver)、后渗透/持久化、免杀以及 iOS/硬件渗透测试都被明确排除在范围之外,留给其他工具处理。
把它指向目标之前需要获得授权吗?需要——这些技能只应用于你拥有或获得书面授权评估的资产,例如漏洞赏金范围内的资产、已签署的渗透测试委托书或 CTF 题目;内置的 7 问门禁(7-Question Gate)会在提交任何内容前检查授权范围。
即使我的测试是授权的,Anthropic 自身的防护也会拦截吗?有可能——Anthropic 的模型默认对攻击性安全工具施加实时防护,即使在授权范围内的工作也可能触发拒绝;README 建议注册 Anthropic 的 Cyber Verification Program,以便针对合法的两用测试调整防护。
cbh CLI 是什么?它是一个原生于终端的运行器,用于统筹一次安全评估中的侦察、分类、分诊和报告;即使不完整克隆仓库,也可以通过 pipx 单独安装。
在我提交发现之前,7 问门禁会检查什么?它是 triage-validation 技能中的一个验证门禁,在众多检查中会明确确认资产在授权范围内(Q3)、且在项目可接受的影响类型清单上(Q2),然后才发出报告。
Burp MCP 集成是做什么的?安装参数 --burp-mcp 会把 Burp Suite MCP 服务器接入你安装这些技能的任何代理 harness,把技能包直接连接到 Burp 的代理和扫描工具。
为什么 Claude 在会话中途做攻击性安全任务时似乎会变差?在 Opus 5 上,一小部分风险较高的网络安全请求(漏洞利用生成、基于二进制的漏洞扫描、渗透测试)会静默回退到 Opus 4.8 处理而不是被拒绝,响应只标注实际回答请求的模型。
Size
3.8 MB
Stars
5.1K
Age
5mo
Commits · 90 Days