Agent skill

Mmx CLI

by Peiiii in Peiiii/nextclaw

Use mmx to generate text, images, video, speech, and music via the MiniMax AI platform.

MITAuto-check passedProductivity & Automation

Install Mmx CLI

skills CLI
$ npx skills add Peiiii/nextclaw --skill mmx-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Peiiii/nextclaw mmx-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Peiiii/nextclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mmx-cli .claude/skills/mmx-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mmx-cli
GitHub stars
260
Used in
4 other repos
Token cost
~2.7k tokens
SKILL.md length
824 words
Files
2
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

Use mmx to generate text, images, video, speech, and music via the MiniMax AI platform.

  • The user wants to create media content
  • SKILL.md covers Prerequisites, Agent Flags, Commands and Tool Schema Export, plus 3 more sections
  • Calls jq and npm; needs MINIMAX_API_KEY
  • Chat with MiniMax models

What it does

Mmx CLI is an agent skill from Peiiii/nextclaw. Use mmx to generate text, images, video, speech, and music via the MiniMax AI platform. Use when the user wants to create media content, chat with MiniMax models, perform web search, or manage MiniMax API resources from the terminal.

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `marketplace.json`).

It sits in Productivity & Automation, covering Web search. It works with MiniMax. The repository describes itself as: A human-centered long-term AI partner—not a task-centered assistant. The licence is MIT.

When your agent uses it

  • The user wants to create media content
  • Chat with MiniMax models
  • Perform web search
  • Manage MiniMax API resources from the terminal

Example prompts

  • “/mmx-cli”

Requirements

  • Node.js
  • A credential in MINIMAX_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit d130133. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MINIMAX_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mmx CLI loads about 2.7k tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 824 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~60
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Peiiii/nextclaw at commit d130133, republished under its MIT licence (© Peiiii). 824 words, ~2,736 tokens.

Download SKILL.mdSave it as .claude/skills/mmx-cli/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
mmx-cli
description
Use mmx to generate text, images, video, speech, and music via the MiniMax AI platform. Use when the user wants to create media content, chat with MiniMax models, perform web search, or manage MiniMax API resources from the terminal.

MiniMax CLI — Agent Skill Guide

Use mmx to generate text, images, video, speech, music, and perform web search via the MiniMax AI platform.

Prerequisites

bash
# Install
npm install -g mmx-cli

# Auth (persisted to ~/.mmx/credentials.json)
mmx auth login --api-key sk-xxxxx

# Or pass per-call
mmx text chat --api-key sk-xxxxx --message "Hello"

Region is auto-detected. Override with --region global or --region cn.


Agent Flags

Always use these flags in non-interactive (agent/CI) contexts:

FlagPurpose
--non-interactiveFail fast on missing args instead of prompting
--quietSuppress spinners/progress; stdout is pure data
--output jsonMachine-readable JSON output
--asyncReturn task ID immediately (video generation)
--dry-runPreview the API request without executing
--yesSkip confirmation prompts

Commands

text chat

Chat completion. Default model: MiniMax-M2.7.

bash
mmx text chat --message <text> [flags]
FlagTypeDescription
--message <text>string, required, repeatableMessage text. Prefix with role: to set role (e.g. "system:You are helpful", "user:Hello")
--messages-file <path>stringJSON file with messages array. Use - for stdin
--system <text>stringSystem prompt
--model <model>stringModel ID (default: MiniMax-M2.7)
--max-tokens <n>numberMax tokens (default: 4096)
--temperature <n>numberSampling temperature (0.0, 1.0]
--top-p <n>numberNucleus sampling threshold
--streambooleanStream tokens (default: on in TTY)
--tool <json-or-path>string, repeatableTool definition JSON or file path
bash
# Single message
mmx text chat --message "user:What is MiniMax?" --output json --quiet

# Multi-turn
mmx text chat \
  --system "You are a coding assistant." \
  --message "user:Write fizzbuzz in Python" \
  --output json

# From file
cat conversation.json | mmx text chat --messages-file - --output json

stdout: response text (text mode) or full response object (json mode).


image generate

Generate images. Model: image-01.

bash
mmx image generate --prompt <text> [flags]
FlagTypeDescription
--prompt <text>string, requiredImage description
--aspect-ratio <ratio>stringe.g. 16:9, 1:1
--n <count>numberNumber of images (default: 1)
--subject-ref <params>stringSubject reference: type=character,image=path-or-url
--out-dir <dir>stringDownload images to directory
--out-prefix <prefix>stringFilename prefix (default: image)
bash
mmx image generate --prompt "A cat in a spacesuit" --output json --quiet
# stdout: image URLs (one per line in quiet mode)

mmx image generate --prompt "Logo" --n 3 --out-dir ./gen/ --quiet
# stdout: saved file paths (one per line)

