MiniMax Skills完全ガイド：17種とCLI・MCPの使い方

MiniMax Skillsは、AIエージェントへ専門的な作業手順を追加する、公式の再利用パッケージ集です。 2026年8月13日時点の公式リポジトリには、フロントエンド、フルスタック、Android、iOS、文書作成、画像・音楽制作など全17種が掲載されています。(公式リポジトリ)

ただし、ここで最初につまずきやすい点があります。「MiniMax Skills」「mmx CLI用の公式SKILL」「MiniMax MCP」は、名前が近くても役割が違います。Skillsは仕事の進め方を教える手順書、CLIはMiniMaxの生成機能をコマンドで実行する道具、MCPはエージェントと外部ツールをつなぐ共通接続方式です。

この記事では3つの違いを最初に整理し、Codex・Claude Code・Cursorへの導入、実際の使い方、更新・削除、mmx CLI、MCP、自作スキル、安全運用まで順番に試せる形で解説します。

MiniMax Skillsとは何か

Agent Skillは、特定の仕事で参照するSKILL.mdを入口に、詳しい資料、スクリプト、テンプレートなどをまとめたフォルダです。エージェントはスキル名と説明から必要性を判断し、該当する仕事で詳しい手順を読みます。

たとえば「Reactで見栄えのよい管理画面を作って」と頼んだとき、通常のモデル知識だけで進めるのではなく、frontend-devが設計、アクセシビリティ、アニメーション、確認項目を作業へ持ち込みます。スキル自身が新しい基盤モデルになるのではありません。同じエージェントへ、領域別の作法と道具の使い方を足すものです。

MiniMax M3とは別のレイヤー

前の記事で解説したMiniMax M3は、文章、コード、画像・動画を理解する基盤モデルです。一方、MiniMax SkillsはCodexやClaude Codeなどが読む作業パッケージです。

したがって、MiniMax SkillsをCodexへ入れても、CodexのモデルがM3へ切り替わるわけではありません。反対にM3をAPI設定しただけでは、17種のスキルが自動追加されるわけでもありません。

MiniMax Skills全17種：どれを選ぶか

公式READMEに掲載された17種は、大きく4群に分けると選びやすくなります。vision-analysisだけがCommunity表記で、残る16種はOfficial表記です。(公式スキル一覧)

1. アプリ・Web開発

迷ったら、画面中心ならfrontend-dev、認証やDBまで含むならfullstack-dev、モバイルは採用フレームワークに対応するスキルを選びます。複数を一度に有効化するより、主担当を1つ決めた方が指示の衝突を追いやすくなります。

2. ビジュアル・マルチメディア

この群にはAPI呼び出しやFFmpegなどの外部実行を伴うものがあります。インストールしただけで無料生成できるという意味ではありません。必要なAPIキー、プラン、実行ファイル、出力先を各SKILL.mdで確認してください。

3. 文書・オフィスファイル

文書系は「生成できた」で終わらず、実際に開いてレイアウト、改ページ、数式、文字化けまで確認して初めて完了です。スキルは検証手順を与えますが、成果物の正しさを保証する署名ではありません。

4. 最初に試すならこの3つ

• Web制作をしている：frontend-dev
• 仕様からAPI・DB・画面まで作りたい：fullstack-dev
• MiniMaxの画像・動画・音声を横断したい：minimax-multimodal-toolkit

まず普段の仕事に近い1つで、小さな検証課題を実行します。同じ依頼をスキルなしでも行い、設計の抜け、修正回数、所要時間、成果物の品質を比較すると、導入効果を判断できます。

CodexへMiniMax Skillsを導入する方法

公式手順は、リポジトリをcloneし、Codexが見つける.agents/skillsへリンクする方式です。(Codex公式導入手順) Windowsではシンボリックリンクではなく、ディレクトリジャンクションを使う例が案内されています。

Windows・PowerShell

まずGitが使えることを確認します。

git --version

次に、ユーザープロファイル配下へ公式リポジトリをcloneします。

git clone https://github.com/MiniMax-AI/skills.git "$env:USERPROFILE\.codex\minimax-skills"

