Agent skill

Higress Auto Router

by higress-group in higress-group/higress

Configure automatic model routing using the get-ai-gateway.sh CLI tool for Higress AI Gateway.

Apache-2.0Auto-check passedAI & LLM Engineering

Install Higress Auto Router

skills CLI

$ npx skills add higress-group/higress --skill higress-auto-router -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install higress-group/higress higress-auto-router --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/higress-group/higress.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/higress-auto-router .claude/skills/higress-auto-router && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "higress-auto-router" agent skill from https://github.com/higress-group/higress/tree/main/.agents/skills/higress-auto-router into .claude/skills/higress-auto-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "higress-auto-router", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/higress-group/higress/tree/main/.agents/skills/higress-auto-router

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add higress-group/higress --skill higress-auto-router -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install higress-group/higress higress-auto-router --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/higress-group/higress.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/higress-auto-router .agents/skills/higress-auto-router && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "higress-auto-router" agent skill from https://github.com/higress-group/higress/tree/main/.agents/skills/higress-auto-router into .agents/skills/higress-auto-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "higress-auto-router", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add higress-group/higress --skill higress-auto-router -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install higress-group/higress higress-auto-router --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/higress-group/higress.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/higress-auto-router .cursor/skills/higress-auto-router && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "higress-auto-router" agent skill from https://github.com/higress-group/higress/tree/main/.agents/skills/higress-auto-router into .cursor/skills/higress-auto-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "higress-auto-router", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/higress-group/higress.git --path .agents/skills/higress-auto-router

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add higress-group/higress --skill higress-auto-router -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install higress-group/higress higress-auto-router --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/higress-group/higress.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/higress-auto-router .gemini/skills/higress-auto-router && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "higress-auto-router" agent skill from https://github.com/higress-group/higress/tree/main/.agents/skills/higress-auto-router into .gemini/skills/higress-auto-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "higress-auto-router", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install higress-group/higress higress-auto-router

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add higress-group/higress --skill higress-auto-router -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/higress-group/higress.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/higress-auto-router .github/skills/higress-auto-router && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "higress-auto-router" agent skill from https://github.com/higress-group/higress/tree/main/.agents/skills/higress-auto-router into .github/skills/higress-auto-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "higress-auto-router", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add higress-group/higress --skill higress-auto-router -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install higress-group/higress higress-auto-router --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/higress-group/higress.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/higress-auto-router .opencode/skills/higress-auto-router && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "higress-auto-router" agent skill from https://github.com/higress-group/higress/tree/main/.agents/skills/higress-auto-router into .opencode/skills/higress-auto-router/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "higress-auto-router", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: higress-auto-router
GitHub stars: 9.5k
Token cost: ~954 tokens
SKILL.md length: 218 words
Files: 1
Skills in repo: 11
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Configure automatic model routing using the get-ai-gateway.sh CLI tool for Higress AI Gateway.

Works in 3 steps: User Request:… → Execute CLI → Response to User
User wants to configure automatic model routing
SKILL.md covers Prerequisites, CLI Commands, Common Trigger Mappings and Usage Flow, plus 3 more sections
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Higress Auto Router is an agent skill from higress-group/higress. Configure automatic model routing using the get-ai-gateway.sh CLI tool for Higress AI Gateway. Use when: (1) User wants to configure automatic model routing, (2) User mentions 'route to', 'switch model', 'use model when', 'auto routing', (3) User describes scenarios that should trigger specific models, (4) User wants to add, list, or remove routing rules.

Its SKILL.md is about 950 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Model routing and gateways. It works with Qwen and OpenAI. The repository describes itself as: 🤖 AI Gateway | AI Native API Gateway. The licence is Apache-2.0.

When your agent uses it

User wants to configure automatic model routing
User mentions route to
User describes scenarios that should trigger specific models
User wants to add

Example prompts

“route to”
“switch model”
“use model when”
“/higress-auto-router”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

User Request: "我希望在解决困难问题时路由到claude-opus-4.5"
Execute CLI
Response to User

What it can do on your machine

Read from SKILL.md and the folder at commit c74d7e2. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Higress Auto Router loads about 954 tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 218 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~94
When it runs · the whole SKILL.md, loaded when a task matches: ~954

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from higress-group/higress at commit c74d7e2, republished under its Apache-2.0 licence (© higress-group). 218 words, ~954 tokens.