video generate

Generate video. Default model: MiniMax-Hailuo-2.3. This is an async task — by default it polls until completion.

bash
mmx video generate --prompt <text> [flags]
FlagTypeDescription
--prompt <text>string, requiredVideo description
--model <model>stringMiniMax-Hailuo-2.3 (default) or MiniMax-Hailuo-2.3-Fast
--first-frame <path-or-url>stringFirst frame image
--callback-url <url>stringWebhook URL for completion
--download <path>stringSave video to specific file
--asyncbooleanReturn task ID immediately
--no-waitbooleanSame as --async
--poll-interval <seconds>numberPolling interval (default: 5)
bash
# Non-blocking: get task ID
mmx video generate --prompt "A robot." --async --quiet
# stdout: {"taskId":"..."}

# Blocking: wait and get file path
mmx video generate --prompt "Ocean waves." --download ocean.mp4 --quiet
# stdout: ocean.mp4
video task get

Query status of a video generation task.

bash
mmx video task get --task-id <id> [--output json]
video download

Download a completed video by task ID.

bash
mmx video download --file-id <id> [--out <path>]

speech synthesize

Text-to-speech. Default model: speech-2.8-hd. Max 10k chars.

bash
mmx speech synthesize --text <text> [flags]
FlagTypeDescription
--text <text>stringText to synthesize
--text-file <path>stringRead text from file. Use - for stdin
--model <model>stringspeech-2.8-hd (default), speech-2.6, speech-02
--voice <id>stringVoice ID (default: English_expressive_narrator)
--speed <n>numberSpeed multiplier
--volume <n>numberVolume level
--pitch <n>numberPitch adjustment
--format <fmt>stringAudio format (default: mp3)
--sample-rate <hz>numberSample rate (default: 32000)
--bitrate <bps>numberBitrate (default: 128000)
--channels <n>numberAudio channels (default: 1)
--language <code>stringLanguage boost
--subtitlesbooleanInclude subtitle timing data
--pronunciation <from/to>string, repeatableCustom pronunciation
--sound-effect <effect>stringAdd sound effect
--out <path>stringSave audio to file
--streambooleanStream raw audio to stdout
bash
mmx speech synthesize --text "Hello world" --out hello.mp3 --quiet
# stdout: hello.mp3

echo "Breaking news." | mmx speech synthesize --text-file - --out news.mp3

Show full SKILL.md (376 more words)Show less
music generate

Generate music. Model: music-2.5. Responds well to rich, structured descriptions.

bash
mmx music generate --prompt <text> [--lyrics <text>] [flags]
FlagTypeDescription
--prompt <text>stringMusic style description (can be detailed)
--lyrics <text>stringSong lyrics with structure tags. Use "\u65e0\u6b4c\u8bcd" for instrumental. Cannot be used with --instrumental
--lyrics-file <path>stringRead lyrics from file. Use - for stdin
--vocals <text>stringVocal style, e.g. "warm male baritone", "bright female soprano", "duet with harmonies"
--genre <text>stringMusic genre, e.g. folk, pop, jazz
--mood <text>stringMood or emotion, e.g. warm, melancholic, uplifting
--instruments <text>stringInstruments to feature, e.g. "acoustic guitar, piano"
--tempo <text>stringTempo description, e.g. fast, slow, moderate
--bpm <number>numberExact tempo in beats per minute
--key <text>stringMusical key, e.g. C major, A minor, G sharp
--avoid <text>stringElements to avoid in the generated music
--use-case <text>stringUse case context, e.g. "background music for video", "theme song"
--structure <text>stringSong structure, e.g. "verse-chorus-verse-bridge-chorus"
--references <text>stringReference tracks or artists, e.g. "similar to Ed Sheeran"
--extra <text>stringAdditional fine-grained requirements
--instrumentalbooleanGenerate instrumental music (no vocals). Cannot be used with --lyrics or --lyrics-file
--aigc-watermarkbooleanEmbed AI-generated content watermark
--format <fmt>stringAudio format (default: mp3)
--sample-rate <hz>numberSample rate (default: 44100)
--bitrate <bps>numberBitrate (default: 256000)
--out <path>stringSave audio to file
--streambooleanStream raw audio to stdout

At least one of --prompt or --lyrics is required.

bash
# Simple usage
mmx music generate --prompt "Upbeat pop" --lyrics "La la la..." --out song.mp3 --quiet

# Detailed prompt with vocal characteristics
mmx music generate --prompt "Warm morning folk" \
  --vocals "male and female duet, harmonies in chorus" \
  --instruments "acoustic guitar, piano" \
  --bpm 95 \
  --lyrics-file song.txt \
  --out duet.mp3

# Instrumental (use --instrumental flag)
mmx music generate --prompt "Cinematic orchestral, building tension" --instrumental --out bgm.mp3

