zenmux-usage
zenmux/skills · skills.sh
Open source Repository Open in the app JSON README (API)
About
Skill publicada por zenmux/skills no skills.sh. Instale com: npx skills add zenmux/skills@zenmux-usage
Details
- Kind
- Agent skills
- Publisher
- zenmux
- Origin
- skillssh
- Category
- ferramentas
- Stars
- 20
- Forks
- 3
- Last push
- 2026-09-13T04:02:08Z
- Repository state
- ativo
- Language
- TypeScript
- Added
- 2026-10-06 04:49:26
- Updated
- 2026-10-06 04:49:26
- Origin id
zenmux/skills/zenmux-usage
README
# ZenMux Skills
The official skill repository for [ZenMux](https://zenmux.ai) .
## Installation
```bash
npx skills add ZenMux/skills
```
Install a single skill:
```bash
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
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
- `curl` and `jq` installed
- `ZENMUX_MANAGEMENT_KEY` env var for account data ([create one here](https://zenmux.ai/platform/management))
## 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 <project-dir>/.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
- [ZenMux](https://zenmux.ai)
- [ZenMux Docs](https://docs.zenmux.ai)
- [ZenMux Docs Repository](https://github.com/ZenMux/zenmux-doc)