mux-video について
mux-videoは、Muxの機械可読ドキュメントを検索・参照するためのスキルです。関連するMarkdownページを1つ特定し、最新のAPI情報を確認して出典を示す手順を案内し、記憶だけに頼る回答を避けます。
主な機能
- 01順序に沿ったドキュメント検索
- 02必要なMarkdownページの取得
- 03APIリファレンスと仕様へのリンク
- 04出典URLの引用を必須化
- 05ドキュメント未取得時の推測回避
活用シーン
- 01最新のMux API詳細の確認
- 02Mux動画ワークフローのガイド検索
- 03出典付きでの質問回答
- 04ドキュメントURL変更時の再検索
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ muxinc/ skills --skill mux-videoインストール後、Claude Code で/mux-videoを入力して読み込まれたか確認します。
詳細
Mux ドキュメントの検索
Mux は、実際のドキュメントサイトと同じソースから自動生成された、エージェント対応の Markdown として、ドキュメント全体を公開しています。Mux に関する質問には、該当するページを取得して、その内容に基づいて回答してください。API の仕様や推奨事項は変更されるため、Mux API に関する質問に記憶だけで回答してはいけません。
ワークフロー
- 対象を絞り込む — 次の順に試し、最初に見つかった時点で終了します。 この順序はコストを考慮しており、各ステップで読み込むトークン数は次のステップより少なくなります。
muxCLI がインストールされている場合は、mux docs find "<topic>" --agentを実行します。ドキュメントのインデックスを CLI 側で検索し、該当ページの URL だけを返すため、インデックスをコンテキストに読み込む必要はありません。(mux docs --helpを確認してください。古いバージョンにはこの機能がありません。)- 既知のパターンから URL を組み立てます。以下の表(コレクション、
robots-<task>.md、API リファレンス)で、ほとんどのトピックをカバーできます。 - 対象分野で最小のコレクションインデックスを取得します(数十行程度)。
- 上記のステップで見つからない場合に限り、すべてのドキュメントページを一覧にしたマスターインデックス https://www.mux.com/llms.txt を取得します。
- ページを 1 つ取得します — ページの Markdown 版を取得します。URL の末尾に
.mdを追加してください(例:https://www.mux.com/docs/guides/start-live-streaming.md)。正確なリクエスト/レスポンスの仕様が必要な場合に限り、API リファレンスのバンドルを追加してください。「コンテキストのため」に余分なページを取得してはいけません。 - 取得した内容に基づいて回答し、ページの URL を引用してください。
https://www.mux.com/llms-full.txt は取得しないでください。 これはドキュメント全体を 1 つのファイルにまとめたもので、コンテキストウィンドウを埋め尽くします。上記の手順を使えば、ファイル内のすべてのページに個別にアクセスできます。
コレクションインデックス
| コレクション | URL |
|---|---|
| 基本概念 | https://www.mux.com/docs/core.txt |
| 動画:アップロード、エンコード、アセットの管理 | https://www.mux.com/docs/guides/video.txt |
| アップローダー:ユーザーによるアップロードの処理 | https://www.mux.com/docs/guides/uploader.txt |
| プレーヤー:動画再生の埋め込み | https://www.mux.com/docs/guides/player.txt |
| データ:再生品質と分析 | https://www.mux.com/docs/guides/data.txt |
| データ連携:サードパーティ製プレーヤーのモニタリング | https://www.mux.com/docs/guides/data-integrations.txt |
| フレームワーク連携と SDK | https://www.mux.com/docs/integrations.txt |
| 実装例 | https://www.mux.com/docs/examples.txt |
| 料金と請求 | https://www.mux.com/docs/pricing.txt |
Mux Robots(AI 動画ワークフロー)
Robots(Mux の AI 搭載動画ワークフロー)は、v1 API(/robots/v1)で一般提供されています。@mux/ts 16 以降では、client.robots が v1 を呼び出します。client.robotsV0 と /robots/v0 は非推奨のベータ版です。まずはこちらをご覧ください。
| リソース | URL |
|---|---|
| Robots コレクションインデックス(ワークフロー、ディレクティブ、移行ガイド) | https://www.mux.com/docs/guides/robots.txt |
| Robots の概要 | https://www.mux.com/docs/guides/robots.md |
| Robots ディレクティブのリファレンス | https://www.mux.com/docs/guides/robots-directives.md |
| サポート対象言語 | https://www.mux.com/docs/guides/robots-supported-languages.md |
| ベータ版(v0)から v1 への移行 | https://www.mux.com/docs/guides/robots-migrate-to-v1.md |
タスク別のガイドは https://www.mux.com/docs/guides/robots-<task>.md のパターンに従います。<task> に指定できる値は、analyze-structure、summarize、generate-chapters、generate-contextual-text、ask-questions、find-key-moments、find-best-thumbnails、generate-engagement-insights、moderate、generate-premium-captions、edit-captions、translate-captions、translate-audio です。シーンには analyze-structure を使用してください。
移行ガイドは https://www.mux.com/docs/guides/robots-migrate-<topic>-to-v1.md のパターンに従います。<topic> に指定できる値は directives、webhooks、typescript-sdk です。
API リファレンスと仕様
エンドポイント、パラメーター、Webhook の正確な形式については、説明ガイドより以下を優先してください。
| リソース | URL |
|---|---|
| Video API リファレンス | https://www.mux.com/docs/api-reference/video.txt |
| Data API リファレンス | https://www.mux.com/docs/api-reference/data.txt |
| System API リファレンス | https://www.mux.com/docs/api-reference/system.txt |
Robots v1 API リファレンス(完全な仕様に含まれる /robots/v0 パスは非推奨のベータ版です) | https://www.mux.com/docs/api-reference/robots.txt |
| API 仕様の全体(OpenAPI JSON) | https://www.mux.com/api-spec.json |
| Webhook 仕様(JSON) | https://www.mux.com/webhook-spec.json |
| Mux Player Web コンポーネント API | https://raw.githubusercontent.com/muxinc/elements/refs/heads/main/packages/mux-player/REFERENCE.md |
| Mux Player React コンポーネント API | https://raw.githubusercontent.com/muxinc/elements/refs/heads/main/packages/mux-player-react/REFERENCE.md |
これらのリソースはすべて、ドキュメントサイトからも確認できます。ドキュメントの各ページには「Docs for LLMs」へのリンク(https://www.mux.com/docs/core/llms-txt)があり、Mux の llms.txt ファイルと機械可読なバンドルについて説明する正式なページを参照できます。このスキルの URL リストが実際の内容と異なる場合は、このページを正としてください。
自己修復
ドキュメントの URL が 404 になる場合、ドキュメントが再編成された可能性があります。404 が 1 回出ただけで諦めないでください。mux docs find "<topic>" --agent を実行するか、https://www.mux.com/llms.txt を取得して検索し、現在のページ URL を確認してください。
最新状態の維持
- このスキルは
muxinc/skillsリポジトリから配布され、muxCLI に組み込まれています。CLI(brew upgrade mux/npm update -g @mux/cli)を更新すると組み込みスキルも更新され、mux skills updateを実行すると、インストール済みバージョンに合わせてローカルコピー(~/.claude/skillsを含む)がすべて更新されます。CLI のリリースから切り離されたスキルについては、mux@muxClaude Code プラグインをインストールするか、https://github.com/muxinc/skills から直接取得してください。 - CLI に組み込まれるのはスキルの手順ファイルのみで、ドキュメントの内容は含まれません。必ず上記のワークフローを使って、最新のドキュメントを取得してください。インストール済みバージョンで利用できる機能については、
mux skills --helpを確認してください。
ガードレール
- 回答の根拠としたドキュメントページの URL を明記してください。
- ネットワークを利用できない場合は、最新のドキュメントに照らして検証できなかったことを伝えてください。記憶に頼って API リクエストやレスポンスの形式を推測してはいけません。