pentest-proxy
Skill19 starsChanged 23 days agoApache-2.0View on GitHub
Pentest temporary-use workflow using yorishiro-proxy as an MITM proxy via CLI
- Deletes or force-pushes
In this repository13 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- autopilotSkill
- buildSkill
- code-reviewSkill
- implement-pluginSkill
- implementSkill
- license-checkSkill
- orchestrateSkill
- projectSkill
- prSkill
- review-gateSkill
- security-reviewSkill
- testSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 6 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈6
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Use yorishiro-proxy as an MITM proxy during penetration testing via CLI.
- Very specific: line 9
All commands use the yorishiro-proxy client subcommand over Bash.
- Very specific: line 26
Run yorishiro-proxy client --help for the full grammar and yorishiro-proxy docs <tool> for each tool's parameters (no server needed).
- Distinctive: line 30
Check if a server is already running:
- Distinctive: line 36
If no active server is found, start one:
- Distinctive: line 42
Verify it is ready:
- Distinctive: line 150
Stop the proxy listener and delete flow data:
- Distinctive: line 191
If User B's response contains User A's data, an IDOR vulnerability exists.
- Very specific: line 205
Before sending destructive-shaped payloads such as DROP TABLE to a real target, turn on the SafetyFilter Input destructive-sql preset.
- Very specific: line 209
Check that it is active with yorishiro-proxy client security action=get_safety_filter params:='{}'.
- Distinctive: line 237
If the unauthenticated response still returns protected data, an auth bypass exists.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/pentest-proxy
Use yorishiro-proxy as an MITM proxy during penetration testing via CLI.
All commands use the yorishiro-proxy client subcommand over Bash.
Prerequisites
yorishiro-proxybinary is available on PATH- Target application is accessible from the proxy host
CLI Parameter Syntax
Parameters are key=value words; the CLI converts each value using the tool's input schema:
- Scalars are typed automatically (
limit=20is sent as an integer). - Arrays of scalars are comma-separated:
tls_passthrough.add='a.example.com,b.example.com'. - Dotted keys nest:
filter.outliers_only=true,params.flow_id=ID. Only the action-style tools (manage,security,intercept,macro,grpc_schema) take aparamsobject; typed tools such asresend_httpandfuzz_httptake their fields at the top level. - Objects and arrays of objects take JSON, quoted for the shell:
positions='[{"path":"raw_query","payloads":["a","b"]}]'. A'inside the single-quoted JSON is written'\''. key:=<json>sends any JSON value as-is (e.g.key:=null).
Run yorishiro-proxy client --help for the full grammar and yorishiro-proxy docs <tool> for each tool's parameters (no server needed).
1. Server Startup
Check if a server is already running:
yorishiro-proxy client list-serversIf no active server is found, start one:
yorishiro-proxy server -mcp-http-addr 127.0.0.1:9090 &Verify it is ready:
yorishiro-proxy client query resource=status2. Start Proxy Listener
yorishiro-proxy client proxy_start listen_addr=127.0.0.1:8080Configure the target application or browser to use 127.0.0.1:8080 as its HTTP proxy.
3. Install CA Certificate
Export the CA certificate for HTTPS interception:
yorishiro-proxy client query resource=ca_certInstall the output PEM into the target's trust store.
4. Configure TLS Passthrough (Optional)
Bypass TLS interception for specific upstream hosts (these hosts will NOT be intercepted):
yorishiro-proxy client configure tls_passthrough.add='*.cdn.example.com,static.example.com'5. Capture Traffic
Send requests through the proxy (e.g., curl, browser, or the target app) and list captured flows:
yorishiro-proxy client query resource=flows limit=206. Inspect a Flow
yorishiro-proxy client query flow FLOW_ID
yorishiro-proxy client query messages FLOW_IDNote:
querysupports positional args: first arg isresource, second isid.
7. Resend a Request
Replay a recorded HTTP request as-is (the result carries the new flow's stream_id):
yorishiro-proxy client resend_http flow_id=FLOW_IDReplay with a modification. Any field you pass overrides the recorded one; body_patches edits the recorded body in place:
yorishiro-proxy client resend_http flow_id=FLOW_ID tag=patched \
body_patches='[{"regex":"user_id=1","replace":"user_id=2"}]'headers replaces the recorded header list wholesale (it is not merged), so when you change a credential, list every header you want sent. Copy them from query messages FLOW_ID.
There is no compare action. To compare two responses, inspect both flows and diff the status code and body:
yorishiro-proxy client query flow FLOW_ID
yorishiro-proxy client query flow NEW_STREAM_IDFull parameter reference: yorishiro-proxy docs resend_http. Other protocols use resend_ws, resend_grpc and resend_raw (see yorishiro-proxy docs <tool>).
8. Fuzz a Parameter
fuzz_http is synchronous: it sends every variant, then returns a fuzz_id and per-variant results. Each entry of positions names a field of the recorded request (method, scheme, authority, path, raw_query, body, headers[N].name, headers[N].value) and the payloads to substitute there. A raw_query payload replaces the whole query string:
yorishiro-proxy client fuzz_http flow_id=FLOW_ID \
positions='[{"path":"raw_query","payloads":["q=test1","q=test2","q=test3"]}]'Full parameter reference (positions, stop_on_5xx, macro hooks): yorishiro-proxy docs fuzz_http.
Retrieve the results later, or only the outliers (status code, body length or timing that deviates from the baseline):
yorishiro-proxy client query resource=fuzz_jobs
yorishiro-proxy client query resource=fuzz_results fuzz_id=FUZZ_ID
yorishiro-proxy client query resource=fuzz_results fuzz_id=FUZZ_ID filter.outliers_only=trueDrill into a variant with yorishiro-proxy client query flow STREAM_ID, using the variant's stream_id.
9. Export Results
Export flows as HAR for reporting:
yorishiro-proxy client manage action=export_flows params.format=har params.output_path=flows.haroutput_path is confined to the server's export directory (server flag -export-dir / YP_EXPORT_DIR, default ~/.yorishiro-proxy/exports/): the relative name above lands there, and the response's output_path is the absolute file path. Absolute paths outside that directory are rejected.
10. Cleanup
Stop the proxy listener and delete flow data:
yorishiro-proxy client proxy_stop
yorishiro-proxy client manage action=delete_flows params.flow_id=FLOW_IDTo delete all flows:
yorishiro-proxy client manage action=delete_flows params.confirm=trueTypical Scenarios
IDOR Detection
- Authenticate as User A, browse the target to capture flows:
yorishiro-proxy client query resource=flows limit=50 - Identify a flow containing a user-specific resource ID (e.g.,
/api/users/123/profile) and note its request headers:yorishiro-proxy client query messages FLOW_ID - Resend the request (still as User A) to confirm the baseline:
yorishiro-proxy client resend_http flow_id=FLOW_ID tag=idor-user-a - Resend the same request with User B's credentials.
headersreplaces the recorded list, so copy every header from step 2 and change only the credential:yorishiro-proxy client resend_http flow_id=FLOW_ID tag=idor-user-b \ headers='[{"name":"Host","value":"target.example.com"},{"name":"Cookie","value":"session=USER_B_SESSION"},{"name":"Accept","value":"application/json"}]' - Compare the two responses (each resend returns its
stream_id):yorishiro-proxy client query flow USER_A_STREAM_ID yorishiro-proxy client query flow USER_B_STREAM_ID - If User B's response contains User A's data, an IDOR vulnerability exists.
SQL Injection Testing
- Capture a flow containing a parameter of interest:
yorishiro-proxy client query resource=flows limit=20 yorishiro-proxy client query messages FLOW_ID - Fuzz the parameter. Payloads are sent verbatim, so URL-encode them for the query string; a
'inside the single-quoted shell argument is written'\'':
Before sending destructive-shaped payloads such asyorishiro-proxy client fuzz_http flow_id=FLOW_ID \ positions='[{"path":"raw_query","payloads":["id=1'\''","id=1%20OR%201=1","id=1;%20DROP%20TABLE--"]}]'DROP TABLEto a real target, turn on the SafetyFilter Inputdestructive-sqlpreset. It blocks matching variants before they reach upstream. The filter can only be configured when the server boots, from the JSON file passed withyorishiro-proxy server -config FILE:
Check that it is active with{"safety_filter": {"enabled": true, "input": {"rules": [{"preset": "destructive-sql"}]}}}yorishiro-proxy client security action=get_safety_filter params:='{}'. The filter is a backstop. It only catches the patterns its preset knows, so prefer non-destructive probes (boolean or time-based) against systems you must not damage. - Surface the variants that deviate from the baseline, then inspect one:
yorishiro-proxy client query resource=fuzz_results fuzz_id=FUZZ_ID filter.outliers_only=true yorishiro-proxy client query flow STREAM_ID - Inspect any anomalous responses (e.g., status code changes, error messages, timing differences) to confirm injection points.
Authentication Bypass Testing
- Capture an authenticated request flow:
yorishiro-proxy client query resource=flows limit=20 - Inspect the flow to identify auth headers/cookies:
yorishiro-proxy client query messages FLOW_ID - Resend it with every header except the credentials (
headersreplaces the recorded list, so the omittedAuthorization/Cookieare not sent):yorishiro-proxy client resend_http flow_id=FLOW_ID tag=no-auth \ headers='[{"name":"Host","value":"target.example.com"},{"name":"Accept","value":"application/json"}]' - Compare the authenticated and unauthenticated responses:
yorishiro-proxy client query flow FLOW_ID yorishiro-proxy client query flow NO_AUTH_STREAM_ID - If the unauthenticated response still returns protected data, an auth bypass exists.
Quick Reference
| Task | Command |
| Docs (offline) | yorishiro-proxy docs / yorishiro-proxy docs <topic> — no server needed |
| Tool parameters | yorishiro-proxy docs <tool> (e.g. yorishiro-proxy docs fuzz_http) |
| List flows | yorishiro-proxy client query resource=flows limit=20 |
| Flow detail | yorishiro-proxy client query flow ID |
| Flow messages | yorishiro-proxy client query messages ID |
| Proxy status | yorishiro-proxy client query resource=status |
| Resend | yorishiro-proxy client resend_http flow_id=ID |
| Compare | yorishiro-proxy client query flow A and yorishiro-proxy client query flow B, then diff |
| Fuzz | yorishiro-proxy client fuzz_http flow_id=ID positions='[{"path":"raw_query","payloads":["a=1","a=2"]}]' |
| Fuzz results | yorishiro-proxy client query resource=fuzz_results fuzz_id=ID |
| Fuzz outliers | yorishiro-proxy client query resource=fuzz_results fuzz_id=ID filter.outliers_only=true |
| Export HAR | yorishiro-proxy client manage action=export_flows params.format=har params.output_path=FILE |
| CA cert | yorishiro-proxy client query resource=ca_cert |
| Delete flow | yorishiro-proxy client manage action=delete_flows params.flow_id=ID |
| Delete all | yorishiro-proxy client manage action=delete_flows params.confirm=true |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

