How do I install the Model Switch skill?

Run npx skillmds add zhaog100/model-switch in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Model Switch safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Model Switch?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Model Switch free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Model Switch?

zhaog100 (@zhaog100) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Model Switch by zhaog100 — Agent Skill

Name: Model Switch
Rating: 4.2 (5 reviews)
Author: zhaog100

File contents

Model Switch v1.1.0

创建者: 思捷娅科技 (SJYKJ)/zhaog100

MIT License

免费使用、修改和重新分发时，需注明出处。

Switch session model provider and model alias on demand.

Available Models

Provider	Models	Best For	Status
Agnes AI ⭐	agnes-2.5-flash, agnes-2.0-flash, agnes-1.5-flash, agnes-image-2.0-flash	Primary	✅
LongCat	LongCat-2.0-Preview, LongCat-Flash-Thinking-2601, LongCat-Flash-Lite, LongCat-Flash-Chat, LongCat-Flash-Omni-2603	Fallback	✅

Removed: 百炼, GLM, MiniMax, OpenRouter, Gemini (disabled 2026-06-09)

Switching

session_status model=agnes-2.5-flash    # switch to agnes-2.5-flash
session_status model=default               # reset to primary

See references/providers.md for endpoints.

Model Selection Guide

Task Type	Recommended Model	Reason
General	agnes-2.5-flash	Primary model, best quality
Thinking	agnes-2.5-flash or LongCat-Flash-Thinking-2601	Deep reasoning
Fast/cheap	LongCat-Flash-Lite	Low cost, fast
Image	agnesai/agnes-image-2.0-flash	Image understanding
Fallback	LongCat-2.0-Preview	Reliable backup

自动降级策略（2026-06-09 更新）

优先级顺序：

agnesai/agnes-2.5-flash — 主力模型（优先使用）
agnesai/agnes-2.0-flash — 备用 1
agnesai/agnes-1.5-flash — 备用 2
longcat/LongCat-2.0-Preview — LongCat 主力（2.0 不可用时切换）
longcat/LongCat-Flash-Thinking-2601 — LongCat 深度思考
longcat/LongCat-Flash-Lite — LongCat 轻量（快速任务/进一步降级）

触发条件：

API 返回 429 (Rate Limit) → 切换到下一个 LongCat 模型
API 返回 401/403 (Auth Error) → 切换到下一个 LongCat 模型
API 返回 500/503 (Server Error) → 切换到下一个 LongCat 模型
上下文超限 → 切换到 LongCat-Flash-Lite

Error Handling

If model switch fails:

Check session_status for error message
Verify auth profile and API key in .env
Try fallback: session_status model=longcat/LongCat-2.0-Preview
If persistent, read references/troubleshooting.md

References

Provider details: references/providers.md — endpoints, model list
Troubleshooting: references/troubleshooting.md — common errors and fixes

---name: model-switchdescription: Switch AI models and providers. Supports LongCat, Agnes AI. Use when user asks to change model, switch provider, or optimize for coding/thinking/cheap tasks.---# Model Switch v1.1.0**创建者**: 思捷娅科技 (SJYKJ)/zhaog100---MIT LicenseCopyright (c) 2026 思捷娅科技 (SJYKJ)免费使用、修改和重新分发时，需注明出处。---Switch session model provider and model alias on demand.## Available Models| Provider | Models | Best For | Status ||----------|--------|----------|--------|| Agnes AI ⭐ | agnes-2.5-flash, agnes-2.0-flash, agnes-1.5-flash, agnes-image-2.0-flash | Primary | ✅ || LongCat | LongCat-2.0-Preview, LongCat-Flash-Thinking-2601, LongCat-Flash-Lite, LongCat-Flash-Chat, LongCat-Flash-Omni-2603 | Fallback | ✅ |**Removed**: 百炼, GLM, MiniMax, OpenRouter, Gemini (disabled 2026-06-09)## Switching```session_status model=agnes-2.5-flash # switch to agnes-2.5-flashsession_status model=default # reset to primary```See `references/providers.md` for endpoints.## Model Selection Guide| Task Type | Recommended Model | Reason ||-----------|------------------|--------|| General | agnes-2.5-flash | Primary model, best quality || Thinking | agnes-2.5-flash or LongCat-Flash-Thinking-2601 | Deep reasoning || Fast/cheap | LongCat-Flash-Lite | Low cost, fast || Image | agnesai/agnes-image-2.0-flash | Image understanding || Fallback | LongCat-2.0-Preview | Reliable backup |## 自动降级策略（2026-06-09 更新）**优先级顺序**：1. `agnesai/agnes-2.5-flash` — 主力模型（优先使用）2. `agnesai/agnes-2.0-flash` — 备用 13. `agnesai/agnes-1.5-flash` — 备用 22. `longcat/LongCat-2.0-Preview` — LongCat 主力（2.0 不可用时切换）3. `longcat/LongCat-Flash-Thinking-2601` — LongCat 深度思考4. `longcat/LongCat-Flash-Lite` — LongCat 轻量（快速任务/进一步降级）**触发条件**：- API 返回 429 (Rate Limit) → 切换到下一个 LongCat 模型- API 返回 401/403 (Auth Error) → 切换到下一个 LongCat 模型- API 返回 500/503 (Server Error) → 切换到下一个 LongCat 模型- 上下文超限 → 切换到 LongCat-Flash-Lite## Error HandlingIf model switch fails:1. Check `session_status` for error message2. Verify auth profile and API key in `.env`3. Try fallback: `session_status model=longcat/LongCat-2.0-Preview`4. If persistent, read `references/troubleshooting.md`## References- **Provider details**: `references/providers.md` — endpoints, model list- **Troubleshooting**: `references/troubleshooting.md` — common errors and fixes

Frequently asked questions