Saltar al contenido principal

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​

Skills de agente oficiales para Proxyman, 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.

Plugin​

Instalación​

Instala todas las skills:

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

Instala una sola skill:

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:

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

Después, reinicia o recarga el agente.

AgenteDirectorio de skills
OpenAI Codex CLI~/.codex/skills/
Claude Code/Desktop~/.claude/skills/
Cursor~/.cursor/skills/
GitHub Copilot CLI/VS Code~/.copilot/skills/

Skills​

SkillPara qué sirve
proxyman-download-setupDescargar, instalar, abrir y preparar Proxyman en macOS, Windows o Linux.
proxyman-app-settingsAuditar, 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-recoveryInstalar 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-setupConectar un agente al puente MCP stdio incluido y solucionar problemas de handshake o de detección de herramientas.
proxyman-traffic-debuggingInspeccionar el tráfico y operar toda la superficie MCP actual: las 70 acciones revisadas, los recursos y los prompts.
proxyman-debugging-toolsConsultar 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-managementActivar o desvincular el dispositivo actual y gestionar de forma segura los dispositivos remotos, los puestos, las transferencias y la renovación.
proxyman-cliDescubrir la sintaxis de la CLI instalada y automatizar el proxy, MCP, la configuración, los registros, los certificados y las reglas.
proxyman-https-captureConfigurar y verificar la captura HTTPS en dispositivos, entornos de ejecución y contenedores, y elegir o integrar Atlantis en apps controladas.

Enrutamiento​

  • 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​

  • Proxyman debe estar instalado y en ejecución para que funcionen las herramientas operativas de MCP.
  • Activa Enable MCP Server en Settings > MCP, o usa el comando proxyman-cli mcp 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​

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.

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​