vision describe

Image understanding via VLM. Provide either --image or --file-id, not both.

bash
mmx vision describe (--image <path-or-url> | --file-id <id>) [flags]
FlagTypeDescription
--image <path-or-url>stringLocal path or URL (auto base64-encoded)
--file-id <id>stringPre-uploaded file ID (skips base64)
--prompt <text>stringQuestion about the image (default: "Describe the image.")
bash
mmx vision describe --image photo.jpg --prompt "What breed?" --output json

stdout: description text (text mode) or full response (json mode).


search query

Web search via MiniMax.

bash
mmx search query --q <query>
FlagTypeDescription
--q <query>string, requiredSearch query
bash
mmx search query --q "MiniMax AI" --output json --quiet

quota show

Display Token Plan usage and remaining quotas.

bash
mmx quota show [--output json]

Tool Schema Export

Export all commands as Anthropic/OpenAI-compatible JSON tool schemas:

bash
# All tool-worthy commands (excludes auth/config/update)
mmx config export-schema

# Single command
mmx config export-schema --command "video generate"

Use this to dynamically register mmx commands as tools in your agent framework.


Exit Codes

CodeMeaning
0Success
1General error
2Usage error (bad flags, missing args)
3Authentication error
4Quota exceeded
5Timeout
10Content filter triggered

Piping Patterns

bash
# stdout is always clean data — safe to pipe
mmx text chat --message "Hi" --output json | jq '.content'

# stderr has progress/spinners — discard if needed
mmx video generate --prompt "Waves" 2>/dev/null

# Chain: generate image → describe it
URL=$(mmx image generate --prompt "A sunset" --quiet)
mmx vision describe --image "$URL" --quiet

# Async video workflow
TASK=$(mmx video generate --prompt "A robot" --async --quiet | jq -r '.taskId')
mmx video task get --task-id "$TASK" --output json
mmx video download --task-id "$TASK" --out robot.mp4

Configuration Precedence

CLI flags → environment variables → ~/.mmx/config.json → defaults.

bash
# Persistent config
mmx config set --key region --value cn
mmx config show

# Environment
export MINIMAX_API_KEY=sk-xxxxx
export MINIMAX_REGION=cn

© Peiiii, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/mmx-cli of Peiiii/nextclaw.

  • SKILL.md
  • marketplace.json

Open the folder on GitHubat commit d130133

Used in 4 other repositories

We found 23 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 4 other GitHub owners. This page covers the copy in Peiiii/nextclaw, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Mmx CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mmx CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mmx CLI this skillPeiiii/nextclaw2604 repos~2.7kAutomated safety check: PassMIT
A Stock Predictiondigoal/blog8.6k—~2.2kAutomated safety check: PassGPL-2.0
Us Stock Predictiondigoal/blog8.6k—~1.9kAutomated safety check: WarnGPL-2.0
API Quota MonitoraAAaqwq/AGI-Super-Team1051 repos~874Automated safety check: PassMIT
Digoal Read Think Writerdigoal/blog8.6k—~1.3kAutomated safety check: PassGPL-2.0
Web Searchjjyaoao/HelloAgents3.2k1 repos~5.6kAutomated safety check: PassMIT

