guide-proxy

Guide proxy agent creation, configuration, and troubleshooting with routing strategies.

4|Updated May 9, 2026
One-click install
npx skills add https://github.com/liaoxinjie666/protocol-proxy --skill guide-proxy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guide-proxy
Source: https://github.com/liaoxinjie666/protocol-proxy/tree/main/skills/system/guide-proxy
Command: npx skills add https://github.com/liaoxinjie666/protocol-proxy --skill guide-proxy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you correctly create, configure, start, and troubleshoot proxy agents so your requests route to the right provider and protocol conversion works as expected.

Core Features & Use Cases

  • 代理创建与配置指导: Covers proxy basics like name, listening port, and authentication requirements (Bearer Token).
  • 路由策略与多供应商调度: Explains strategies such as primary fallback, round robin, weighted random, and fastest priority, including providerPool usage.
  • 协议自动转换与请求用法: Shows how OpenAI/Anthropic/Gemini request formats are converted and provides example curl usage for testing locally or with tokens.
  • 启动停止与状态诊断: Describes how to start/stop single or batch agents and what “异常/启动失败” typically means, including practical checks like port conflicts.

Quick Start

Ask the AI: “How do I create a proxy agent on port 8080 with Bearer Token auth, choose a routing strategy, and confirm protocol conversion works with a curl request to /v1/chat/completions?”

Frequently Asked Questions about guide-proxy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure a proxy agent with bearer token auth and a specific listening port?

To configure a proxy agent with bearer token auth, set the listening port and authentication requirements during proxy creation, mapping the configuration fields to operational behavior for secure request routing.

What routing strategy should I choose for my provider pool?

Choosing a routing strategy for your provider pool depends on traffic needs: primary fallback ensures reliability, round robin distributes load evenly, weighted random balances capacity, and fastest priority optimizes response latency.

How does protocol conversion work for OpenAI, Anthropic, and Gemini API requests?

Protocol conversion for OpenAI, Anthropic, and Gemini API requests works by automatically translating request formats across providers, allowing you to validate cross-protocol routing using example curl requests to endpoints like /v1/chat/completions.

Why does my proxy agent fail to start and show an abnormal status?

A proxy agent fails to start and shows abnormal status typically due to port conflicts or incorrect configuration fields, requiring step-by-step status diagnosis and practical checks to resolve the startup failure.

Can I manage multiple proxy agents and batch start them simultaneously?

You can manage multiple proxy agents and batch start them simultaneously using the agent management interface, which supports starting, stopping, and diagnosing status for single or batch agent operations.