# hunt

Conducts targeted vulnerability hunting by validating scope, fingerprinting stacks, and dispatching exploit tests.

- skill · `type=skill` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1298 repo stars
- Author: H-mmer
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/H-mmer/pentest-agents/tree/HEAD/.claude/skills/hunt/SKILL.md
- Updated: 2026-06-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/h-mmer-hunt

## What it does

The skill manages multi-step offensive security testing against specified domains. Before sending aggressive probes, it verifies targets against `scope.yaml` and executes `tools/scope_check.py` to prevent testing out-of-scope assets. It also loads previous intelligence via `tools/brain.py` and inspects `policy.md` to pass mandatory operational constraints into every sub-agent dispatch.

During reconnaissance, the routine inspects response headers to identify technologies such as Rails, Django, or Next.js. When `--vuln-class` is omitted, `tools/intel_engine.py` scores hypotheses automatically. If a target responds with 403 or 429 status codes, the agent follows a seven-tier escalation process from `rules/waf-bypass-protocol.md` rather than halting.

Execution requires Python with `uv` installed, alongside repository helper scripts in `$CLAUDE_PROJECT_DIR/tools` and defined policy files. Missing scope definitions will stop the workflow at the initial gate.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add H-mmer/pentest-agents --skill hunt -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/hunt/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/hunt/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add H-mmer/pentest-agents --skill hunt -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/hunt/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add H-mmer/pentest-agents --skill hunt -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/hunt/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install H-mmer/pentest-agents .claude/skills/hunt
```

2. **Manually: put the files in place**
- File: `.github/skills/hunt/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add H-mmer/pentest-agents --skill hunt -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/H-mmer/pentest-agents --path .claude/skills/hunt
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/hunt/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/H-mmer/pentest-agents/tree/HEAD/.claude/skills/hunt/SKILL.md

## When to use it
- enforce program scope boundaries before active scanning
- detect backend web technologies via HTTP response headers
- prioritize vulnerability classes based on detected stack components
- iterate through structured bypass techniques when encountering a WAF

## Example prompts
- /hunt target.com
- /hunt target.com --vuln-class idor
- /hunt target.com --vuln-class sqli

## Similar
- [fix-security-vulnerabilities-with-strix](https://affpapa.org/en/nevibecode/skills/fix-security-vulnerabilities-with-strix.md) — skill · 20300 installs
- [idor-broken-object-authorization](https://affpapa.org/en/nevibecode/skills/idor-broken-object-authorization.md) — skill · 4200 installs
- [web-pentest](https://affpapa.org/en/nevibecode/skills/web-pentest.md) — skill · 722 installs
- [supabase-audit-authenticated](https://affpapa.org/en/nevibecode/skills/supabase-audit-authenticated.md) — skill · 463 installs
- [bizlogic-hunter](https://affpapa.org/en/nevibecode/agents/bizlogic-hunter.md) — subagent · ★ 2482 repo stars
- [hunt-host-header](https://affpapa.org/en/nevibecode/skills/hunt-host-header.md) — skill · ★ 16193 repo stars

## Other versions with the same name
- [hunt · tw93](https://affpapa.org/en/nevibecode/skills/hunt.md) — 15300 installs
- [hunt · orwa-mahmoud](https://affpapa.org/en/nevibecode/skills/orwa-mahmoud-hunt.md) — ★ 571 repo stars

From the same set: [h-mmer/pentest-agents](https://affpapa.org/en/nevibecode/by/h-mmer/pentest-agents.md) — 43 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