Similar skills

  • A股个股次日(T+1)走势预测 skill。当用户输入A股股票代码(如 600519、000858、300750、688981、430090)或公司名称(如"贵州茅台"、"宁德时代"、"比亚迪"),并要求预测次日走势、给出交易计划、评估盈亏概率时,触发本 skill。skill 会用 mcpMiniMaxwebsearch…

    8.6k GitHub stars~2.2k tokensUpdated 9 days ago
    Productivity & AutomationAuto-check passed
  • 美股个股次日走势预测 skill。当用户输入美股股票代码(如 AAPL、TSLA)或公司名称(如 "苹果"、"特斯拉"),并要求预测次日(T+1)走势、给出交易计划、评估盈亏概率时,触发本 skill。skill 会用 mcpMiniMaxwebsearch 搜证盘前 90…

    8.6k GitHub stars~1.9k tokensUpdated 9 days ago
    Productivity & AutomationAuto-check: warnings
  • API Quota Monitor

    aAAaqwq/AGI-Super-Team

    查询监控 API 供应商/服务的额度、余额、消耗情况。支持官方供应商(Gemini/xAI/ZAI/Minimax/OpenRouter等)、中转站(AIXN/Provider-A等)、订阅服务(Brave/Tavily/Serper)。触发词:查额度、查余额、API用量、供应商额度、quota、balance、usage、billing。

    105 GitHub starsUsed in 1 repo~874 tokens
    Productivity & AutomationAuto-check passed
  • 以 digoal/德哥 的第一人称口吻重写一篇文章。流程是:先吃透原文(必要时用 mcpMiniMaxwebsearch 拓展资料库),再用德哥的语气重新讲一遍,输出 markdown 到当前项目的 markdown/ 目录(SVG 图存到 markdown/svg/,文中以 ![描述](svg/xxx.svg)…

    8.6k GitHub stars~1.3k tokensUpdated 9 days ago
    AI & LLM EngineeringAuto-check passed
  • Web Search

    jjyaoao/HelloAgents

    Implement web search capabilities using the z-ai-web-dev-sdk.

    3.2k GitHub starsUsed in 1 repo~5.6k tokens
    Productivity & AutomationAuto-check passed
  • Local Web Search

    uluckyXH/OpenMOSS

    A skill your agent uses when the user asks for web search that should run via the local-160 Responses API with websearch tool (base URL like https://proxy.example.com, model gpt-5.2-codex(xhigh)).

    1.3k GitHub stars~392 tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check: notes

More from Peiiii/nextclaw

All 70 skills in this repo
  • Nextclaw Skin Studio

    Peiiii/nextclaw

    A skill your agent uses when a user wants to browse, apply, inspect, create, refine, switch, or remove a NextClaw skin; wants a personal skin with arbitrary CSS, JavaScript, images, SVG, DOM…

    260 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • A skill your agent uses when a development task needs visible phase tracing, task-level or phase-level Token measurement, model/effort comparison, or a deterministic usage report or local dashboard…

    260 GitHub stars~802 tokensUpdated yesterday
    Auto-check passed
  • 当 NextClaw 产品更新后需要生成、替换、挑毛病或检查官网、GitHub README、用户文档或社交传播中的真实截图、AI 宣传视觉、整页 HTML 宣传预览、社区二维码等对外视觉资产时使用;也用于“更新截图”“重新截一批图”“做宣传页”“生成 campaign 页面”“视觉审稿”“五星挑刺法”或发布前检查视觉资产。普通站点布局开发或只写文章不触发。

    260 GitHub stars~801 tokensUpdated yesterday
    Auto-check passed
  • UI UX Pro Max

    Peiiii/nextclaw

    A skill your agent uses when the user wants professional UI/UX design guidance, design-system generation, UX review, or stack-specific frontend guidance through a bundled local UI/UX Pro Max dataset…

    260 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Impeccable

    Peiiii/nextclaw

    A skill your agent uses when the user wants distinctive, production-grade frontend design, anti-generic AI aesthetics, UX critique, technical UI audits, or final polish through bundled Impeccable…

    260 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Curate NextClaw skill resources, including OpenClaw and community sources.

    260 GitHub stars~479 tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Mmx CLI

What does Mmx CLI do?

Use mmx to generate text, images, video, speech, and music via the MiniMax AI platform. Mmx CLI is an agent skill from Peiiii/nextclaw. Use mmx to generate text, images, video, speech, and music via the MiniMax AI platform.

When should I use Mmx CLI?

Mmx CLI fits situations like: the user wants to create media content; chat with MiniMax models; perform web search; manage MiniMax API resources from the terminal.

How do I install Mmx CLI in Claude Code?

Run `npx skills add Peiiii/nextclaw --skill mmx-cli -a claude-code`. Or copy the skill folder (skills/mmx-cli in Peiiii/nextclaw) into .claude/skills/mmx-cli in your project. Claude Code loads it when a task matches its description.

How do I install Mmx CLI in Codex?

Run `npx skills add Peiiii/nextclaw --skill mmx-cli -a codex`. Or copy the skill folder (skills/mmx-cli in Peiiii/nextclaw) into .agents/skills/mmx-cli in your project. Codex loads it when a task matches its description.

Can I use Mmx CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Peiiii/nextclaw --skill mmx-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mmx-cli, .gemini/skills/mmx-cli, .github/skills/mmx-cli and .opencode/skills/mmx-cli in your project.

What does Mmx CLI need to run?

Going by SKILL.md and its folder, Mmx CLI needs the command-line tools its instructions call (jq and npm) and credentials named MINIMAX_API_KEY. Our summary lists: Node.js; A credential in MINIMAX_API_KEY.

Does Mmx CLI access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Mmx CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mmx CLI use?

Mmx CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mmx CLI use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mmx CLI?

Skills that share tags, products or a category with Mmx CLI: A Stock Prediction (digoal/blog, 8.6k stars), Us Stock Prediction (digoal/blog, 8.6k stars), API Quota Monitor (aAAaqwq/AGI-Super-Team, 105 stars) and Digoal Read Think Writer (digoal/blog, 8.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mmx CLI?

Peiiii (a GitHub user) maintains it in Peiiii/nextclaw, which has 260 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 6, 2026.

Source: Peiiii/nextclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.