# proxyman-debugging-tools

proxyman-debugging-tools pulls the current Proxyman docs page and turns it into a debugging plan: GUI steps, MCP or CLI routes, a way to verify, a way to undo.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 301 installs · ★ 24 repo stars
- Author: ProxymanApp
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ProxymanApp/proxyman-SKILL.md/tree/HEAD/skills/proxyman-debugging-tools/SKILL.md
- Updated: 2026-08-21
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/proxyman-debugging-tools

## What it does

The skill reads the Proxyman docs instead of reciting them from memory. It pulls `https://docs.proxyman.com/llms.txt`, picks the page that matches the feature or symptom, and fetches that `.md` file. The answer follows a fixed shape: goal, prerequisites, GUI steps, MCP and CLI steps where they exist, how to confirm it worked, how to undo it. Empty sections get dropped.

Bundled references map the product's debugging surface: request and response rewriting (Breakpoint, Map Local and Remote, Scripting), replay and routing (Compose, Repeat, Network Conditions, Reverse Proxy), protocol decoding (Protobuf, TLS Key Logging). Tool names for MCP come from `tools/list`, since the public docs are not the authority on exact inputs.

Offline the skill falls back to that snapshot and says the page could not be verified. Capture setup, certificates, licensing and shell automation live in other skills in the same repo, so reach for those when the job is to drive MCP end to end rather than to explain a feature.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-debugging-tools -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-debugging-tools -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-debugging-tools -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ProxymanApp/proxyman-SKILL.md skills/proxyman-debugging-tools
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-debugging-tools -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ProxymanApp/proxyman-SKILL.md --path skills/proxyman-debugging-tools
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-debugging-tools -a opencode
```

### 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/ProxymanApp/proxyman-SKILL.md/tree/HEAD/skills/proxyman-debugging-tools/SKILL.md

## When to use it
- Tell Breakpoint apart from Map Local and pick the right one
- Plan a GUI debugging session with a way to confirm the fix
- Check which Proxyman features the MCP server actually exposes
- Find the docs page for a symptom without guessing the URL
- Write the rollback steps for a proxy or certificate change

## Example prompts
- Explain how to catch a request with Breakpoint in Proxyman and verify the rule fired.
- I want to swap a server response for a local file — walk me through the GUI steps.
- Plan a WebSocket debugging session: prerequisites, verification, rollback.

## Similar
- [masterhttprelayvpn-proxy](https://affpapa.org/en/nevibecode/skills/masterhttprelayvpn-proxy.md) — skill · 372 installs
- [network-troubleshooting](https://affpapa.org/en/nevibecode/skills/network-troubleshooting.md) — skill · 131 installs
- [impersonate-mcp](https://affpapa.org/en/nevibecode/mcp/impersonate-mcp.md) — MCP server · ★ 48 repo stars
- [systematic-debugging](https://affpapa.org/en/nevibecode/skills/systematic-debugging.md) — skill · 306118 installs
- [golang-grpc](https://affpapa.org/en/nevibecode/skills/golang-grpc.md) — skill · 41400 installs
- [debugging](https://affpapa.org/en/nevibecode/skills/sentimony-debugging.md) — skill · 2800 installs

From the same set: [proxymanapp/proxyman-skill.md](https://affpapa.org/en/nevibecode/by/proxymanapp/proxyman-skill.md.md) — 9 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
