mcpbeat Sign in

Hunt Core Agent Skill

> the confirmation gate that separates a real finding from a false positive, enumeration limits, stop conditions, marker discipline, wiki-first query and self-heal, FIND output, Deadends, and wiki distillation. ALWAYS LOADED alongside any hunt skill. Also trigger directly on "is this in scope", "is this a real bug", "how do I confirm this", "should I keep going", "how many IDs should I test", "what severity", "how do I report this", "I got someone else's data". Every hunt-* skill assumes this file; without it they run without their safety and quality layer.

3k tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
320
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/Encod3d-Sec/TORCH --skill hunt-core

What it tells the agent to use

found in the instruction text
Read reads your files

The instruction itself

11 sections, as written by the author

Hunt: Core

The discipline every hunt-* skill assumes. Class-specific technique lives in the hunt skills and

the wiki; this file holds what is true regardless of which bug class you are chasing.

Owned here, never repeated in a hunt skill: the scope gate, two-account setup, confirmation

gate, enumeration limits, stop conditions, marker discipline, wiki query/self-heal protocol, FIND

output, Deadends, and distillation. A hunt skill that restates any of these will drift from this

one; reference it instead.

Scope gate

Hunting means reading other people's data, escalating privileges, and creating accounts. Outside

an authorized engagement all of it is a crime. Before any request leaves the machine:

  • Authorization - a program with the target in scope, a signed agreement, your own lab, or a

CTF. "Probably fine" is not authorization.

  • Scope - exact hosts. *.target.com does not cover targetapp.io, an acquisition, or

target.com.cdn.net. Read targets/<eng>/scope.md.

  • Exclusions and forbidden techniques - check no_bruteforce, scanning caps, DoS, social

engineering, and any per-program rule before the technique that would violate it.

  • Two accounts, both yours - see below. Required for any authorization-class bug.
  • Deadends - read targets/<eng>/Deadends.md and skip what is already exhausted.

Unconfirmed on any of these: ask. Do not infer scope from the fact that a host resolved. Discovery

is not authorization. The scope-guard hook enforces the host check on Bash commands; it is a

backstop, not the gate.

Two-account rule

Authorization findings are "account A reached account B's object." Without B you have two bad

options: test against a real user, or report a guess. Both are worse than not reporting.

  • User A - resource owner. User B - attacker. Separate browser profiles so cookies never

cross.

  • Record both internal IDs in targets/<eng>/identities.md as you discover them.
  • Cross-tenant work needs two *tenants*, not two users in one. Many apps isolate tenants correctly

and users not at all.

Confirmation gate

Nothing becomes a FIND on the strength of a response body. The gate is per class; the hunt skill

owns the specific "NOT confirmation / IS confirmation" list. Universal rules:

  • Re-verify in a clean session. Fresh token, new profile, no cached state. If the effect

vanishes, you changed your own screen.

  • Exercise the capability. Not "the server accepted it" but perform the action only the new

state permits.

  • Rule out legitimate access. Before claiming cross-account access, confirm A is not

*supposed* to see it: shared teams, sharing links, public objects, org-wide visibility. The

most common false positive in authorization testing.

  • Blind classes need an OOB HIT. No inference-only findings. The oob.md row must flip to

HIT before a FIND is scaffolded.

  • Reproduce from scratch against your own written steps.

Failed 1-3 is a Deadend, not a "probably real but hard to prove."

[[wiki/techniques/methodology/safe-probing-and-controls]] carries the other half of this gate: how to probe destructive or

sensitive surface without touching a real record (use an identifier proven not to exist), and how

to fire a control so a NEGATIVE result means something instead of being assumed.

When the hunt spans many hosts, sessions, or parallel agents, the coordination layer adds failure

modes this gate does not cover: claims nobody re-checked, requests nobody counted, the same finding

filed twice, and severity drifting upward as work is summarised. See

[[wiki/techniques/methodology/multi-agent-campaign-orchestration]].

Enumeration limits

Prove the boundary is missing, not how much is behind it.

The server does not check *any* object. Demonstrating that takes two or three identifiers. A

thousand-ID sweep does not raise severity; it collects real users' data and converts a critical

finding into an incident report naming you.

  • Default: 5 identifiers. Enough to show a sequential pattern and a missing check.
  • Ceiling without explicit operator approval: 20.
  • Beyond that, and for any range sweep: stop and ask. State why the extra volume changes the

