スキル
cmux には、コーディングエージェントに cmux CLI 制御、ブラウザサーフェス、Markdown パネル、デバッグウィンドウ、リリースワークフローの使い方を教えるスキルが含まれています。
インストール
skills.sh を実行すると、リポジトリ内のスキルを Codex のスキルディレクトリへインストールできます。
curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/skills.sh | bash~/.codex/skills にインストールします。CODEX_HOME が設定されている場合は $CODEX_HOME/skills にインストールします。エージェントが別のディレクトリからスキルを読む場合は --dest を渡してください。チェックアウトからインストール
クローン済みの cmux チェックアウトでは、スクリプトはローカルの skills ディレクトリを使います。
./skills.sh
./skills.sh --list
./skills.sh --skill cmux --skill cmux-browser
./skills.sh --dest ~/.codex/skills
./skills.sh --dry-runスクリプトが GitHub からダウンロードする場合、--ref を使うと特定のブランチ、タグ、commit からインストールできます。
curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/skills.sh | bash -s -- --ref main含まれるスキル
各スキルには SKILL.md ファイル、任意の参照資料、agents/openai.yaml 配下の OpenAI メタデータファイルがあります。
| スキル | 用途 | 代表的なコマンド |
|---|---|---|
cmux Coreskills/cmux/SKILL.md | cmux CLI でウィンドウ、ワークスペース、ペイン、サーフェス、フォーカス、移動、並べ替え、ルーティングを制御します。 複数ペインの cmux レイアウト内で、エージェントが決定的な配置や移動を必要とするときに使います。 | cmux identify --json |
cmux Browserskills/cmux-browser/SKILL.md | snapshot 参照、DOM 操作、待機、スクリーンショット、セッション状態を使って cmux の webview サーフェスを自動化します。 別のブラウザ自動化ツールではなく、cmux 内で実行すべきブラウザタスクに使います。 | cmux browser surface:2 snapshot --interactive |
cmux Markdown Viewerskills/cmux-markdown/SKILL.md | Markdown ファイルを、ライブリロード付きの整形された cmux パネルで開きます。 作業中に計画、ドキュメント、メモ、タスクリストをターミナルの横に表示するときに使います。 | cmux markdown open plan.md |
cmux Debug Windowsskills/cmux-debug-windows/SKILL.md | Sidebar Debug、Background Debug、Menu Bar Extra Debug、コピー可能なデバッグ snapshot を管理します。 デバッグウィンドウ UI を調整するときや、タグ付きビルドからデバッグ設定を収集するときに使います。 | skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh |
cmux Releaseskills/release/SKILL.md | バージョン選択から changelog、リリース PR、タグ、アーティファクト確認まで、cmux のリリースワークフローを実行します。 cmux リリースを準備または作成するメンテナー向けです。 | ./scripts/bump-version.sh |
ヘルプメニュー
macOS の Help メニューはこのドキュメントサイドバーに合わせており、Skills も含みます。アプリからこのページを開くには、Help の Skills 項目を使います。
スキルの構成
メインの SKILL.md は簡潔に保ちます。詳しいコマンド表、スクリプト、再利用可能なテンプレートはスキルの横に置きます。
skills/<name>/SKILL.md
skills/<name>/agents/openai.yaml
skills/<name>/references/*.md
skills/<name>/scripts/*
skills/<name>/templates/*agents/openai.yaml を含めてください。