# SKILL.md

> Instala las skills de agente oficiales de Proxyman (SKILL.md) para Codex, Claude Code, Cursor y Copilot, y así inspeccionar, reproducir y depurar el tráfico HTTP/HTTPS.

## Skills de agente de Proxyman {#proxyman-agent-skills}

Skills de agente oficiales para [Proxyman](https://proxyman.com), un proxy de depuración web para inspeccionar, reproducir y depurar el tráfico HTTP, HTTPS, WebSocket, de dispositivos y de aplicaciones.

El paquete cubre la instalación, cada pestaña de App Settings de macOS, el ciclo de vida y la recuperación de certificados, la conexión MCP y todas las operaciones MCP actuales, la consulta de documentación en vivo, los flujos de trabajo de las herramientas de depuración, las licencias, `proxyman-cli` y la captura HTTPS en dispositivos y entornos de ejecución. Proxyman MCP controla una app local en ejecución a través de su puente stdio incluido; no es una API en la nube.

Consulta el repositorio de GitHub para ver el alcance y las notas de mantenimiento de cada skill.

* Repositorio de GitHub: [https://github.com/ProxymanApp/proxyman-SKILL.md](https://github.com/ProxymanApp/proxyman-SKILL.md)

### Plugin {#plugin}

* ✅ Instala el plugin de Proxyman desde el [OpenAI Marketplace](https://chatgpt.com/plugins/plugins_6a88afab118c8191970bbc714223ff14).

### Instalación {#installation}

Instala todas las skills:

```bash
npx skills add ProxymanApp/proxyman-SKILL.md/skills
```

Instala una sola skill:

```bash
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
```

Para instalarlas manualmente, clona el repositorio y copia las carpetas que necesites de `skills/` al directorio de skills del agente:

```bash
git clone https://github.com/ProxymanApp/proxyman-SKILL.md.git
```

Después, reinicia o recarga el agente.

| Agente                     | Directorio de skills |
| -------------------------- | -------------------- |
| OpenAI Codex CLI           | `~/.codex/skills/`   |
| Claude Code/Desktop        | `~/.claude/skills/`  |
| Cursor                     | `~/.cursor/skills/`  |
| GitHub Copilot CLI/VS Code | `~/.copilot/skills/` |

### Skills {#skills}

| Skill                            | Para qué sirve                                                                                                                                                                                                                                                       |
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `proxyman-download-setup`        | Descargar, instalar, abrir y preparar Proxyman en macOS, Windows o Linux.                                                                                                                                                                                              |
| `proxyman-app-settings`          | Auditar, explicar y cambiar de forma segura cada pestaña actual de Settings de macOS, incluidas las limitaciones de compilación o de licencia y los límites exclusivos de la interfaz gráfica.                                                                          |
| `proxyman-certificates-recovery` | Instalar y confiar en certificados raíz generados o personalizados, gestionar identidades personalizadas de servidor y de cliente, capturar diagnósticos y usar de forma segura las acciones de recuperación del menú Help, incluido Factory Reset.                       |
| `proxyman-mcp-setup`             | Conectar un agente al puente MCP stdio incluido y solucionar problemas de handshake o de detección de herramientas.                                                                                                                                                  |
| `proxyman-traffic-debugging`     | Inspeccionar el tráfico y operar toda la superficie MCP actual: las 70 acciones revisadas, los recursos y los prompts.                                                                                                                                              |
| `proxyman-debugging-tools`       | Consultar la documentación oficial actual y explicar en detalle Breakpoint, Map Local/Remote, Scripting, Compose/Repeat, Protobuf, Network Conditions, Reverse Proxy y TLS Key Logging, con los límites exactos de cada interfaz.                                     |
| `proxyman-license-management`    | Activar o desvincular el dispositivo actual y gestionar de forma segura los dispositivos remotos, los puestos, las transferencias y la renovación.                                                                                                                    |
| `proxyman-cli`                   | Descubrir la sintaxis de la CLI instalada y automatizar el proxy, MCP, la configuración, los registros, los certificados y las reglas.                                                                                                                             |
| `proxyman-https-capture`         | Configurar y verificar la captura HTTPS en dispositivos, entornos de ejecución y contenedores, y elegir o integrar Atlantis en apps controladas.                                                                                                                     |

### Enrutamiento {#routing}

* Si Proxyman no está instalado: `proxyman-download-setup`.
* El usuario pregunta dónde está un App Setting, qué cambia, por qué está bloqueado o quiere auditar o cambiar Settings: `proxyman-app-settings`.
* El usuario necesita confiar en certificados raíz generados o personalizados, usar certificados de servidor o cliente personalizados, Debug Mode, Reset Network Proxy o Factory Reset: `proxyman-certificates-recovery`.
* Proxyman está instalado, pero faltan las herramientas MCP: `proxyman-mcp-setup`.
* El usuario quiere que el agente inspeccione o cambie Proxyman mediante MCP: `proxyman-traffic-debugging`.
* El usuario pregunta cómo funciona una herramienta de Proxyman o necesita la guía oficial más reciente: `proxyman-debugging-tools`.
* El usuario necesita activar o desvincular una licencia, revocar un dispositivo remoto o usar License Manager: `proxyman-license-management`.
* El usuario quiere un comando de shell o una operación con script: `proxyman-cli`.
* El usuario necesita que el tráfico de un dispositivo, emulador, app, entorno de ejecución o contenedor aparezca y se descifre: `proxyman-https-capture`.

Las skills pueden trabajar en conjunto. Por ejemplo, usa HTTPS Capture para configurar un emulador de Android y, después, Traffic Debugging para verificar su tráfico y crear una regla Map Local.

### Requisitos y seguridad {#requirements-and-safety}

* Proxyman debe estar instalado y en ejecución para que funcionen las herramientas operativas de [MCP](https://proxyman.com/docs/es/mcp).
* Activa **Enable MCP Server** en Settings > MCP, o usa el comando [`proxyman-cli mcp`](https://proxyman.com/docs/es/command-line) instalado después de consultar la ayuda de tu versión.
* Configura los agentes con el puente stdio incluido de Proxyman, no con una URL HTTP fija ni con el ejecutable principal de la app.
* Considera que `tools/list` en vivo, la detección de recursos y prompts y la ayuda de la CLI instalada son la fuente de referencia para los esquemas y la sintaxis.
* Considera que la interfaz de Settings instalada es la referencia para las preferencias; el servidor MCP revisado no es una API genérica de App Settings.
* Trata como información sensible las importaciones de certificados y claves privadas, los cambios de confianza, la salida de Debug Mode y Factory Reset. Antes de una recuperación destructiva, conserva fuera de las carpetas gestionadas por Proxyman los orígenes y las copias de seguridad necesarios.
* Mantén activada la opción **Redact Sensitive Data Before Sending to AI**, salvo que se requieran y aprueben explícitamente los datos sin procesar.
* La redacción de la vista previa de MCP no limpia las exportaciones originales de HAR ni de registros de Proxyman.
* Consulta `https://proxyman.com/docs/llms.txt` y sus páginas Markdown enlazadas cuando importe el comportamiento actual del producto.
* Las claves de licencia, los registros de claves de sesión TLS, los enlaces de acceso al portal, las credenciales del proxy, las contraseñas de certificados y los secretos capturados no deben almacenarse en skills, comandos, registros ni informes.

### Empaquetado del plugin {#plugin-packaging}

El paquete de skills es autocontenido y puede colocarse en el directorio `skills/` de un plugin de Codex. El plugin aún debe configurar o documentar por separado el puente MCP local de Proxyman; empaquetar estas skills no incluye la app de Proxyman, el ejecutable del puente, la licencia ni una conexión MCP activa.

El plugin de producción de Proxyman está disponible en [ChatGPT](https://chatgpt.com/plugins/plugins_6a88afab118c8191970bbc714223ff14).

El código fuente publicable del plugin está en `plugins/proxyman` del repositorio de GitHub. Es un paquete solo de skills, con un manifiesto listo para publicarse y el recurso de marca de Proxyman. Consulta `SUBMISSION.md` en el repositorio para ver la ficha del marketplace, los prompts de inicio, las pruebas para revisores, las notas de la versión y las comprobaciones pendientes de envío a OpenAI Platform.

## Más información {#learn-more}

* [Cómo usar Proxyman MCP con Codex y Claude Code](https://proxyman.com/posts/how-to-use-proxyman-mcp-with-codex-and-claude-code)