# proxyman-certificates-recovery

The proxyman-certificates-recovery skill guides Proxyman certificate work and recovery actions on macOS. Use it for trust changes, diagnostics, proxy reset, or data reset.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 244 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-certificates-recovery/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-certificates-recovery

## What it does

The skill separates Proxyman’s generated root CA, custom root certificates, server certificates, and client identities used for mTLS. It helps an agent identify the certificate role, inspect the current state, choose the supported interface, and verify the result through GUI, MCP, or `proxyman-cli`.

It covers Debug Mode, Copy Debug Info, Reset Network Proxy, and Factory Reset. The interface limits matter: MCP handles the managed root certificate, the CLI supports P12-based certificate operations, while Debug Mode and Factory Reset belong to the GUI. The workflow also treats private keys, passphrases, logs, and backups as sensitive material.

Changing custom certificate state closes live connections, so important captures should be finished first and original files preserved. The procedure is for macOS and should not be applied to Windows, Linux, mobile devices, or containers.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/proxyman-certificates-recovery/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-certificates-recovery
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-certificates-recovery -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-certificates-recovery/SKILL.md

## When to use it
- identify the correct Proxyman certificate role
- configure trust for a generated or custom root CA
- load a P12 server or client certificate
- turn on Debug Mode and prepare diagnostic details
- plan a proxy reset or Factory Reset with confirmation

## Example prompts
- Identify the right Proxyman certificate role for this TLS setup and give me a safe sequence of actions.
- Review the impact of importing a custom root certificate, list what I should preserve, and stop before any confirmation step.
- Prepare Proxyman diagnostics with Copy Debug Info and tell me what console output is safe to share.

## Similar
- [azure-keyvault-certificates-rust](https://affpapa.org/en/nevibecode/skills/azure-keyvault-certificates-rust.md) — skill · 5 installs
- [wendy-certificates](https://affpapa.org/en/nevibecode/skills/wendy-certificates.md) — skill · ★ 64 repo stars
- [discover-cryptography](https://affpapa.org/en/nevibecode/skills/discover-cryptography.md) — skill · 118 installs
- [mtls-configuration](https://affpapa.org/en/nevibecode/skills/mtls-configuration.md) — skill · 10300 installs
- [dotnet-devcert-trust](https://affpapa.org/en/nevibecode/skills/dotnet-devcert-trust.md) — skill · 468 installs
- [infisical-pki](https://affpapa.org/en/nevibecode/skills/infisical-pki.md) — skill · 235 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
