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.

feat(engine): make all 58 hunt-* skills reachable through skill routing (#81)

Sushant Poudel59c358a14a89
diff --git a/engine/engine.py b/engine/engine.py
index b66a657..b4b36a7 100644
--- a/engine/engine.py
+++ b/engine/engine.py
@@ -27,11 +27,20 @@ from state import Engagement # noqa: E402
import agent as A # noqa: E402
import memory # noqa: E402 (autopilot ledger; import-isolated)
-# deterministic priority by class (impact-ish); used by rank
-CLASS_WEIGHT = {"rce": 100, "sqli": 90, "ssrf": 85, "auth-bypass": 85, "idor": 80,
- "deserialization": 88, "xxe": 75, "ssti": 88, "lfi": 78, "llm-ai": 70,
- "graphql": 65, "open-redirect": 40, "xss": 55, "cors": 45, "csrf": 50,
- "info-leak": 30}
+# deterministic priority by class (impact-ish); used by rank. Keep in sync with
+# skill_map.CLASS_SKILL so every routed class gets a sensible (non-default) weight.
+CLASS_WEIGHT = {"rce": 100, "sqli": 90, "deserialization": 88, "ssti": 88,
+ "jwt-crypto": 88, "ato": 88, "ssrf": 85, "auth-bypass": 85, "idor": 80,
+ "lfi": 78, "k8s": 78, "xxe": 75, "forgot-password": 75, "cache-poison": 72,
+ "cicd": 72, "host-header": 70, "http-smuggling": 70, "fintech-graphql": 70,
+ "subdomain-takeover": 70, "llm-ai": 70, "mfa": 70, "nosqli": 68,
+ "file-upload": 68, "cloud-misconfig": 65, "graphql": 65, "saml": 65,
+ "oauth": 62, "websocket": 60, "brute-force": 60, "ldap": 60,
+ "race-condition": 58, "business-logic": 58, "xss": 55, "spa-api": 55,
+ "rag-vector": 55, "shadow-api": 52, "csrf": 50, "captcha-bypass": 48,
+ "cors": 45, "open-redirect": 40, "clickjacking": 38, "secret": 35,
+ "info-leak": 30, "tls-network": 30, "html-injection": 30,
+ "exceptional-conditions": 30, "ntlm-info": 25}
# OSINT (subdomain/asset enum) is a SEPARATE concern (Claude-OSINT) — not in the engine flow.
# DEFAULT = recon -> rank -> map (deterministic, ~free): map the surface to the skill arsenal and
# SHOW it. The operator focuses their effort from there. hunt/validate/report are OPT-IN (--hunt).
diff --git a/engine/recon.py b/engine/recon.py
index e9d5832..5707a12 100644
--- a/engine/recon.py
+++ b/engine/recon.py
@@ -228,6 +228,7 @@ def classify(item):
if p in names:
return cls
rules = [
+ (("ws://", "wss://", "/socket.io", "websocket"), "websocket"),
(("/graphql",), "graphql"),
(("/chat", "/ai", "/llm", "completion", "/assistant", "/agent", "prompt", "/copilot"), "llm-ai"),
(("redirect", "returnurl", "callback", "goto", "/go"), "open-redirect"),
@@ -236,6 +237,12 @@ def classify(item):
(("/search", "/query", "keyword"), "sqli"),
(("/login", "/signin", "/register", "/auth", "/oauth", "/token", "/session"), "auth-bypass"),
(("/proxy", "/fetch", "webhook"), "ssrf"),
+ (("/jenkins", "/teamcity", "/drone", "/argo", "/.gitlab-ci", "/.github/workflows"), "cicd"),
+ (("kubernetes", "/apis/", "/api/v1/namespaces", "kubelet"), "k8s"),
+ (("s3.amazonaws", "storage.googleapis", "blob.core.windows", "cloudfront.net"), "cloud-misconfig"),
+ (("/forgot-password", "/forgot", "/reset-password", "/password-reset", "/recover"), "forgot-password"),
+ (("captcha", "recaptcha"), "captcha-bypass"),
+ (("jwt",), "jwt-crypto"),
]
for keys, cls in rules:
if any(k in url for k in keys):
@@ -262,6 +269,10 @@ def classify_all(item, max_classes=3):
extras += ["graphql", "info-leak"]
if any(k in url for k in ("/api", "/rest", "/v1", "/v2")):
extras += ["info-leak", "idor", "auth-bypass"]
+ if any(k in url for k in ("ws://", "wss://", "/socket.io", "websocket")):
+ extras += ["websocket"]
+ if re.search(r"/v\d+/", url):
+ extras += ["shadow-api"]
if p: # any parameter is a generic injection / IDOR surface
extras += ["idor", "sqli", "xss"]
for e in extras:
@@ -299,6 +310,14 @@ def classes_for_param(name, url=""):
add("sqli", "xss")
if any(k in n for k in ("auth", "token", "session", "login", "sso", "saml", "oauth")):
add("auth-bypass")
+ if any(k in n for k in ("otp", "mfa", "2fa", "totp", "captcha", "recaptcha")):
+ add("mfa", "brute-force", "captcha-bypass")
+ if any(k in n for k in ("reset", "recover", "forgot")):
+ add("forgot-password", "ato")
+ if "jwt" in n:
+ add("jwt-crypto", "auth-bypass")
+ if any(k in n for k in ("websocket", "socket")):
+ add("websocket")
if not cls:
add("sqli", "xss", "idor") # any reflected/used param is a generic injection/IDOR surface
return cls[:3]
diff --git a/engine/skill_map.py b/engine/skill_map.py
index 9be9e70..a192167 100644
--- a/engine/skill_map.py
+++ b/engine/skill_map.py
@@ -40,18 +40,31 @@ def _resolve_skills_dir():
SKILLS_DIR = _resolve_skills_dir()
-# attack class -> hunt skill(s) in the bundle
+# attack class -> hunt skill(s) in the bundle.
+# NOTE: hunt-dispatch is an internal loader (for the /hunt orchestrator) and is intentionally
+# not listed here — it routes no attack class of its own.
CLASS_SKILL = {
"sqli": ["hunt-sqli"], "nosqli": ["hunt-nosqli"], "xss": ["hunt-xss", "hunt-dom"],
"ssrf": ["hunt-ssrf"], "idor": ["hunt-idor"], "open-redirect": ["hunt-open-redirect"],
"lfi": ["hunt-lfi"], "ssti": ["hunt-ssti"], "rce": ["hunt-rce"], "xxe": ["hunt-xxe"],
- "auth-bypass": ["hunt-auth-bypass", "hunt-session"], "llm-ai": ["hunt-llm-ai"],
+ "auth-bypass": ["hunt-auth-bypass", "hunt-session"], "ato": ["hunt-ato", "hunt-forgot-password"],
+ "llm-ai": ["hunt-llm-ai"], "rag-vector": ["hunt-rag-vector", "hunt-llm-ai"],
"saml": ["hunt-saml"], "oauth": ["hunt-oauth"], "mfa": ["hunt-mfa-bypass"],
- "graphql": ["hunt-graphql"], "csrf": ["hunt-csrf"], "cors": ["hunt-cors"],
+ "graphql": ["hunt-graphql"], "fintech-graphql": ["hunt-fintech-graphql", "hunt-graphql"],
+ "csrf": ["hunt-csrf"], "cors": ["hunt-cors"], "clickjacking": ["hunt-clickjacking"],
"info-leak": ["hunt-source-leak", "hunt-api-misconfig"], "secret": ["hunt-source-leak"],
+ "shadow-api": ["hunt-shadow-api", "hunt-source-leak"], "spa-api": ["hunt-spa-api", "hunt-source-leak"],
"deserialization": ["hunt-deserialization"], "file-upload": ["hunt-file-upload"],
"host-header": ["hunt-host-header"], "http-smuggling": ["hunt-http-smuggling"],
- "race-condition": ["hunt-race-condition"], "business-logic": ["hunt-business-logic"],
+ "cache-poison": ["hunt-cache-poison"], "race-condition": ["hunt-race-condition"],
+ "business-logic": ["hunt-business-logic"], "brute-force": ["hunt-brute-force"],
+ "captcha-bypass": ["hunt-captcha-bypass"], "forgot-password": ["hunt-forgot-password", "hunt-ato"],
+ "jwt-crypto": ["hunt-jwt-crypto", "hunt-ato"], "websocket": ["hunt-websocket"],
+ "html-injection": ["hunt-html-injection", "hunt-xss"],
+ "exceptional-conditions": ["hunt-exceptional-conditions", "hunt-source-leak"],
+ "cicd": ["hunt-cicd"], "k8s": ["hunt-k8s"], "cloud-misconfig": ["hunt-cloud-misconfig"],
+ "ldap": ["hunt-ldap"], "ntlm-info": ["hunt-ntlm-info"], "tls-network": ["hunt-tls-network"],
+ "subdomain-takeover": ["hunt-subdomain"],
}
# detected tech -> tech-specific skill(s)
@@ -59,7 +72,10 @@ TECH_SKILL = {
"next.js": ["hunt-nextjs"], "node.js": ["hunt-nodejs"], "react": ["hunt-dom"],
"wordpress": ["hunt-sqli", "hunt-idor"], "laravel": ["hunt-laravel"], "spring": ["hunt-springboot"],
"asp.net": ["hunt-aspnet"], "sharepoint": ["hunt-sharepoint"], "graphql": ["hunt-graphql"],
- "grpc": ["hunt-grpc"],
+ "grpc": ["hunt-grpc"], "kubernetes": ["hunt-k8s"], "docker": ["hunt-k8s"],
+ "websocket": ["hunt-websocket"], "socket.io": ["hunt-websocket"],
+ "jenkins": ["hunt-cicd"], "teamcity": ["hunt-cicd"], "drone": ["hunt-cicd"],
+ "argo": ["hunt-cicd"], "github actions": ["hunt-cicd"], "gitlab ci": ["hunt-cicd"],
}
# curl-first starter probe per class. {u}=url with FUZZ->1, {ur}=injection prefix (before the value)
@@ -83,6 +99,27 @@ CLASS_PROBE = {
"host-header": "curl -s \"{u}\" -H 'Host: evil.example' # check for reflection / cache / pw-reset poisoning",
"saml": "curl -s \"{u}\" # inspect SAML/SSO config endpoints; test XSW / signature-stripping / IdP confusion (needs auth)",
"oauth": "curl -s \"{u}\" # check redirect_uri validation, state, PKCE, token leakage",
+ "ato": "curl -s \"{u}\" # reset/email-change flows: host-header poisoning, token in body/referer, no-expiry/reuse",
+ "forgot-password": "curl -s \"{u}\" # diff valid vs invalid email responses; check token in response/referer, replay, rate limit",
+ "brute-force": "curl -s -X POST \"{u}\" -d 'user=a&pass=b' # measure lockout/throttle; try X-Forwarded-For bypass",
+ "captcha-bypass": "curl -s -X POST \"{u}\" # omit/blank/replay the captcha field; test cross-endpoint acceptance",
+ "jwt-crypto": "curl -s \"{u}\" # decode the JWT; test alg:none / RS256->HS256 key confusion",
+ "websocket": "curl -s \"{u}\" -H 'Upgrade: websocket' -H 'Connection: Upgrade' -H 'Origin: https://evil.example' # check Origin validation",
+ "html-injection": "curl -s \"{ur}<b>marker</b>\" # raw HTML reflected (no script exec) -> escalate to XSS if JS runs",
+ "cache-poison": "curl -s \"{u}\" -H 'X-Forwarded-Host: evil.example' # check if unkeyed input is cached and served to others",
+ "shadow-api": "curl -s \"{u}\" # enumerate v1/v2/beta/legacy paths; diff Wayback OpenAPI for auth regressions",
+ "spa-api": "curl -s \"{u}\" # pull JS bundle -> backend route map -> test for missing auth middleware",
+ "exceptional-conditions": "curl -s \"{u}\" # malformed/unexpected input -> verbose stack-trace / ORM / path leak",
+ "cicd": "curl -s \"{u}\" # exposed CI dashboard / workflow-injection surface (pull_request_target, self-hosted runner)",
+ "k8s": "curl -s \"{u}\" # API anonymous access, kubelet /run, etcd unauth",
+ "cloud-misconfig": "curl -s \"{u}\" # anonymous read on S3/GCS/Blob; PutObjectAcl public-write",
+ "ldap": "curl -s \"{ur}*)(objectClass=*\" # LDAP search-filter injection in auth/search",
+ "ntlm-info": "curl -sI \"{u}\" # WWW-Authenticate: NTLM -> leak domain/forest/computer name",
+ "tls-network": "curl -sI \"{u}\" # HSTS / weak cipher / SPF-DKIM-DMARC / DNS AXFR",
+ "subdomain-takeover": "curl -sI \"{u}\" # dangling CNAME -> check claimable provider",
+ "rag-vector": "curl -s \"{u}\" # shared knowledge base / vector-DB port; cross-tenant query",
+ "fintech-graphql": "curl -s -X POST \"{u}\" -d '{\"query\":\"{__schema{types{name}}}\"}' # money-movement mutations, idempotency-key double-spend",
+ "clickjacking": "curl -sI \"{u}\" # missing X-Frame-Options / CSP frame-ancestors -> confirm framing in a browser",
}
@@ -132,5 +169,11 @@ if __name__ == "__main__":
for s in skills if _present() and s not in _present()]
print(f"skill_map: {len(CLASS_SKILL)} class mappings, {len(TECH_SKILL)} tech mappings")
print(f" skills referenced but NOT installed: {sorted(set(miss)) or 'none'}")
- for c in ("sqli", "open-redirect", "llm-ai", "idor"):
+ # coverage: every installed hunt-* skill should be reachable through CLASS_SKILL/TECH_SKILL
+ # (hunt-dispatch is an internal loader and hunt-misc is the explicit fallback — both exempt).
+ mapped = {s for skills in list(CLASS_SKILL.values()) + list(TECH_SKILL.values()) for s in skills} | {"hunt-misc"}
+ present = _present()
+ unreachable = sorted({s for s in present if s.startswith("hunt-") and s != "hunt-dispatch"} - mapped)
+ print(f" installed hunt-* skills NOT reachable through any mapping: {unreachable or 'none'}")
+ for c in ("sqli", "open-redirect", "llm-ai", "idor", "websocket", "cicd"):
print(f" {c:14s} -> {skills_for(c, ['Next.js'])} :: {probe_for(c, 'https://t/?p=FUZZ', 'p')}")