hunt-exceptional-conditions — скилл для Claude Code
Скилл hunt-exceptional-conditions для Claude Code находит утечки внутренних данных при обработке неожиданных входных данных. Проверяет API и веб-эндпоинты на раскрытие стек-трейсов, путей файлов и версий библиотек.
MIT ★ 16 193 обновлён 2026-10-29
/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsoulsЧто делает hunt-exceptional-conditions
Скилл помогает охотиться за раскрытием внутренней структуры приложения через ошибки. Когда код получает поломанный JSON, поле неправильного типа, огромную строку или null-байт, хорошее приложение вернёт чистую ошибку. Плохое — выкинет необработанное исключение и покажет разработчику стек-трейс прямо в ответе: там окажутся пути на серверре, запросы к ORM, версии фреймворков, внутренние классы.
Скилл проверяет любой эндпоинт, который принимает ввод: JSON API с типизированными полями, параметры query и path, формы, загрузку файлов. На каждый запрос ты отправляешь варианты с нарушением одного допущения: строку вместо числа, массив вместо объекта, усечённый JSON, очень длинное значение. Сигнал находки — в теле ответа видны сигнатуры утечек: SequelizeDatabaseError, Traceback (most recent call last), /var/www/.../file.php on line N, стек-фреймы Java или YSOD от .NET.
Утечка структуры обычно открывает путь глубже — к SQL-инъекциям, RCE или path-traversal. Скилл требует, чтобы ты захватил точный артефакт (путь, класс ORM, версию, строку стека), а не просто отметил статус 500.
Какие задачи решает
- выявить неправильную обработку типов и граничных значений в API
- обнаружить утечки путей на сервере и внутренних структур данных
- найти раскрытие версий библиотек и фреймворков через ошибки
- определить эндпоинты с неочищенными стек-трейсами в ответе
Примеры запросов агенту
- Пошли на /api/feedback неправильный тип в rating, чтобы увидеть стек-трейс ORM
- Попробуй отправить огромную строку в поле comment и посмотри, вернёт ли приложение стек-фрейм
- Проверь /item/{id} с null-байтом и перехвати ошибку, если она раскроет путь на серверре
Как установить hunt-exceptional-conditions
1Через маркетплейс плагинов
/plugin marketplace add elementalsouls/Claude-BugHunter/plugin install claude-bughunter@elementalsoulsКоманда ставит плагин claude-bughunter целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add elementalsouls/Claude-BugHunter --skill hunt-exceptional-conditions -a claude-code3Вручную: положить файлы
~/.claude/skills/hunt-exceptional-conditions/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hunt-exceptional-conditions/
1Через Skills CLI (Vercel)
npx skills add elementalsouls/Claude-BugHunter --skill hunt-exceptional-conditions -a codex2Вручную: положить файлы
.agents/skills/hunt-exceptional-conditions/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add elementalsouls/Claude-BugHunter --skill hunt-exceptional-conditions -a cursor2Вручную: положить файлы
.cursor/skills/hunt-exceptional-conditions/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install elementalsouls/Claude-BugHunter skills/hunt-exceptional-conditions2Вручную: положить файлы
.github/skills/hunt-exceptional-conditions/SKILL.md1Через Skills CLI (Vercel)
npx skills add elementalsouls/Claude-BugHunter --skill hunt-exceptional-conditions -a gemini-cli2Командой платформы
gemini skills install https://github.com/elementalsouls/Claude-BugHunter --path skills/hunt-exceptional-conditionsВручную: положить файлы
.devin/skills/hunt-exceptional-conditions/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о hunt-exceptional-conditions
Как установить hunt-exceptional-conditions в Claude Code?
Выполни /plugin marketplace add elementalsouls/Claude-BugHunter, затем /plugin install claude-bughunter@elementalsouls, потом npx skills add elementalsouls/Claude-BugHunter --skill hunt-exceptional-conditions -a claude-code. Скилл загрузится в ~/.claude/skills/hunt-exceptional-conditions/SKILL.md.
Что делает hunt-exceptional-conditions?
Скилл учит находить уязвимости через неправильную обработку ошибок: когда приложение получает поломанный ввод и выставляет стек-трейс, пути файлов или версии библиотек. Это утечка внутренней структуры, которая может привести к более серьёзным атакам.
Какие эндпоинты нужно проверять?
Любые, которые принимают ввод: JSON API с типизированными полями, параметры query и path, поиск, фильтры, сортировку, загрузку файлов. Начни с известного рабочего запроса и варьируй по одному параметру за раз — отправляй неправильный тип, усечённый JSON, очень длинные строки, граничные значения.
Исходный текст
SKILL.md · MIT
---
name: hunt-exceptional-conditions
description: "Hunt mishandling of exceptional conditions — feed an endpoint malformed/unexpected input (wrong type, broken JSON, oversized field, null byte) and make it fail OPEN or leak internals: a verbose stack-trace / framework error page that discloses ORM internals, server file paths, library versions, or a language traceback. Use on any input-accepting endpoint (JSON APIs, forms, query params). Medium-High when the leak exposes internal structure that arms a deeper attack."
report_count: 0
sources: hackerone_public
---
# HUNT-EXCEPTIONAL-CONDITIONS — Verbose Errors / Fail-Open (A10:2025)
## What actually pays
Well-built apps catch errors and return a clean, generic message. A broken app,
when handed input it didn't expect, throws an unhandled exception and renders a
**developer error page** straight to the client — leaking the stack trace, the
ORM/query internals, server-side file paths, and framework/library versions.
That disclosure is the finding (and it arms SQLi/RCE/path attacks next).
## Recon
Any endpoint that parses input is a candidate; the richest are:
```
JSON APIs that expect typed fields: POST /api/* with {numbers, ids, enums}
Endpoints with numeric/id path or query params: /item/{id}, ?page=, ?quantity=
Search / filter / sort params
File or content-type sensitive uploads
```
## Attack — send what the code didn't anticipate
Take a known-good request and break ONE assumption at a time:
- **Wrong type:** a field the app expects to be a number/string is sent as an
array or object — `{"rating":"x","comment":[1,2,3]}`, `{"quantity":{}}`.
- **Malformed body:** truncated/!invalid JSON, an unterminated string, a stray
brace, a wrong/missing Content-Type.
- **Boundary/oversized:** a very long string, a huge/negative/overflow number.
- **Null byte / control chars** embedded in a value.
```
POST /api/Feedbacks {"rating":"notanumber","comment":[1,2,3]}
GET /item/' OR /item/%00 (also exercises the error path)
```
Watch the RESPONSE BODY, not just the status: a 500 (or even a 200/400) whose
body contains a stack trace or framework error page is the signal.
## What counts as a leak (the success signal)
A finding is confirmed when the response body contains a cross-framework error-disclosure signature:
- **Node/Express + Sequelize:** `SequelizeDatabaseError`, `node_modules/sequelize`,
a JS stack with internal paths.
- **PHP:** `<b>Warning</b> ... /var/www/.../file.php on line N`.
- **Python:** `Traceback (most recent call last)`, `werkzeug.exceptions`.
- **Java:** `at com.app.Foo(Foo.java:42)` stack frames.
- **.NET:** `Server Error in '/' Application`, a `[System.XxxException: ...]` YSOD.
A clean JSON error (`{"error":"Invalid input"}`) with no internals is NOT a
finding — that's correct handling. Disclosure of internal structure is.
## Validation discipline
- Capture the exact leaked artifact (path, ORM class, version, stack frame) —
that's the evidence. "It returned 500" alone is not disclosure.
- Note what the leak enables next (e.g. a disclosed SQL error → hunt-sqli; a
disclosed absolute path → hunt-lfi).
© Sachin Sharma · MIT · elementalsouls/Claude-BugHunter