Download SKILL.mdSave it as .claude/skills/higress-auto-router/SKILL.md (or your agent's skills folder).

name: higress-auto-router
description: Configure automatic model routing using the get-ai-gateway.sh CLI tool for Higress AI Gateway. Use when: (1) User wants to configure automatic model routing, (2) User mentions 'route to', 'switch model', 'use model when', 'auto routing', (3) User describes scenarios that should trigger specific models, (4) User wants to add, list, or remove routing rules.

Higress Auto Router

Configure automatic model routing using the get-ai-gateway.sh CLI tool for intelligent model selection based on message content triggers.

Prerequisites

Higress AI Gateway running (container name: higress-ai-gateway)
get-ai-gateway.sh script downloaded

CLI Commands

Add a Routing Rule

bash

./get-ai-gateway.sh route add --model <model-name> --trigger "<trigger-phrases>"

Options:

--model MODEL (required): Target model to route to
--trigger PHRASE: Trigger phrase(s), separated by | (e.g., "深入思考|deep thinking")
--pattern REGEX: Custom regex pattern (alternative to --trigger)

Examples:

bash

# Route complex reasoning to Claude
./get-ai-gateway.sh route add \
  --model claude-opus-4.5 \
  --trigger "深入思考|deep thinking"

# Route coding tasks to Qwen Coder
./get-ai-gateway.sh route add \
  --model qwen-coder \
  --trigger "写代码|code:|coding:"

# Route creative writing
./get-ai-gateway.sh route add \
  --model gpt-4o \
  --trigger "创意写作|creative:"

# Use custom regex pattern
./get-ai-gateway.sh route add \
  --model deepseek-chat \
  --pattern "(?i)^(数学题|math:)"

List Routing Rules

bash

./get-ai-gateway.sh route list

Output:

Default model: qwen-turbo

ID   Pattern                                  Model               
----------------------------------------------------------------------
0    (?i)^(深入思考|deep thinking)             claude-opus-4.5     
1    (?i)^(写代码|code:|coding:)               qwen-coder

Remove a Routing Rule

bash

./get-ai-gateway.sh route remove --rule-id <id>

Example:

bash

# Remove rule with ID 0
./get-ai-gateway.sh route remove --rule-id 0

Common Trigger Mappings

Scenario	Suggested Triggers	Recommended Model
Complex reasoning	`深入思考\|deep thinking`	claude-opus-4.5, o1
Coding tasks	`写代码\|code:\|coding:`	qwen-coder, deepseek-coder
Creative writing	`创意写作\|creative:`	gpt-4o, claude-sonnet
Translation	`翻译:\|translate:`	gpt-4o, qwen-max
Math problems	`数学题\|math:`	deepseek-r1, o1-mini
Quick answers	`快速回答\|quick:`	qwen-turbo, gpt-4o-mini

Usage Flow

User Request: "我希望在解决困难问题时路由到claude-opus-4.5"

Execute CLI:

bash

./get-ai-gateway.sh route add \
  --model claude-opus-4.5 \
  --trigger "深入思考|deep thinking"

Response to User:

✅ 自动路由配置完成！

触发方式：以 "深入思考" 或 "deep thinking" 开头
目标模型：claude-opus-4.5

使用示例：
- 深入思考 这道算法题应该怎么解？
- deep thinking What's the best architecture?

提示：确保请求中 model 参数为 'higress/auto'

How Auto-Routing Works

User sends request with model: "higress/auto"
Higress checks message content against routing rules
If a trigger pattern matches, routes to the specified model
If no match, uses the default model (e.g., qwen-turbo)

Configuration File

Rules are stored in the container at:

/data/wasmplugins/model-router.internal.yaml

The CLI tool automatically:

Edits the configuration file
Triggers hot-reload (no container restart needed)
Validates YAML syntax

Error Handling

Container not running: Start with ./get-ai-gateway.sh start
Rule ID not found: Use route list to see valid IDs
Invalid model: Check configured providers in Higress Console

Files

Just SKILL.md in .agents/skills/higress-auto-router of higress-group/higress.

Open the folder on GitHubat commit c74d7e2

Compare with similar skills

Higress Auto Router next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Higress Auto Router compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Higress Auto Router this skillhigress-group/higress	9.5k	—	~954	Automated safety check: Pass	Apache-2.0	3 days ago
KibibotLeoYeAI/openclaw-master-skills	2.2k	—	~5.1k	Automated safety check: Pass	MIT	2 mo ago
Page AgentTommy-yw/RunbookHermes	546	3 repos	~2.3k	Automated safety check: Notes	MIT	4 mo ago
9Router AI Gateway Setupdecolua/9router	31k	—	~744	Automated safety check: Pass	MIT	3 days ago
9Router Chat Completionsdecolua/9router	31k	—	~635	Automated safety check: Pass	MIT	3 days ago
Agent Squad Python Guide2FastLabs/agent-squad	7.8k	—	~4.7k	Automated safety check: Pass	Apache-2.0	3 days ago

Similar skills

Kibibot
LeoYeAI/openclaw-master-skills
Create tokens on-chain, check fee earnings, check Kibi Credit balance, trigger agent credit reload, and interact with KibiBot's Agent API and Kibi LLM Gateway.
2.2k GitHub stars~5.1k tokensUpdated 2 mo ago
AI & LLM EngineeringAuto-check passed
Page Agent
Tommy-yw/RunbookHermes
Embed alibaba/page-agent into your own web application — a pure-JavaScript in-page GUI agent that ships as a single <script tag or npm package and lets end-users of your site drive the UI with…
546 GitHub starsUsed in 3 repos~2.3k tokens
Productivity & AutomationAuto-check: notes
9Router AI Gateway Setup
decolua/9router
Sets up access to the 9Router AI gateway, an OpenAI-compatible REST endpoint for chat, images, speech, embeddings, web search and web fetch, and indexes its capability skills.
31k GitHub stars~744 tokensUpdated 3 days ago
AI & LLM EngineeringAuto-check passed
9Router Chat Completions
decolua/9router
Sends chat and code-generation requests through a 9Router gateway using OpenAI or Anthropic message formats, with streaming and auto-fallback combos.
31k GitHub stars~635 tokensUpdated 3 days ago
AI & LLM EngineeringAuto-check passed
Agent Squad Python Guide
2FastLabs/agent-squad
Map of the agent-squad Python framework for async multi-agent orchestration: which agent, classifier, storage and tool provider to pick, and the pitfalls to avoid.
7.8k GitHub stars~4.7k tokensUpdated 3 days ago
AI & LLM EngineeringAuto-check passed
Embeddings via 9Router
decolua/9router
Generates vector embeddings through the 9Router /v1/embeddings endpoint, using models from providers such as OpenAI, Gemini, Mistral and Voyage for RAG and semantic search.
31k GitHub stars~604 tokensUpdated 3 days ago
AI & LLM EngineeringAuto-check passed

Questions about Higress Auto Router

What does Higress Auto Router do?

Configure automatic model routing using the get-ai-gateway.sh CLI tool for Higress AI Gateway. Higress Auto Router is an agent skill from higress-group/higress.sh CLI tool for Higress AI Gateway.

When should I use Higress Auto Router?

Higress Auto Router fits situations like: user wants to configure automatic model routing; user mentions route to; user describes scenarios that should trigger specific models; user wants to add.

How do I install Higress Auto Router in Claude Code?

Run `npx skills add higress-group/higress --skill higress-auto-router -a claude-code`. Or copy the skill folder (.agents/skills/higress-auto-router in higress-group/higress) into .claude/skills/higress-auto-router in your project. Claude Code loads it when a task matches its description.

How do I install Higress Auto Router in Codex?

Run `npx skills add higress-group/higress --skill higress-auto-router -a codex`. Or copy the skill folder (.agents/skills/higress-auto-router in higress-group/higress) into .agents/skills/higress-auto-router in your project. Codex loads it when a task matches its description.

Can I use Higress Auto Router in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add higress-group/higress --skill higress-auto-router -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/higress-auto-router, .gemini/skills/higress-auto-router, .github/skills/higress-auto-router and .opencode/skills/higress-auto-router in your project.

What does Higress Auto Router need to run?

SKILL.md names no scripts, command-line tools or credentials: Higress Auto Router is instructions for the agent only.

Does Higress Auto Router access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Higress Auto Router safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Higress Auto Router use?

Higress Auto Router is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Higress Auto Router use?

About 954 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Higress Auto Router?

Skills that share tags, products or a category with Higress Auto Router: Kibibot (LeoYeAI/openclaw-master-skills, 2.2k stars), Page Agent (Tommy-yw/RunbookHermes, 546 stars), 9Router AI Gateway Setup (decolua/9router, 31k stars) and 9Router Chat Completions (decolua/9router, 31k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Higress Auto Router?

higress-group (a GitHub organization) maintains it in higress-group/higress, which has 9,516 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: higress-group/higress on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Higress Auto Router

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Higress Auto Router

Prerequisites

CLI Commands

Add a Routing Rule

List Routing Rules

Remove a Routing Rule

Common Trigger Mappings

Usage Flow

How Auto-Routing Works

Configuration File

Error Handling

Files

Compare with similar skills

Similar skills

More from higress-group/higress

Related

Questions about Higress Auto Router