diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 28a8124..7b1f200 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -59,6 +59,22 @@ "perplexity" ] }, + { + "name": "minimax", + "description": "Configure MiniMax text models, regional API endpoints, capabilities, thinking behavior, and token pricing.", + "source": "./dist/plugins/minimax", + "strict": false, + "skills": [ + "./skills/minimax" + ], + "category": "ai-tools", + "keywords": [ + "ai", + "minimax", + "regional-endpoints", + "model-configuration" + ] + }, { "name": "agent-md-refactor", "description": "Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.", diff --git a/README.md b/README.md index dd457d8..1a5bbfd 100644 --- a/README.md +++ b/README.md @@ -98,6 +98,7 @@ Add skills to project knowledge or paste SKILL.md contents into the conversation |----------|-------|-------------| | 🤖 AI Tools | [codex](skills/codex/README.md) | Advanced code analysis with GPT-5.2 | | 🤖 AI Tools | [gemini](skills/gemini/README.md) | Large-scale review (200k+ context) | +| 🤖 AI Tools | [minimax](skills/minimax/README.md) | Regional model configuration | | 🤖 AI Tools | [perplexity](skills/perplexity/README.md) | Web search & research | | 🔮 Meta | [agent-md-refactor](skills/agent-md-refactor/README.md) | Refactor bloated agent instruction files | | 🔮 Meta | [command-creator](skills/command-creator/README.md) | Create Claude Code slash commands | diff --git a/dist/plugins/minimax/skills/minimax/README.md b/dist/plugins/minimax/skills/minimax/README.md new file mode 100644 index 0000000..6c39a3d --- /dev/null +++ b/dist/plugins/minimax/skills/minimax/README.md @@ -0,0 +1,31 @@ +# MiniMax Skill + +Configure MiniMax text models with the correct regional API base, model capabilities, thinking behavior, and token pricing. + +## When to Use + +Use this skill when a request mentions: + +- MiniMax API configuration +- `MiniMax-M3` or `MiniMax-M2.7` +- Global or China-region MiniMax endpoints +- MiniMax model capabilities, thinking behavior, or cost estimates + +## What It Covers + +- Region selection for `global_en` and `cn_zh` +- Chat completions and messages API base URLs +- Model selection for text, image, and video inputs +- Context windows and thinking behavior +- Input, output, and cache token pricing +- API key handling through `MINIMAX_API_KEY` + +## Installation + +Install the plugin from the Agent Toolkit marketplace: + +```text +/plugin install minimax@agent-toolkit +``` + +Then ask the agent to configure MiniMax, select a region or model, or estimate token costs. See `SKILL.md` for the full workflow and current configuration tables. diff --git a/dist/plugins/minimax/skills/minimax/SKILL.md b/dist/plugins/minimax/skills/minimax/SKILL.md new file mode 100644 index 0000000..c36eb5f --- /dev/null +++ b/dist/plugins/minimax/skills/minimax/SKILL.md @@ -0,0 +1,52 @@ +--- +name: minimax +description: Configure MiniMax text models, regional API endpoints, capabilities, thinking behavior, and token pricing. Use when users mention MiniMax-M3, MiniMax-M2.7, MiniMax API setup, or MiniMax regions. +--- + +# MiniMax Provider Guide + +Use this skill when configuring a MiniMax text model or selecting a MiniMax API region. + +## Configuration Workflow + +1. Ask which region the user needs: `global_en` or `cn_zh`. Default to `global_en` only when no region is specified. +2. Ask whether the integration uses the chat completions API or the messages API. +3. Select the model from the capability table below. +4. Use the matching regional base URL. Do not combine endpoints from different regions. +5. Read the API key from `MINIMAX_API_KEY`. Never print, log, or commit it. +6. Present the chosen model, region, API style, base URL, and capability assumptions before making changes. + +## Regional Endpoints + +| Region | Chat completions base URL | Messages base URL | Documentation | +| --- | --- | --- | --- | +| `global_en` | `https://api.minimax.io/v1` | `https://api.minimax.io/anthropic` | `https://platform.minimax.io/docs` | +| `cn_zh` | `https://api.minimaxi.com/v1` | `https://api.minimaxi.com/anthropic` | `https://platform.minimaxi.com/docs` | + +## Model Selection + +| Model | Context window | Input modalities | Thinking behavior | +| --- | ---: | --- | --- | +| `MiniMax-M3` | 1,000,000 tokens | text, image, video | adaptive or disabled | +| `MiniMax-M2.7` | 204,800 tokens | text | always on | + +Choose `MiniMax-M3` when the request needs image or video input, a context window above 204,800 tokens, or configurable thinking. Choose `MiniMax-M2.7` for text-only requests that require always-on thinking. + +## Token Pricing + +Prices are in USD per million tokens. + +| Model | Input | Output | Cache read | Cache write | +| --- | ---: | ---: | ---: | ---: | +| `MiniMax-M3` | $0.60 | $2.40 | $0.12 | Not specified | +| `MiniMax-M2.7` | $0.30 | $1.20 | $0.06 | $0.375 | + +Use these values for estimates only. State the assumptions and calculate each token category separately. + +## Validation Checklist + +- The model ID is exactly `MiniMax-M3` or `MiniMax-M2.7`. +- The endpoint belongs to the selected region. +- Image and video inputs are used only with `MiniMax-M3`. +- Thinking is always on for `MiniMax-M2.7`. +- The API key remains in `MINIMAX_API_KEY` and is never included in output. diff --git a/skills/minimax/README.md b/skills/minimax/README.md new file mode 100644 index 0000000..6c39a3d --- /dev/null +++ b/skills/minimax/README.md @@ -0,0 +1,31 @@ +# MiniMax Skill + +Configure MiniMax text models with the correct regional API base, model capabilities, thinking behavior, and token pricing. + +## When to Use + +Use this skill when a request mentions: + +- MiniMax API configuration +- `MiniMax-M3` or `MiniMax-M2.7` +- Global or China-region MiniMax endpoints +- MiniMax model capabilities, thinking behavior, or cost estimates + +## What It Covers + +- Region selection for `global_en` and `cn_zh` +- Chat completions and messages API base URLs +- Model selection for text, image, and video inputs +- Context windows and thinking behavior +- Input, output, and cache token pricing +- API key handling through `MINIMAX_API_KEY` + +## Installation + +Install the plugin from the Agent Toolkit marketplace: + +```text +/plugin install minimax@agent-toolkit +``` + +Then ask the agent to configure MiniMax, select a region or model, or estimate token costs. See `SKILL.md` for the full workflow and current configuration tables. diff --git a/skills/minimax/SKILL.md b/skills/minimax/SKILL.md new file mode 100644 index 0000000..c36eb5f --- /dev/null +++ b/skills/minimax/SKILL.md @@ -0,0 +1,52 @@ +--- +name: minimax +description: Configure MiniMax text models, regional API endpoints, capabilities, thinking behavior, and token pricing. Use when users mention MiniMax-M3, MiniMax-M2.7, MiniMax API setup, or MiniMax regions. +--- + +# MiniMax Provider Guide + +Use this skill when configuring a MiniMax text model or selecting a MiniMax API region. + +## Configuration Workflow + +1. Ask which region the user needs: `global_en` or `cn_zh`. Default to `global_en` only when no region is specified. +2. Ask whether the integration uses the chat completions API or the messages API. +3. Select the model from the capability table below. +4. Use the matching regional base URL. Do not combine endpoints from different regions. +5. Read the API key from `MINIMAX_API_KEY`. Never print, log, or commit it. +6. Present the chosen model, region, API style, base URL, and capability assumptions before making changes. + +## Regional Endpoints + +| Region | Chat completions base URL | Messages base URL | Documentation | +| --- | --- | --- | --- | +| `global_en` | `https://api.minimax.io/v1` | `https://api.minimax.io/anthropic` | `https://platform.minimax.io/docs` | +| `cn_zh` | `https://api.minimaxi.com/v1` | `https://api.minimaxi.com/anthropic` | `https://platform.minimaxi.com/docs` | + +## Model Selection + +| Model | Context window | Input modalities | Thinking behavior | +| --- | ---: | --- | --- | +| `MiniMax-M3` | 1,000,000 tokens | text, image, video | adaptive or disabled | +| `MiniMax-M2.7` | 204,800 tokens | text | always on | + +Choose `MiniMax-M3` when the request needs image or video input, a context window above 204,800 tokens, or configurable thinking. Choose `MiniMax-M2.7` for text-only requests that require always-on thinking. + +## Token Pricing + +Prices are in USD per million tokens. + +| Model | Input | Output | Cache read | Cache write | +| --- | ---: | ---: | ---: | ---: | +| `MiniMax-M3` | $0.60 | $2.40 | $0.12 | Not specified | +| `MiniMax-M2.7` | $0.30 | $1.20 | $0.06 | $0.375 | + +Use these values for estimates only. State the assumptions and calculate each token category separately. + +## Validation Checklist + +- The model ID is exactly `MiniMax-M3` or `MiniMax-M2.7`. +- The endpoint belongs to the selected region. +- Image and video inputs are used only with `MiniMax-M3`. +- Thinking is always on for `MiniMax-M2.7`. +- The API key remains in `MINIMAX_API_KEY` and is never included in output.