path-traversal-hunter

Test file operations for path traversal using controlled canary files and encoded payloads.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Maybe4a6f7365/agentic-bug-bounty-framework --skill path-traversal-hunter-maybe4a6f7365
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: path-traversal-hunter
Source: https://github.com/Maybe4a6f7365/agentic-bug-bounty-framework/tree/main/skills/path-traversal-hunter
Command: npx skills add https://github.com/Maybe4a6f7365/agentic-bug-bounty-framework --skill path-traversal-hunter-maybe4a6f7365

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve? Security researchers need a disciplined, safe method to confirm path traversal vulnerabilities (CWE-22) without touching real secrets or system files, and to avoid filing reports that programs reject as expected behavior or out of scope. ## Core Features & Use Cases - Path Pipeline Mapping: Records the full chain from attacker-controlled input through decoding, joining, and canonicalization to the filesystem call for reads, writes, deletes, uploads, and archive extraction. - Concrete Test Recipes: Provides payload patterns for encoded traversal, nonstandard separators, storage-key injection, deep-link filenames, and post-validation mutation, all executed against disposable canary files. - Negative-Control Stop Conditions: Applies a 12-category taxonomy with real HackerOne report IDs to filter out non-reportable findings before submission. - Use Case: While testing a bug bounty target's /assets/<path> route, use this Skill to probe with ../outside.txt canaries, verify containment bypass, and check the version-boundary table to rule out already-patched libraries. ## Quick Start Ask the agent to hunt for path traversal in the target's file download and upload endpoints using canary files in a disposable test directory.

Frequently Asked Questions about path-traversal-hunter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test for path traversal vulnerabilities safely?

Test path traversal by creating canary files inside and outside a disposable test root, then sending encoded payloads like ../outside.txt or ..%2foutside.txt. Success means reading the outside canary, never real files like /etc/passwd or application secrets.

What payloads work for directory traversal testing?

Start with plain ../ sequences, then single-layer encodings such as ..%2f, %2e%2e/, and Windows ..\ separators. Also test absolute paths, nonstandard delimiters mapped by adapters, and storage-key injection in upload JSON bodies.

When is a path traversal finding not reportable to bug bounty programs?

A finding is not reportable when it is expected product behavior, requires victim-controlled environment variables, lacks an outside-root oracle, crosses no security boundary, or affects only out-of-scope assets. The Skill maps each case to a negative-control taxonomy with real HackerOne report examples.

Does this check if libraries already patched path traversal bugs?

Yes, a version-boundary table lists OSV/GHSA entries for packages like tar, adm-zip, decompress, send, and werkzeug with introduced and fixed versions. If the target runs at or above the fixed version, the known escape is already blocked.

Why does my traversal payload return a stack trace but no file content?

A stack trace mentioning the path is not a positive signal. Confirm exploitation only when the response bytes equal the outside canary file content, and verify the result reproduces after restart with a nonexistent-path control.