Codex共通のスキル置き場を作り、cloneしたskillsフォルダへのジャンクションを作成します。

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
cmd /c mklink /J "$env:USERPROFILE\.agents\skills\minimax-skills" "$env:USERPROFILE\.codex\minimax-skills\skills"

Codexを完全に終了して再起動します。最後に、配置されたSKILL.mdを確認します。

Get-ChildItem "$env:USERPROFILE\.agents\skills\minimax-skills" -Recurse -Filter SKILL.md

macOS・Linux

git clone https://github.com/MiniMax-AI/skills.git ~/.codex/minimax-skills
mkdir -p ~/.agents/skills
ln -s ~/.codex/minimax-skills/skills ~/.agents/skills/minimax-skills

Codexそのものの初期導入がまだなら、先にCodex CLIの始め方を確認してください。

更新と削除

ジャンクションまたはシンボリックリンク方式なので、更新はclone先でgit pullするだけです。

Set-Location "$env:USERPROFILE\.codex\minimax-skills"
git pull

削除するときは、まず.agents\skills側のジャンクションだけを外し、必要ならclone先も削除します。削除対象がユーザープロファイル直下の想定パスであることを必ず確認してください。

Claude Code・Cursor・OpenCodeへの導入

Claude Code

Claude Codeでは公式プラグインマーケットプレイスとして追加します。

claude plugin marketplace add https://github.com/MiniMax-AI/skills
claude plugin install minimax-skills

Cursor

Windowsでは次の場所へcloneし、Cursor設定のskills pathをC:\Users\YOUR_USERNAME\.cursor\minimax-skills\skills\へ向けます。設定保存後にCursorを再起動またはウィンドウを再読み込みします。

git clone https://github.com/MiniMax-AI/skills.git "$env:USERPROFILE\.cursor\minimax-skills"

OpenCode

公式READMEは、cloneしたリポジトリの各スキルを~/.config/opencode/skills/へリンクする方式を案内しています。OSごとのリンク構文が違うため、OpenCode利用者はリポジトリ内の.opencode/INSTALL.mdを確認してください。

MiniMax Skillsの使い方

インストール後は、スキル名だけを唱えるより、目的、入力、制約、完了条件を一緒に渡すと安定します。MiniMax公式のM-series向けプロンプトガイドも、タスク、制約、望む出力を明確にし、必要な背景を説明することを勧めています。(M-series Usage Tips)

依頼例：フロントエンド

frontend-devを使って、既存Astroサイトの商品比較ページを改善してください。

目的:
- スマートフォンで比較表を読みやすくする
- CTAまでの迷いを減らす

制約:
- 既存のデザイントークンを使う
- 依存パッケージを追加しない
- WCAG 2.2 AAのコントラストを守る

完了条件:
- 変更ファイルを列挙する
- npm run checkとnpm run buildを通す
- 390px幅とデスクトップ幅をブラウザ確認する

依頼例：Excel

minimax-xlsxを使って、sales.csvから月別・商品別の売上集計.xlsxを作成してください。

- 元CSVは変更しない
- 集計根拠が追えるように元データシートを残す
- 数式エラー、文字化け、列幅、金額書式を検証する
- 完成後にシート名と行数を報告する

依頼例：導入前レビュー

minimax-multimodal-toolkitはまだ実行しないでください。
SKILL.md、参照ファイル、スクリプト、外部通信、必要な環境変数、
作成・上書きされるファイルを調べ、リスクと導入手順だけ報告してください。

最後の形は、初めて使うスキルに特に有効です。Agent Skillsは自然言語の説明だけではなく、任意のスクリプトも同梱できます。読み込むことと、外部コマンドを実行することを分けて承認すると安全性が上がります。

もう1つの公式SKILL：mmx CLI

MiniMax-AI/skillsとは別に、公式のMiniMax-AI/cliリポジトリもAgent用SKILLを配布しています。こちらは開発分野の設計ガイドではなく、エージェントがmmxコマンドを正しく選ぶための操作ガイドです。(mmx CLI公式GitHub)

