ZenMux Skills Repo
Overview
The official skill repository for ZenMux . Install bundled ZenMux pets for Codex APP: 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. A two-line status bar displayed at the bottom of Claude Code, combining session metrics with ZenMux account data. - curl and jq installed - ZENMUX_MANAGEMENT_KEY env var for account data (create one here)
README
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
npx skills add https://github.com/zenmux/skills --skill morphe
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.5-flare by default, 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), optimizes prompts directly or using reference examples, saves them for review, and reads model/count defaults and refresh intervals from project-local config. |
| 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. |
| morphe | Deploy NextJS project into https://morphe.zenmux.app |
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:
zenmux-padawan
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
| Condition | Behavior |
|---|---|
ZENMUX_MANAGEMENT_KEY not set |
Line 2 shows setup hint: ⚙ Set ZENMUX_MANAGEMENT_KEY to display account data → zenmux.ai/platform/management |
ZENMUX_API_KEY not set |
API Key segment hidden, rest of Line 2 shown normally |
| API call fails | Uses stale cache if available, otherwise Line 2 hidden |
Refresh Cycle
| Data | Interval | Source |
|---|---|---|
| Session (model, context, cache) | Real-time | Piped from Claude Code after each assistant message |
| Git branch | 5 seconds | Cached per session |
| ZenMux account (plan, quota, PAYG) | 120 seconds | Cached globally, shared across sessions |
Requirements
curlandjqinstalledZENMUX_MANAGEMENT_KEYenv var for account data (create one here)
Repository Structure
skills/ # Skills directory
zenmux-context/ # ZenMux documentation skill
SKILL.md # Skill definition
scripts/
update-references.sh # Clone/update reference repos
get-doc-tree.sh # Documentation tree generator
references/ # External repo clones (git-ignored)
references-list.txt # Source repos list
zenmux-setup/ # ZenMux onboarding skill
SKILL.md # Skill definition
zenmux-usage/ # ZenMux usage query skill
SKILL.md # Skill definition
zenmux-feedback/ # ZenMux feedback & issue submission skill
SKILL.md # Skill definition
scripts/
update-references.sh # Clone/update reference repos
references/ # External repo clones (git-ignored)
references-list.txt # Source repos list
zenmux-statusline/ # Claude Code status line skill
SKILL.md # Skill definition
scripts/
zenmux-statusline.sh # Status line bash script
zenmux-image-generation/ # ZenMux image generation skill
SKILL.md # Skill definition
config.json.example # Shared defaults; copied once into each project
scripts/
workspace.mjs # Initialize project paths, .gitignore, and user config
refresh_references.sh # Refresh when due; direct/reference prompt modes
refresh-state.mjs # Track successful refreshes and failed-attempt retry delays
list_models.sh # Cache and merge both ZenMux image catalogs
generate-openai.ts # OpenAI Images generation and editing
generate-gemini.ts # Gemini/Vertex generation and editing
references/ # Bundled offline documentation and model snapshot
# Runtime files are saved under /.context/zenmux-image-generation/:
# config.json, refresh-state.json, output/, prompts/, assets/, references/, and .gitignore.
zenmux-codex-pets/ # ZenMux Codex APP pets installer skill
SKILL.md # Skill definition
scripts/
install-pets.sh # Copy bundled pets into ~/.codex/pets
pets/
zenmux-padawan/ # Bundled Codex APP pet
pet.json
spritesheet.webp
Links
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add zenmux/skills