SKILL.md
Codex, Claude Code, Cursor, Copilot에서 사용할 공식 Proxyman 에이전트 스킬(SKILL.md)을 설치하고, HTTP/HTTPS 트래픽을 검사, 재생, 디버깅하세요.
Proxyman 에이전트 스킬
Proxyman을 위한 공식 에이전트 스킬입니다. Proxyman은 HTTP, HTTPS, WebSocket, 기기, 애플리케이션 트래픽을 검사, 재생, 디버깅하는 웹 디버깅 프록시입니다.
이 번들은 설치, macOS 앱 설정의 모든 탭, 인증서 수명 주기 및 복구, MCP 연결과 현재 제공되는 모든 MCP 작업, 실시간 문서 검색, 디버깅 도구 워크플로, 라이선스, proxyman-cli, 기기 및 런타임 전반의 HTTPS 캡처를 다룹니다. Proxyman MCP는 번들로 제공되는 stdio 브리지를 통해 실행 중인 로컬 앱을 제어합니다. 클라우드 API가 아닙니다.
각 스킬의 범위와 유지 관리 정보는 GitHub 저장소를 참고하세요.
- GitHub 저장소: https://github.com/ProxymanApp/proxyman-SKILL.md
플러그인
- ✅ OpenAI Marketplace에서 Proxyman 플러그인을 설치하세요.
설치
모든 스킬을 설치합니다:
npx skills add ProxymanApp/proxyman-SKILL.md/skills
스킬 하나만 설치합니다:
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-download-setup
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-app-settings
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-certificates-recovery
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-mcp-setup
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-traffic-debugging
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-debugging-tools
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-license-management
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-cli
npx skills add ProxymanApp/proxyman-SKILL.md --skill proxyman-https-capture
수동으로 설치하려면 저장소를 클론한 뒤 skills/ 아래의 필요한 폴더를 에이전트의 스킬 디렉터리에 복사하세요:
git clone https://github.com/ProxymanApp/proxyman-SKILL.md.git
그다음 에이전트를 다시 시작하거나 새로 고치세요.
| 에이전트 | 스킬 디렉터리 |
|---|---|
| OpenAI Codex CLI | ~/.codex/skills/ |
| Claude Code/Desktop | ~/.claude/skills/ |
| Cursor | ~/.cursor/skills/ |
| GitHub Copilot CLI/VS Code | ~/.copilot/skills/ |
스킬
| 스킬 | 용도 |
|---|---|
proxyman-download-setup | macOS, Windows, Linux에서 Proxyman을 다운로드, 설치, 실행하고 준비합니다. |
proxyman-app-settings | 빌드 및 라이선스 제한과 GUI 전용 범위를 포함해 현재 macOS 설정 탭 전체를 점검하고, 설명하고, 안전하게 변경합니다. |
proxyman-certificates-recovery | 생성된 루트 또는 사용자 지정 루트를 설치하고 신뢰하도록 설정하며, 사용자 지정 서버/클라이언트 ID를 관리하고, 진단 정보를 캡처하며, Factory Reset을 포함한 Help 메뉴의 복구 작업을 안전하게 사용합니다. |
proxyman-mcp-setup | 에이전트를 번들 stdio MCP 브리지에 연결하고, 핸드셰이크 및 도구 탐색 문제를 해결합니다. |
proxyman-traffic-debugging | 트래픽을 검사하고, 검토를 마친 70개 작업, 리소스, 프롬프트를 포함해 현재 MCP 기능 전체를 사용합니다. |
proxyman-debugging-tools | 최신 공식 문서를 가져오고, 정확한 인터페이스 범위와 함께 Breakpoint, Map Local/Remote, Scripting, Compose/Repeat, Protobuf, Network Conditions, Reverse Proxy, TLS Key Logging을 자세히 안내합니다. |
proxyman-license-management | 현재 기기를 활성화하거나 연결을 해제하고, 원격 기기, 시트, 이전, 갱신을 안전하게 관리합니다. |
proxyman-cli | 설치된 CLI 문법을 찾아보고, 프록시, MCP, 설정, 로그, 인증서, 규칙을 자동화합니다. |
proxyman-https-capture | 기기, 런타임, 컨테이너에 대한 HTTPS 캡처를 설정하고 검증하며, 통제된 앱에는 Atlantis를 선택하거나 통합합니다. |
라우팅
- Proxyman이 설치되어 있지 않다면:
proxyman-download-setup. - 사용자가 앱 설정의 위치, 변경 내용, 잠금 이유를 묻거나 설정 점검 또는 변경을 원하는 경우:
proxyman-app-settings. - 사용자에게 생성된 루트 또는 사용자 지정 루트 신뢰, 사용자 지정 서버/클라이언트 인증서, Debug Mode, Reset Network Proxy, Factory Reset이 필요한 경우:
proxyman-certificates-recovery. - Proxyman은 설치되어 있지만 MCP 도구가 보이지 않는 경우:
proxyman-mcp-setup. - 사용자가 에이전트가 MCP를 통해 Proxyman을 검사하거나 변경하기를 원하는 경우:
proxyman-traffic-debugging. - 사용자가 Proxyman 도구의 동작 방식을 묻거나 최신 공식 가이드가 필요한 경우:
proxyman-debugging-tools. - 사용자에게 라이선스 활성화, 연결 해제, 원격 해지, License Manager가 필요한 경우:
proxyman-license-management. - 사용자가 셸 명령이나 스크립트 작업을 원하는 경우:
proxyman-cli. - 기기, 에뮬레이터, 앱, 런타임, 컨테이너의 트래픽이 나타나고 복호화되어야 하는 경우:
proxyman-https-capture.
스킬은 함께 사용할 수 있습니다. 예를 들어 HTTPS Capture로 Android 에뮬레이터를 설정한 다음, Traffic Debugging으로 트래픽 흐름을 확인하고 Map Local 규칙을 만들 수 있습니다.
요구 사항 및 안전 수칙
- 운영용 MCP 도구를 사용하려면 Proxyman이 설치되어 있고 실행 중이어야 합니다.
- Settings > MCP에서 Enable MCP Server를 켜거나, 사용 중인 버전의 도움말을 읽은 뒤 설치된
proxyman-cli mcp명령을 사용하세요. - 에이전트는 고정 HTTP URL이나 메인 앱 실행 파일이 아니라 Proxyman에 번들된 stdio 브리지로 설정하세요.
- 스키마와 문법은 실시간
tools/list, 리소스/프롬프트 탐색 결과, 설치된 CLI 도움말을 기준으로 삼으세요. - 환경설정은 설치된 설정 UI를 기준으로 삼으세요. 검토된 MCP 서버는 범용 앱 설정 API가 아닙니다.
- 인증서/개인 키 가져오기, 신뢰 설정 변경, Debug Mode 출력, Factory Reset은 민감한 작업으로 취급하세요. 파괴적인 복구를 하기 전에 필요한 원본과 백업은 Proxyman이 관리하는 폴더 바깥에 보관하세요.
- 원본 데이터가 명시적으로 필요하고 승인된 경우가 아니라면 Redact Sensitive Data Before Sending to AI를 켜 두세요.
- MCP 미리보기에서의 가림 처리는 원본 HAR/Proxyman 로그 내보내기 파일을 정리하지 않습니다.
- 최신 제품 동작이 중요할 때는
https://proxyman.com/docs/llms.txt와 여기에 연결된 Markdown 페이지를 가져오세요. - 라이선스 키, TLS 세션 키 로그, 포털 접근 링크, 프록시 자격 증명, 인증서 비밀번호, 캡처된 비밀 정보는 스킬, 명령, 로그, 보고서에 저장하면 안 됩니다.
플러그인 패키징
스킬 번들은 독립적으로 동작하며 Codex 플러그인의 skills/ 디렉터리 아래에 둘 수 있습니다. 다만 플러그인은 로컬 Proxyman MCP 브리지를 별도로 설정하거나 문서화해야 합니다. 이 스킬들을 패키징한다고 해서 Proxyman 앱, 브리지 실행 파일, 라이선스, 실행 중인 MCP 연결이 포함되는 것은 아닙니다.
정식 Proxyman 플러그인은 ChatGPT에서 이용할 수 있습니다.
배포 가능한 플러그인 소스는 GitHub 저장소의 plugins/proxyman에 있습니다. 공개 가능한 매니페스트와 Proxyman 브랜드 에셋을 포함한, 스킬만 담긴 패키지입니다. 마켓플레이스 등록 정보, 시작용 프롬프트, 심사자 테스트, 릴리스 노트, 남아 있는 OpenAI Platform 제출 점검 항목은 저장소의 SUBMISSION.md를 참고하세요.