2026年8月13日に確認した公式package.jsonのバージョンは1.0.19で、Node.js 18以上が必要です。(公式package.json) CLIはText、Image、Video、Speech、Music、Vision、Searchの7領域を1つのコマンド体系で扱います。

インストール

npm install -g mmx-cli
mmx --version

続いて認証します。画面共有中やシェル履歴へAPIキーを残したくない場合は、値をコマンドへ直接書く非対話方式より、対話ログインを優先します。

mmx auth login
mmx auth status
mmx quota

AgentにもCLIの使い方を理解させるなら、公式ドキュメントが推奨するSKILLを追加します。(MiniMax CLI公式ガイド)

npx skills add MiniMax-AI/cli -y -g

スキルの認識にはエージェントの再起動が必要です。なお、公式READMEはmmx CLIの利用にMiniMax Token Planが必要と案内しています。契約プランのAPIキーと地域が一致しているか確認してください。

すぐ試せるmmxコマンド

mmx text chat --message "このREADMEの改善案を3点出して"
mmx image "雨上がりの東京、映画的な夜景、16:9"
mmx speech synthesize --text "MiniMax CLIのテストです" --out sample.mp3
mmx video generate --prompt "Ocean waves at sunset" --download sunset.mp4
mmx music generate --prompt "Upbeat jazz for a coding session" --out coding-jazz.mp3
mmx vision describe --image .\screen.png --prompt "UI上の問題を説明して"
mmx search "MiniMax AI latest news"

生成物は容量が大きくなりやすいため、リポジトリ内で試すなら出力フォルダを決め、必要に応じて.gitignoreへ追加します。動画や音声を意図せずコミットしないことも確認してください。

401エラーが出る場合

最新版はAPIキーから地域を自動判定します。それでも401になる場合、公式ガイドは契約したサービスに合わせてglobalまたはcnを明示する方法を案内しています。

mmx config set --key region --value global
mmx auth status

中国本土向けプランの場合だけcnを指定します。海外プラットフォームのキーと中国本土向けホストを混ぜないことが重要です。

MiniMax Skills・CLI・MCPの使い分け

結論から言えば、作業品質を上げるならSkills、MiniMaxの生成機能をシェルから使うならmmx CLI、MCPクライアントのツールとして接続するならMCPです。

MiniMaxの一般向けMCPにはPython版とJavaScript版があり、音声合成、音声クローン、画像生成、動画生成などを提供します。Python版はstdio・SSE、JavaScript版はstdio・REST・SSEに対応します。(MiniMax MCP公式ガイド)

一方、Token Plan MCPは用途が狭く、web_searchとunderstand_imageの2ツールです。公式ドキュメント自身が、より簡単な設定と使い勝手のためにMiniMax CLIを推奨しています。(Token Plan MCP公式ガイド) そのため、シェルを使えるCodexやClaude Codeでは、まずmmx CLIを試す判断が自然です。

MCP、Skills、hooksなどの一般的な役割分担は、サブエージェント・スキル・MCP・hooksの使い分けでも整理しています。

MiniMax Skillsを安全に使うための7項目

スキルは単なる読み物とは限りません。スクリプト、依存関係、API通信、ファイル出力を含められます。便利さだけでなく、実行権限を持つコードとして扱います。

1. 公式URLとclone先を確認する：似た名前のリポジトリを取り違えない。
2. SKILL.mdだけでなくreferences/とscripts/も読む：外部通信、削除、上書き、送信を探す。
3. APIキーをソースへ書かない：環境変数や認証ストアを使い、Git差分も確認する。
4. 最初は診断だけ依頼する：変更・生成・外部送信を許可する前に、予定操作を報告させる。
5. 出力先を限定する：PDF、動画、音声、画像を作るフォルダを明示する。
6. 更新差分を確認する：Beta版なので、git pull前後の変更内容を読む。
7. 成果物を別手段で検証する：ビルド、テスト、実ファイルを開く確認を行う。

自分用のSKILL.mdを作る

公式リポジトリのコントリビューション規約では、スキルのディレクトリ名は小文字のkebab-case、入口はSKILL.md、必須frontmatterはnameとdescriptionです。nameはフォルダ名と一致させ、descriptionには発動条件を明記します。(公式CONTRIBUTING)

