{
  "markdown": "# ZenMux Skills\n\nThe official skill repository for [ZenMux](https://zenmux.ai) .\n\n## Installation\n\n```bash\nnpx skills add ZenMux/skills\n```\n\nInstall a single skill:\n\n```bash\nnpx skills add https://github.com/zenmux/skills --skill zenmux-context\nnpx skills add https://github.com/zenmux/skills --skill zenmux-setup\nnpx skills add https://github.com/zenmux/skills --skill zenmux-usage\nnpx skills add https://github.com/zenmux/skills --skill zenmux-feedback\nnpx skills add https://github.com/zenmux/skills --skill zenmux-statusline\nnpx skills add https://github.com/zenmux/skills --skill zenmux-image-generation\nnpx skills add https://github.com/zenmux/skills --skill zenmux-codex-pets\nnpx skills add https://github.com/zenmux/skills --skill morphe\n```\n\n## Available Skills\n\n| Skill | Description |\n|-------|-------------|\n| **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. |\n| **zenmux-setup** | Interactive onboarding guide. Walks users through configuring ZenMux with their tool or SDK step by step. |\n| **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). |\n| **zenmux-feedback** | Submit GitHub issues, feature requests, bug reports, product suggestions, and feedback to ZenMux. Gathers info conversationally and submits via `gh` CLI. |\n| **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). |\n| **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. |\n| **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. |\n| **morphe** | Deploy NextJS project into https://morphe.zenmux.app |\n\n## zenmux-codex-pets\n\nInstall bundled ZenMux pets for Codex APP:\n\n```bash\nbash skills/zenmux-codex-pets/scripts/install-pets.sh\n```\n\nThe 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:\n\n- `zenmux-padawan`\n\nYou can also install manually by copying each folder under `skills/zenmux-codex-pets/pets/` into `~/.codex/pets`, then using the pets in Codex APP.\n\n## zenmux-statusline\n\nA two-line status bar displayed at the bottom of Claude Code, combining session metrics with ZenMux account data.\n\n```\n[claude-opus-4-7[1m]] 📁 skills | 🌿 main* | ████░░░░░░ 42% ctx | 💾 r72.0k w5.0k\n⚡ ZenMux Ultra | 🔑 Sub sk-ss-...6e6 | 5h █░░░░ 19% · 7d █░░░░ 24% | 💳 Bal $492.74\n```\n\n### Line 1 — Session Info\n\n| Segment | Example | Description |\n|---------|---------|-------------|\n| **Model** | `[claude-opus-4-7[1m]]` | Model slug (`.model.id` from Claude Code) |\n| **Directory** | `📁 skills` | Current working directory name |\n| **Git** | `🌿 main*` | Branch name, `*` indicates uncommitted changes |\n| **Context** | `████░░░░░░ 42% ctx` | Context window used percentage with progress bar. Green <70%, yellow 70-89%, red 90%+ |\n| **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 |\n\n### Line 2 — ZenMux Account\n\n| Segment | Example | Description |\n|---------|---------|-------------|\n| **Plan** | `⚡ ZenMux Ultra` | Subscription tier. Shows `⚠` suffix when account status is not healthy |\n| **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 |\n| **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 |\n| **Quota 7d** | `7d █░░░░ 24%` | 7-day rolling window quota usage, same color and reset-countdown behavior |\n| **PAYG Balance** | `💳 Bal $492.74` | Available wallet balance (top-up + bonus credits). Hidden when no PAYG credits exist |\n\n### Fallback Behavior\n\n| Condition | Behavior |\n|-----------|----------|\n| `ZENMUX_MANAGEMENT_KEY` not set | Line 2 shows setup hint: `⚙ Set ZENMUX_MANAGEMENT_KEY to display account data → zenmux.ai/platform/management` |\n| `ZENMUX_API_KEY` not set | API Key segment hidden, rest of Line 2 shown normally |\n| API call fails | Uses stale cache if available, otherwise Line 2 hidden |\n\n### Refresh Cycle\n\n| Data | Interval | Source |\n|------|----------|--------|\n| Session (model, context, cache) | Real-time | Piped from Claude Code after each assistant message |\n| Git branch | 5 seconds | Cached per session |\n| ZenMux account (plan, quota, PAYG) | 120 seconds | Cached globally, shared across sessions |\n\n### Requirements\n\n- `curl` and `jq` installed\n- `ZENMUX_MANAGEMENT_KEY` env var for account data ([create one here](https://zenmux.ai/platform/management))\n\n## Repository Structure\n\n```\nskills/                              # Skills directory\n  zenmux-context/                    # ZenMux documentation skill\n    SKILL.md                         # Skill definition\n    scripts/\n      update-references.sh           # Clone/update reference repos\n      get-doc-tree.sh               # Documentation tree generator\n    references/                      # External repo clones (git-ignored)\n      references-list.txt            # Source repos list\n  zenmux-setup/                      # ZenMux onboarding skill\n    SKILL.md                         # Skill definition\n  zenmux-usage/                      # ZenMux usage query skill\n    SKILL.md                         # Skill definition\n  zenmux-feedback/                   # ZenMux feedback & issue submission skill\n    SKILL.md                         # Skill definition\n    scripts/\n      update-references.sh           # Clone/update reference repos\n    references/                      # External repo clones (git-ignored)\n      references-list.txt            # Source repos list\n  zenmux-statusline/                 # Claude Code status line skill\n    SKILL.md                         # Skill definition\n    scripts/\n      zenmux-statusline.sh           # Status line bash script\n  zenmux-image-generation/           # ZenMux image generation skill\n    SKILL.md                         # Skill definition\n    config.json.example              # Shared defaults; copied once into each project\n    scripts/\n      workspace.mjs                  # Initialize project paths, .gitignore, and user config\n      refresh_references.sh          # Refresh when due; direct/reference prompt modes\n      refresh-state.mjs              # Track successful refreshes and failed-attempt retry delays\n      list_models.sh                 # Cache and merge both ZenMux image catalogs\n      generate-openai.ts             # OpenAI Images generation and editing\n      generate-gemini.ts             # Gemini/Vertex generation and editing\n    references/                      # Bundled offline documentation and model snapshot\n    # Runtime files are saved under <project-dir>/.context/zenmux-image-generation/:\n    # config.json, refresh-state.json, output/, prompts/, assets/, references/, and .gitignore.\n  zenmux-codex-pets/                 # ZenMux Codex APP pets installer skill\n    SKILL.md                         # Skill definition\n    scripts/\n      install-pets.sh                # Copy bundled pets into ~/.codex/pets\n    pets/\n      zenmux-padawan/                # Bundled Codex APP pet\n        pet.json\n        spritesheet.webp\n```\n\n## Links\n\n- [ZenMux](https://zenmux.ai)\n- [ZenMux Docs](https://docs.zenmux.ai)\n- [ZenMux Docs Repository](https://github.com/ZenMux/zenmux-doc)\n",
  "bytes": 8670,
  "sha": "206d48441141162783bf672a70c16a757a0f1e5088244ed03ccd51963088daa3",
  "repo_slug": "zenmux/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_zenmux_skills_zenmux_usage_de5b72de/readme"
}