finding. Usually it does not.

  • no_bruteforce in scope means range 0. No sweep, no ffuf over an ID list, no exception.
  • Never enumerate writes. Read at volume is a rate problem; write at volume is destruction.

For scale evidence, cite a total field, a pagination header, or a result count. "The response

reports 41,180 records; none beyond my two test accounts were retrieved" proves scale without

retrieving anything.

Scope of these limits. They govern OBJECT and RECORD enumeration (guessing identifiers to pull

other users' data). They do NOT cap legitimate service discovery: an SSRF internal port sweep or a

network map is bounded by the engagement RoE (no_dos, scan-rate caps), not by the 5-to-20 object

ceiling. Thread it and honor the cap; do not clamp a port sweep to 20.

Stop conditions

Stop and report rather than continuing when:

  • You received real user data. An ID you guessed belonged to someone real, a cache served

another session, a beacon fired in a live employee context. Do not re-request to confirm, do not

save it, do not use anything in it. Report immediately, state what you received and that you

destroyed it, and note it in the FIND rather than hiding it.

  • The next step is destructive or persistent - deleting objects, modifying another tenant's

config, planting content that outlives the session.

  • You have a traffic-affecting primitive - desync, cache poisoning, connection-pool effects.

The mechanism is the finding.

  • The last step needs volume beyond the limits above.
  • You already have the severity ceiling. More escalation, more risk, no more payout.
  • You left scope. Even one hop. Especially one hop.

Stopping is not failure. "Confirmed and did not exploit" is worth more than a forfeited payout.

Wrong-vector tells (switch the vector, do not tune the tooling). A vector is exhausted the

moment it starts fighting you; grinding harder is the sunk-cost trap. Two mechanical signals mean the

current vector is the wrong door, not that your tooling needs another pass:

  • The target starves under your own exploit loop (repeated 000 / connection-timeout /

empty-reply while you hammer one endpoint). A vector that DoSes a lab box is almost never the

intended one. Stop, let it drain, and enumerate a DIFFERENT class (source-read: LFI /

alias-traversal / .git / backup; a second service or vhost's own app; OOB creds) before returning.

  • Two verified hashes in a row fail the primary wordlist. The passwords are not wordlist

material - they are delivered out-of-band (an email/note/KeePass, a config, a second service). Stop

cracking and re-enumerate for where the creds are HANDED OUT; do not extract a third hash. (Engineering

around a hostile channel - per-char verify-fix, min-of-2 sampling, gentler pacing - is the tell you

are on the wrong vector, not a reason to keep going.)

When a wrong-vector tell fires and the next door is not obvious, call Skill(redteamlead) before

grinding further - it reads the engagement state + evidence + wiki and returns ranked directions with

an explicit STOP. That is exactly what it is for ("I'm stuck / which vector / should I keep hammering

this"); one RTL call at the first sign a vector is fighting back beats hours of sunk-cost grind.

Marker discipline

Any class where you inject a value and look for it later (xss, ssti, sqli error strings, crlf, log

injection, open redirect): use a unique 8+ char alphanumeric canary (e.g. x4hd2k9pq), never

test/marker/evil/payload. Check the baseline response for the canary BEFORE claiming

reflection; a value already present is not proof you put it there.

Wiki lookup (reference-map first, qmd on a hint)

qmd_query is powerful but ~15-30s per call, so it is a TARGETED deepen, not a pre-attack ritual.

Three tiers, in order:

  • Reference map FIRST (instant Read). Your hunt skill's ## Wiki section names the class's

domain MOC + primary page + a few anchors. Read those directly, and one-hop from the MOC for a

sibling technique. This answers the anticipated case with zero qmd latency.

  • qmd_query ONLY on a concrete hint the map does not cover - a specific sink/function (an

SSRF-reaching requests.get(user_input)), an observed escape (a <script> context that could be

XSS), a fingerprinted version/CVE, or a service the MOC does not list:

qmd_query "<the specific thing>" via wiki-search MCP. It auto-surfaces pages added since the

skill was written. Do NOT blanket-qmd every action (too slow); do NOT hand-roll from memory when a

targeted qmd would answer (that is the opposite failure). Fire it when you have the hint, then act.

  • Self-heal only if neither the map nor a targeted qmd has it: stub

wiki/techniques/<area>/<slug>.md (frontmatter + ## Observed during <engagement>) so the gap fills.

Payload arsenals live in wiki/payloads/. If the MCP is down, bash scripts/wiki-query.sh "<terms>"

wraps the same qmd index (-k for an exact CVE/string).

Hunt approaches (which skill for the signal)

hunt-core is the hub: route from the observed signal to the class skill, load it, then use that

skill's ## Wiki map. The recon-capture fingerprint router auto-suggests many of these from tool

output; this table is the manual reference when it does not fire or you are reasoning about approach.

| Signal / surface | Skill |

|---|---|

| reflected/stored input, <script> / onerror / javascript: / a DOM sink | Skill(hunt-xss) |

| a param/body reaching a DB; an error / boolean / time oracle | Skill(hunt-sqli) |

| a URL/host param, a fetch/preview/import sink, ?url= | Skill(hunt-ssrf) |

| an object id, /users/{id}, two-account cross-access | Skill(hunt-idor) |

| template {{ }} render, XXE (SVG/DOCX/SAML), GraphQL | Skill(hunt-injection) |

| a command sink, template-injection-to-exec, a version+CVE | Skill(hunt-rce) |

| a serialized blob (rO0 / AAEAAAD / O:), viewstate, a signed cookie | Skill(hunt-deserialization) |

| login / reset / session / JWT, a legacy-protocol endpoint | Skill(hunt-auth) |

| OAuth / SAML redirect_uri or assertion | Skill(hunt-federation) |

| file upload / avatar / document import | Skill(hunt-upload) |

| REST/GraphQL/gRPC, BOLA / BFLA / mass-assignment | Skill(hunt-api) |

| checkout / price / coupon / workflow logic, a race | Skill(hunt-bizlogic) |

| CL.TE / TE.CL / HTTP-2 downgrade desync | Skill(hunt-smuggling) |

| an unkeyed header/param reaching a cache | Skill(hunt-cache) |

| exposed .git / .env / keys, secrets in a JS bundle | Skill(hunt-secrets) |

| LLM prompt-injection / excessive agency | Skill(hunt-llm) |

| MCP tool-poisoning / indirect injection | Skill(hunt-mcp) |

| AD: kerberoast / AS-REP / ADCS / DCSync / delegation (dotted-FQDN domain / a DC) | Skill(hunt-ad) |

| Windows LOCAL privesc: service misconfig / autologon reg / SeImpersonate-Potato / scheduled-task / DLL hijack (standalone/workgroup box, or a local shell on a member) | Skill(hunt-windows) |

| AWS/Azure/GCP metadata or IAM | Skill(hunt-cloud) |

| Microsoft 365 / Entra tenant | Skill(hunt-m365) |

| CI/CD pipeline (Actions / runners / OIDC) | Skill(hunt-cicd) |

| macOS TCC / SIP / keychain / XPC | Skill(hunt-macos) |

| SSL-VPN appliance (Fortinet/Citrix/Ivanti/Cisco/PAN) | Skill(hunt-vpn) |

| Modbus / S7 / EtherNet-IP / PLC / HMI | Skill(hunt-ics) |

Process skills (not vuln classes): Skill(ctf-box) boot-to-root, Skill(wiki-recon) external recon,

Skill(arsenal) / Skill(wiki-arsenal) tool+payload lookup, Skill(triage) -> Skill(evidence)

finding validation, Skill(coverage) untested-class gaps, Skill(next-move) prioritize,

Skill(hunt-burp) drive Burp.

FIND output

On confirmation:

Create Vulns/Research/FIND-XXX-SEVERITY-<class>-<host>[-<resource>].md
Add row to Vuln-index.md

Severity is rated on demonstrated impact, not theoretical maximum. Preconditions lower it

(victim interaction, an unguessable identifier you cannot show leaking, a race you win one time in

twenty). Scale raises it, when you can show the identifier is enumerable without enumerating. State

impact in the program's terms (customer data, account security, financial exposure), not in

vulnerability classes.

On exhaustion:

Append to Deadends.md: - [ ] <class> on <host> <param/endpoint> -- <why it failed>

The reason matters more than the entry. 403 on cross-account, authorization enforced stops you

retesting; a bare entry does not.

Distillation

When a confirmed finding is a reusable technique rather than a target quirk, stage it:

python3 scripts/wiki-stage.py --kind technique --slug <slug> --target-page <area>/<page>.md

GENERIC only - no client host, no real identifier, no customer data. Promote later via

scripts/wiki-promote.py. Run scripts/check-leaks.sh before any push. Engagement data lives

under targets/ and is git-ignored.

How to use it

Copy the folder

Take encod3d-sec/hunt-core from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.