claude-osint
8 Claude skills · 100+ recon capabilities · 80 secret-regex patterns · 80+ dorks · 9 read-only credential validators · 27 attack-path templates · ~10,000 lines of structured tradecraft.
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
> /plugin marketplace add elementalsouls/Claude-BugHunter> /plugin install claude-bughunter@elementalsouls
Repo: elementalsouls/Claude-BugHunter
What's inside
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).
Built by Sachin Sharma — Bug Hunting & GenAI Security Research.
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:
bb-methodology + redteam-mindset: the 5-phase non-linear workflow, critical-thinking framework, and red-team operator discipline.hunt-* skills curated from 681 disclosed HackerOne reports: per-class detection patterns, payloads, bypass tables, and chain templates.triage-validation + reporting + evidence-hygiene: the 7-Question Gate, VRT-aware severity, OOS rebuttals, PII redaction, and red-team deliverables.All triggered automatically by topic — describe what you're testing in plain English and the relevant skill loads. No invocation by name.
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 82 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 | 82 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.
The skills are plain Agent Skills — the same SKILL.md format that Claude Code · OpenCode · OpenAI Codex CLI · Hermes Agent all load. One command installs them everywhere:
# macOS / Linux
bash scripts/install.sh --all --burp-mcp
# Windows (PowerShell)
pwsh ./scripts/install.ps1 -All -BurpMcp
--all (-All) copies the skills to every harness's path (~/.claude/skills, ~/.agents/skills, ~/.hermes/skills); --burp-mcp (-BurpMcp) wires the Burp MCP server into each. The full knowledge layer ports to all four — the slash commands and /hunt engine stay Claude-Code-only by design.
Chart is self-hosted — regenerate with python3 scripts/gen_star_history.py (needs gh auth login).
Refreshes automatically each Monday via .github/workflows/star-history.yml.
This bundle covers the external attack surface — anything reachable from the internet without first compromising an internal endpoint.
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.
82 skills, auto-loaded by topic — no invocation by name. Coverage across the external attack surface:
| Category | # | Examples |
|---|---|---|
| Web application hunting | 13 | XSS, SQLi, SSRF, IDOR, LFI, SSTI, XXE, CSRF, CORS, open-redirect |
| Authentication & identity | 7 | auth-bypass, session, OAuth, SAML, MFA-bypass, ATO |
| API & infrastructure | 15 | GraphQL, gRPC, WebSocket, API-misconfig, host-header, RCE |
| Advanced & concurrency | 6 | race-condition, HTTP smuggling, deserialization, cache-poison |
| Framework-specific | 4 | Next.js, Node.js, Laravel, Spring Boot |
| Enterprise identity & cloud ★ | 3 | M365/Entra, Okta, cloud-IAM-deep |
| Infrastructure & appliance ★ | 4 | VMware vCenter, enterprise VPN, SharePoint, ASP.NET/NTLM |
| Red-team tradecraft ★ | 4 | redteam-mindset, APK pipeline, supply-chain recon, mid-engagement IR |
| Recon & OSINT | 4 | web2-recon, offensive-osint, subdomain |
| Workflow, reporting & specialized | 11 | methodology, triage-validation, evidence-hygiene, VRT-aware reporting |
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.
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:
/hunt scaffold + cbh CLI — engagement-folder structure, state, and orchestration.→ Usage guide & worked example · 6-phase architecture & skill-to-phase map · cbh CLI
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.
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.
| 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) |
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:
External red-team engagement — exposed five additional gaps that bug-bounty defaults made worse:
redteam-mindsetmid-engagement-ir-detectionm365-entra-attack, okta-attack, hunt-sharepoint, hunt-aspnet, hunt-ntlm-info, vmware-vcenter-attack, enterprise-vpn-attack, apk-redteam-pipelineredteam-report-templatecloud-iam-deepThe 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.
hunt-fintech-graphql, hunt-healthcare-fhir, hunt-gov-compliancescope.md from program texthunt-* skills with newer disclosed reports (re-run public-skills-builder)citrix-netscaler-deep, f5-bigip-attack, ad-cs-attack (AD Certificate Services)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
Operational tradecraft accumulated across bug-bounty engagements and authorized pentests, codified into Claude skills. Platform-agnostic — slot into any engagement workflow you already use, or none.
Author: ElementalSoul · GenAI Security Research
Sister project: 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.
Vendored foundation: shuvonsec/claude-bug-bounty — methodology, validation, reporting, payload library (8 of 82 skills + 15 slash commands)
Generator tool used (not vendored): shuvonsec/public-skills-builder — used to scaffold per-class skills from H1 disclosed reports
Inspirations:
trailofbits/skills — skill-authoring disciplinetrilwu/secskills — subagent patternTool inventory:
This project is dual-licensed:
To be precise about the boundary: *.py, *.sh, and other source files are MIT; *.md documentation, wordlists, regex catalogs, and rubrics are CC BY 4.0.
Reuse the content freely — including commercially — as long as you credit Sachin Sharma / Claude-BugHunter and link back to this repository. See NOTICE for upstream-skills attribution.
"Give Claude the right skill and it stops being a chatbot. It becomes an operator."
.claude-plugin/
marketplace.json
plugin.json
.gitattributes
.github/
CODEOWNERS
FUNDING.yml
ISSUE_TEMPLATE/
bug_report.yml
config.yml
dx_feedback.yml
false_positive.yml
new_skill.yml
PULL_REQUEST_TEMPLATE.md
workflows/
skill-lint.yml
star-history.yml
.gitignore
assets/
architecture-overview.svg
banner-v2.svg
banner.png
capability-map.svg
engagement-flow.svg
harness-routing.svg
sponsors/
atlas-cloud-dark.svg
atlas-cloud-light.svg
star-history-dark.svg
star-history-light.svg
cbh/
__init__.py
cli.py
data/
skill_index.json
CHANGELOG.md
commands/
autopilot.md
chain.md
hunt.md
intel.md
memory-gc.md
pickup.md
recon.md
remember.md
report.md
scope.md
surface.md
token-scan.md
triage.md
validate.md
web3-audit.md
CONTRIBUTING.md
docs/
_config.yml
architecture.md
assets/
architecture-overview.svg
capability-map.svg
engagement-flow.svg
automation/
cve-refresh.yml.template
cbh-cli.md
credits.md
cve-coverage.md
disclosed-reports/
hunt-brute-force.md
hunt-business-logic.md
hunt-cache-poison.md
hunt-cors.md
hunt-csrf.md
hunt-deserialization.md
hunt-file-upload.md
hunt-graphql.md
hunt-host-header.md
hunt-http-smuggling.md
hunt-idor.md
hunt-ldap.md
hunt-lfi.md
hunt-mfa-bypass.md
hunt-nosqli.md
hunt-oauth.md
hunt-open-redirect.md
hunt-rce.md
hunt-saml.md
hunt-session.md
hunt-sqli.md
hunt-ssrf.md
hunt-ssti.md
hunt-xss.md
index.md
multi-harness.md
recon-manifest.md
recon-manifest.schema.json
skills.md
superpowers/
plans/
2026-08-09-autopilot-ledger.md
specs/
2026-08-09-engine-native-ledger-memory-design.md
verification/
apache-cve-2021-41773.md
hardened-lab/
hardened-lab-discipline-rules.md
app.py
jenkins-cve-2024-23897.md
juice-shop-2026-05-15.md
phase2e-jwt-graphql-race.md
phase2e-lab/
app.py
phase2f-lab/
app.py
phase2f-ssti-oauth-fileupload.md
phase2g-lab/
app.py
phase2g-saml-mfa-xxe.md
phase2h-lab/
docker-compose.yml
nginx/
Dockerfile
nginx.conf
origin/
app.py
Dockerfile
phase2h-smuggling-cachepoison.md
phase2i-lab/
app.py
phase2i-llm-ato.md
phase2j-cloud-localstack.md
phase3-playwright/
phase3-playwright-browser-execution.md
harness.py
target_app.py
recon-hackerone-vdp.md
spring-cve-2022-22963.md
ENGAGEMENTS.md
engine/
.gitignore
agent.py
burp-mcp.json.example
engagement.example.json
engine.py
memory.py
osint.py
README.md
recon.py
scope.py
skill_map.py
state.py
eval/
.gitignore
burp-mcp.json.example
challenges.json
fp_app.py
fp_cases.json
oracle_portswigger.py
ps_labs_hard.json
ps_labs.json
README.md
run_eval_ps_auto.py
run_eval_ps_par.py
run_eval_ps.py
run_eval.py
run_fp.py
INSTALL.md
LICENSE
LICENSE-CONTENT
NOTICE
pyproject.toml
README.md
scripts/
.identifier-denylist.sha256
cbh.py
gen_skill_catalog.py
gen_skill_index.py
gen_star_history.py
hunt.ps1
hunt.sh
install-community-skills.ps1
install-community-skills.sh
install.ps1
install.sh
lint_skills.py
refresh-cve-index.py
setup_harness_mcp.py
SECURITY.md
skills/
apk-redteam-pipeline/
SKILL.md
bb-local-toolkit/
SKILL.md
bb-methodology/
SKILL.md
bug-bounty/
SKILL.md
bugcrowd-reporting/
SKILL.md
cloud-iam-deep/
SKILL.md
enterprise-vpn-attack/
SKILL.md
evidence-hygiene/
SKILL.md
hunt-api-misconfig/
SKILL.md
hunt-aspnet/
SKILL.md
hunt-ato/
SKILL.md
hunt-auth-bypass/
SKILL.md
hunt-brute-force/
SKILL.md
hunt-business-logic/
SKILL.md
hunt-cache-poison/
SKILL.md
hunt-captcha-bypass/
SKILL.md
hunt-cicd/
SKILL.md
hunt-clickjacking/
SKILL.md
hunt-cloud-misconfig/
SKILL.md
hunt-cors/
SKILL.md
hunt-csrf/
SKILL.md
hunt-deserialization/
SKILL.md
hunt-dispatch/
SKILL.md
hunt-dom/
SKILL.md
hunt-exceptional-conditions/
SKILL.md
hunt-file-upload/
SKILL.md
hunt-forgot-password/
SKILL.md
hunt-graphql/
SKILL.md
hunt-grpc/
SKILL.md
hunt-host-header/
SKILL.md
hunt-html-injection/
SKILL.md
hunt-http-smuggling/
SKILL.md
hunt-idor/
SKILL.md
hunt-jwt-crypto/
SKILL.md
hunt-k8s/
SKILL.md
hunt-laravel/
SKILL.md
hunt-ldap/
SKILL.md
hunt-lfi/
SKILL.md
hunt-llm-ai/
SKILL.md
hunt-mfa-bypass/
SKILL.md
hunt-misc/
SKILL.md
hunt-nextjs/
SKILL.md
hunt-nodejs/
SKILL.md
hunt-nosqli/
SKILL.md
hunt-ntlm-info/
SKILL.md
hunt-oauth/
SKILL.md
hunt-open-redirect/
SKILL.md
hunt-race-condition/
SKILL.md
hunt-rag-vector/
SKILL.md
hunt-rce/
SKILL.md
hunt-saml/
SKILL.md
hunt-session/
SKILL.md
hunt-shadow-api/
SKILL.md
hunt-sharepoint/
SKILL.md
hunt-source-leak/
SKILL.md
hunt-spa-api/
SKILL.md
hunt-springboot/
SKILL.md
hunt-sqli/
SKILL.md
hunt-ssrf/
SKILL.md
hunt-ssti/
SKILL.md
hunt-subdomain/
SKILL.md
hunt-tls-network/
SKILL.md
hunt-websocket/
SKILL.md
hunt-xss/
SKILL.md
hunt-xxe/
SKILL.md
ios-redteam-pipeline/
SKILL.md
m365-entra-attack/
SKILL.md
meme-coin-audit/
SKILL.md
mid-engagement-ir-detection/
SKILL.md
offensive-osint/
README.md
references/
breach-and-credentials.md
dork-corpus.md
helpers-and-automation.md
identity-fabric.md
people-osint.md
probes-and-wordlists.md
recon-stack.md
recon-techniques.md
saas-public-surfaces.md
secret-patterns.md
secret-validators.md
sector-notes.md
severity-matrix.md
specialized-osint.md
tooling-install.md
scripts/
assets/
archivo-black.woff2
FONT-LICENSE.txt
dashboard.py
h1_reference.py
secret_scan.py
SKILL.md
okta-attack/
SKILL.md
osint-methodology/
README.md
SKILL.md
recon-scope-triage/
SKILL.md
redteam-mindset/
SKILL.md
redteam-report-template/
SKILL.md
report-writing/
SKILL.md
security-arsenal/
SKILL.md
supply-chain-attack-recon/
SKILL.md
triage-validation/
SKILL.md
vmware-vcenter-attack/
SKILL.md
web2-recon/
SKILL.md
web3-audit/
SKILL.md
USAGE.md8 Claude skills · 100+ recon capabilities · 80 secret-regex patterns · 80+ dorks · 9 read-only credential validators · 27 attack-path templates · ~10,000 lines of structured tradecraft.
FAQ
claude-bughunter is a Claude Code plugin with 82 hand-picked skills for security work, indexed on Flowy. Install it with the command on its page. It includes apk-redteam-pipeline, bb-local-toolkit, bb-methodology. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.