最小構成は次の通りです。

skills/
└── astro-release-check/
    ├── SKILL.md
    ├── references/
    │   └── checklist.md
    └── scripts/
        ├── verify.py
        └── requirements.txt  # scripts/がある場合は公式規約で必須

SKILL.mdの最小例です。

---
name: astro-release-check
description: >
  Astroサイトを公開前に確認するスキル。
  ユーザーが記事公開、デプロイ、リリース確認を依頼したときに使う。
license: MIT
metadata:
  version: "1.0"
  category: web
---

# Astro Release Check

1. 変更範囲と未コミット差分を確認する。
2. `npm run check`と`npm run build`を実行する。
3. title、description、canonical、構造化データを確認する。
4. 公開操作はユーザーの明示承認後に行う。
5. 公開URLのHTTP状態と表示を確認する。

実務では、長大な説明をすべてSKILL.mdへ詰めず、入口を短く保ち、必要な詳細だけreferences/へ分けます。スクリプトを入れるなら依存関係、入力、出力、失敗時の動作を明記し、APIキーは環境変数から読みます。

導入後の確認チェックリスト

• 公式MiniMax-AI/skillsから取得した
• 対象スキルのSKILL.mdとスクリプトを読んだ
• Codex／Claude Code／Cursorを再起動した
• 小さな依頼でスキル有無を比較した
• 外部通信、APIキー、課金条件を確認した
• 生成物の出力先とGit管理方針を決めた
• テストまたは実ファイル表示で結果を検証した
• 更新前に差分を確認する運用を決めた

よくある質問

MiniMax Skillsは無料で使えますか？

Skillsリポジトリ自体はMITライセンスで公開されています。ただし、スキルからMiniMax APIやmmx CLIを呼ぶ場合は、APIキー、Token Plan、従量課金、外部ツールが必要になることがあります。スキルの利用料と、実行先サービスの利用料を分けて考えてください。

MiniMax Skillsを入れるとMiniMax M3も自動で使われますか？

いいえ。Skillsは作業手順や判断基準をエージェントへ渡します。CodexやClaude Codeで使っている基盤モデルは自動変更されません。M3をモデルとして使う設定は別です。

MiniMax Skillsとmmx CLI用SKILLは同じものですか？

別物です。MiniMax-AI/skillsは開発・文書・制作向けの17種のスキル集です。MiniMax-AI/cliのSKILLは、エージェントがmmxコマンドを正確に選ぶための説明パッケージです。両方を入れることもできます。

CLIとMCPはどちらを選べばよいですか？

シェルを実行できるエージェントでは、簡単に導入できるmmx CLIから試すのが分かりやすい選択です。MCPクライアントの標準ツールとして接続したい、サーバーとして分離したい、転送方式を選びたい場合はMCPが向きます。

WindowsのCodexでも使えますか？

使えます。公式手順では、リポジトリをユーザープロファイル配下へcloneし、.agents\skills配下にディレクトリジャンクションを作り、Codexを再起動します。

結論：最初は1スキル、生成が必要ならCLI

MiniMax Skillsは、モデルを交換せずに、エージェントへ専門的な仕事の進め方を追加できる仕組みです。 17種の中から普段の仕事に最も近い1つを選び、小さな課題でスキルなしの結果と比べるのが、最も確実な始め方です。

画像、動画、音声、音楽、検索まで実行したくなったら、mmx CLIとその公式SKILLを追加します。MCPは、標準プロトコルで外部ツールとして接続する要件があるときに選びます。この順なら、必要以上に構成を複雑にせず、効果と権限を1段ずつ確認できます。

そして、どの方法でも最後に効くのは「何を作るか」「何を触ってよいか」「どう検証するか」を明示することです。スキルは魔法のボタンではなく、良い手順を何度でも再利用するための設計資産として扱うと価値が出ます。

次に読む

• MiniMax M3とは？料金・API・ローカル導入を完全解説
• Codex CLIの始め方
• サブエージェント・スキル・MCP・hooksの使い分け
• AIエージェントの秘密情報を守る