ZenMux Skills
The official skill repository for ZenMux .
Installation
npx skills add ZenMux/skills
Install a single skill:
npx skills add https://github.com/zenmux/skills --skill zenmux-context
npx skills add https://github.com/zenmux/skills --skill zenmux-setup
npx skills add https://github.com/zenmux/skills --skill zenmux-usage
npx skills add https://github.com/zenmux/skills --skill zenmux-feedback
npx skills add https://github.com/zenmux/skills --skill zenmux-statusline
npx skills add https://github.com/zenmux/skills --skill zenmux-image-generation
npx skills add https://github.com/zenmux/skills --skill zenmux-codex-pets
Available Skills
| Skill | Description |
|---|
| zenmux-context | ZenMux documentation expert. Answers questions about product features, API usage, integration, configuration, and best practices by pulling the latest official docs and providing cited responses. Supports both English and Chinese. |
| zenmux-setup | Interactive onboarding guide. Walks users through configuring ZenMux with their tool or SDK step by step. |
| zenmux-usage | Query real-time ZenMux account data via the Management API: subscription detail, quota usage (5h/7d/monthly), account status, Flow rate, PAYG balance, per-generation cost/token breakdown, and platform statistics (timeseries trends, model leaderboards, provider market share). |
| zenmux-feedback | Submit GitHub issues, feature requests, bug reports, product suggestions, and feedback to ZenMux. Gathers info conversationally and submits via gh CLI. |
| zenmux-statusline | Install a Claude Code status line that displays real-time ZenMux account info (subscription tier, 5h/7d quota usage, PAYG wallet balance, API key type) alongside session metrics (model, context usage, prompt cache hits). |
| zenmux-image-generation | Generate images via ZenMux's image models (openai/gpt-image-2, Google Nano Banana Pro, Qwen Image, Doubao Seedream, ERNIE Image, GLM Image, Hunyuan Image, Kling, etc.). Picks an appropriate model, optimizes the prompt against that model's strengths (GPT Image 2 vs. Nano Banana guides), supports multi-image references via local paths or URLs ([Image #N] convention), saves the optimized prompt for review, and produces 4 variants by default. |
| zenmux-codex-pets | Install bundled ZenMux Codex APP pets by copying the pet folders under pets/ into ${CODEX_HOME:-$HOME/.codex}/pets, then report which pets were installed. |
zenmux-codex-pets
Install bundled ZenMux pets for Codex APP:
bash skills/zenmux-codex-pets/scripts/install-pets.sh
The installer copies every pet folder from skills/zenmux-codex-pets/pets/ into ${CODEX_HOME:-$HOME/.codex}/pets and prints the installed pet names. Current bundled pets:
You can also install manually by copying each folder under skills/zenmux-codex-pets/pets/ into ~/.codex/pets, then using the pets in Codex APP.
zenmux-statusline
A two-line status bar displayed at the bottom of Claude Code, combining session metrics with ZenMux account data.
[claude-opus-4-7[1m]] 📁 skills | 🌿 main* | ████░░░░░░ 42% ctx | 💾 r72.0k w5.0k
⚡ ZenMux Ultra | 🔑 Sub sk-ss-...6e6 | 5h █░░░░ 19% · 7d █░░░░ 24% | 💳 Bal $492.74
Line 1 — Session Info
| Segment | Example | Description |
|---|
| Model | [claude-opus-4-7[1m]] | Model slug (.model.id from Claude Code) |
| Directory | 📁 skills | Current working directory name |
| Git | 🌿 main* | Branch name, * indicates uncommitted changes |
| Context | ████░░░░░░ 42% ctx | Context window used percentage with progress bar. Green <70%, yellow 70-89%, red 90%+ |
| Cache | 💾 r72.0k w5.0k | Last API call's prompt cache: r = cache read (reused tokens), w = cache creation (newly cached tokens). Auto-scaled (856, 15.2k, 1.5M). Hidden before the first API call |
Line 2 — ZenMux Account
| Segment | Example | Description |
|---|
| Plan | ⚡ ZenMux Ultra | Subscription tier. Shows ⚠ suffix when account status is not healthy |
| API Key | 🔑 Sub sk-ss-...6e6 | Key type (Sub for sk-ss-v1-* subscription, PAYG for sk-ai-v1-*) + masked key (type prefix + last 3 chars). Hidden when ZENMUX_API_KEY is not set |
| Quota 5h | 5h █░░░░ 19% | 5-hour rolling window quota usage with mini-bar. Green <70%, yellow 70-89%, red 90%+. Shows ⏳ Xh Ym countdown to reset when 100% used |
| Quota 7d | 7d █░░░░ 24% | 7-day rolling window quota usage, same color and reset-countdown behavior |
| PAYG Balance | 💳 Bal $492.74 | Available wallet balance (top-up + bonus credits). Hidden when no PAYG credits exist |
Fallback Behavior
