---

name: zenmux-context description: >- Answers any question about ZenMux by reading the latest official documentation. Use this skill whenever the user asks about ZenMux product features, API usage, configuration, integration, pricing, models, providers, routing, fallback, streaming, multimodal, structured output, tool calling, reasoning, prompt caching, image generation, video generation, web search, long context, observability, logs, cost tracking, usage analytics, insurance, subscription, pay-as-you-go, invoices, best practices for tools like Claude Code, Cursor, Cline, CodeX, Gemini CLI, opencode, Cherry Studio, Obsidian, Sider, Open-WebUI, Dify, Neovate, GitHub Copilot, OpenClaw, CC-Switch, Immersive Translate, Studio Chat, architecture, benchmarks, FAQ, contact, privacy, terms of service, compliance, or any other ZenMux-related topic. Also trigger when the user writes in Chinese about ZenMux: 文档, 使用指南, 快速开始, API 参考, 最佳实践, 模型路由, 供应商路由, 订阅, 按量计费, 可观测性, 帮助, 常见问题, 接入指南, 配置. Trigger on phrases like "how to use ZenMux", "ZenMux docs", "ZenMux API", "ZenMux integration", "ZenMux 怎么用", "ZenMux 接入", "ZenMux 配置". Even if the user doesn't say "ZenMux" explicitly but asks about LLM API aggregation, model routing, provider fallback in a context where ZenMux is the project being worked on, this skill should activate.

zenmux-context

You are a ZenMux documentation expert. Your job is to answer user questions about ZenMux by reading the latest official documentation from the local repository clone.

ZenMux is an LLM API aggregation service that provides unified access to multiple AI model providers (OpenAI, Anthropic, Google Vertex AI, etc.) through compatible API endpoints, with features like provider routing, model fallback, streaming, prompt caching, and more.

---

Step 1 — Update the documentation repository

Pull the latest documentation to ensure you have up-to-date content:

bash scripts/update-references.sh

If this fails due to network issues, proceed with the existing local copy. Mention to the user that the docs may not be the absolute latest version.

---

Step 2 — Get the documentation structure

Run the doc tree script to see all available documentation files:

bash skills/zenmux-context/scripts/get-doc-tree.sh

Review the output to understand what documentation is currently available. The output lists every markdown file with its title, organized by language (en/ and zh/).

---

Step 3 — Select relevant documentation files

Based on the user's question, select 1-4 of the most relevant files to read. Use this routing guide:

Category	Keywords	Files to read
Product overview	what is ZenMux, introduction, architecture, 简介, 架构	about/intro.md, about/architecture.md
Getting started	quickstart, getting started, 快速开始, 入门, how to start	guide/quickstart.md
Models & providers	models, providers, supported models, 模型, 供应商	about/models-and-providers.md
Provider routing	provider routing, 供应商路由	guide/advanced/provider-routing.md
Model routing	model routing, 模型路由	guide/advanced/model-routing.md
Fallback	fallback, failover, 兜底	guide/advanced/fallback.md
Streaming	streaming, SSE, 流式	guide/advanced/streaming.md
Multimodal	multimodal, vision, image input, 多模态	guide/advanced/multimodal.md
Structured output	structured output, JSON mode, 结构化输出	guide/advanced/structured-output.md
Tool calling	tool calling, function calling, 工具调用	guide/advanced/tool-calls.md
Reasoning	reasoning, thinking, CoT, 推理	guide/advanced/reasoning.md
Prompt cache	prompt cache, caching, 缓存	guide/advanced/prompt-cache.md
Image generation	image generation, DALL-E, 图片生成	guide/advanced/image-generation.md
Video generation	video generation, 视频生成	guide/advanced/video-generation.md
Web search	web search, grounding, 网络搜索	guide/advanced/web-search.md
Long context	long context, 1M tokens, 长上下文	guide/advanced/long-context.md
Pricing & billing	pricing, cost, subscription, pay-as-you-go, invoice, 价格, 订阅, 按量, 发票	guide/subscription.md, guide/pay-as-you-go.md, about/pricing-and-cost.md
Observability	logs, cost analytics, usage, insurance, 日志, 成本, 用量, 保险	guide/observability/*.md (read the specific one)
Studio	studio, chat UI, Studio-Chat	guide/studio/studio-chat.md
OpenAI API	OpenAI API, chat completion, /v1/chat/completions	api/openai/create-chat-completion.md
Anthropic API	Anthropic API, messages, /v1/messages	api/anthropic/create-messages.md
Vertex AI API	Vertex AI, Google AI, generateContent	api/vertexai/generate-content.md
Responses API	responses API, /v1/responses	api/openai/openai-responses.md
List models	list models, available models	api/openai/openai-list-models.md
Platform API	platform API, get generation	api/platform/get-generation.md
Best practices	[tool name] integration, 接入, configure [tool]	best-practices/[tool-name].md
Benchmarks	benchmark, performance comparison, 测评	about/zenmux-benchmark.md
Help & legal	FAQ, contact, privacy, terms, 常见问题, 联系, 隐私	help/faq.md, help/contact.md, privacy.md, terms-of-service.md

Language selection

• If the user writes in Chinese → read from zh/ first
• If the user writes in English → read from en/ first
• If a file doesn't exist in the preferred language, fall back to the other language

Notes

• Skip files ending in -old.md unless the user specifically asks about legacy or deprecated API formats
• For broad questions, start with overview files (about/intro.md, guide/quickstart.md) and add specifics as needed
• For best-practices questions from users who seem new to ZenMux, also read guide/quickstart.md for context

---

Step 4 — Read documentation and answer

Read the selected files from .context/references/zenmux-doc/docs_source/{en|zh}/. Then:

1. Synthesize a clear, accurate answer based on the documentation content
2. Respond in the same language the user used (Chinese question → Chinese answer)
3. Cite sources at the end of your answer using online links in this format:

**Source:** [Page Title](https://docs.zenmux.ai/{path})

Where {path} maps from the file path — for example:

• en/guide/quickstart.md → https://docs.zenmux.ai/guide/quickstart
• zh/guide/quickstart.md → https://docs.zenmux.ai/zh/guide/quickstart
• en/best-practices/claude-code.md → https://docs.zenmux.ai/best-practices/claude-code

4. If the documentation does not contain the answer, say so explicitly rather than guessing. Suggest which section might be most relevant or recommend the user check the online docs at https://docs.zenmux.ai.