#スキル

cmux には、コーディングエージェントに cmux CLI 制御、current workspace 自動化、settings、customization、diagnostics、ブラウザサーフェス、Markdown パネルの使い方を教えるスキルが含まれています。

#インストール

標準の複数エージェント向けインストールには Vercel の skills CLI を使います。Codex の skills ディレクトリだけでよい場合は skills.sh も使えます。

Vercel skills でインストール

# Install all cmux skills
npx skills add manaflow-ai/cmux -g -y

# Or install just diagnostics
npx skills add manaflow-ai/cmux --skill cmux-diagnostics -g -y

skills.sh でインストール

curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/skills.sh | bash

デフォルトでは、skills.sh は ~/.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 Core `skills/cmux/SKILL.md`	cmux CLI でウィンドウ、ワークスペース、ペイン、サーフェス、フォーカス、移動、並べ替え、ルーティングを制御します。複数ペインの cmux レイアウト内で、エージェントが決定的な配置や移動を必要とするときに使います。	`cmux identify --json`
cmux Workspace `skills/cmux-workspace/SKILL.md`	現在の呼び出し元ワークスペース、呼び出し元サーフェス、ペイン、サイドバー metadata、socket context に自動化を限定します。ほかのワークスペースを邪魔せずに、エージェントがペイン追加、入力送信、状態確認、補助サーフェス作成を行うときに使います。	`cmux current-workspace --json`
cmux Settings `skills/cmux-settings/SKILL.md`	同梱 helper script で ~/.config/cmux/cmux.json を確認、編集、検証、open します。 appearance、sidebar、notification、browser、automation、shortcut の設定を JSON path で変更するときに使います。	`skills/cmux-settings/scripts/cmux-settings list-supported`
cmux Customization `skills/cmux-customization/SKILL.md`	cmux.json の action、プラスボタン動作、タブバー button、workspace layout、Dock control、Feed hook、sidebar setting、Command Palette entry、shortcut、Ghostty が扱う terminal preference を調整します。 worktree、複数 checkout、SSH session、dev tool、project layout を、ユーザーが望む UI entrypoint から開けるようにするときに使います。	`cmux reload-config`
cmux Diagnostics `skills/cmux-diagnostics/SKILL.md`	cmux CLI、socket access、hook、session restore、settings、agent binary を、support-safe に確認します。 notification、hook、restore、automation が期待どおり動かないときに使います。	`skills/cmux-diagnostics/scripts/cmux-diagnostics`
cmux Browser `skills/cmux-browser/SKILL.md`	snapshot 参照、DOM 操作、待機、スクリーンショット、セッション状態を使って cmux の webview サーフェスを自動化します。別のブラウザ自動化ツールではなく、cmux 内で実行すべきブラウザタスクに使います。	`cmux browser surface:2 snapshot --interactive`
cmux Markdown Viewer `skills/cmux-markdown/SKILL.md`	Markdown ファイルを、ライブリロード付きの整形された cmux パネルで開きます。作業中に計画、ドキュメント、メモ、タスクリストをターミナルの横に表示するときに使います。	`cmux markdown open plan.md`

#スキルが扱う範囲

トップレベルの SKILL.md は短く保ちます。詳しいコマンド情報は、各スキルの横にある references、scripts、templates に置きます。

スキル	範囲	参照資料の内容
cmux Core `cmux`	ウィンドウ、ワークスペース、ペイン、サーフェス、フォーカス、移動、並べ替え、split-off、注意喚起フラッシュのトポロジー制御です。	ハンドル構文、呼び出し元ターゲティング、ウィンドウとワークスペースのライフサイクル、ペインとサーフェスのルーティング、trigger flash、ヘルスチェックです。
cmux Workspace `cmux-workspace`	呼び出し元 context、追加型ペイン、補助サーフェス、sidebar metadata、入力、socket 選択に関する current workspace 自動化ルールです。	context、window、workspace、pane、surface、input、sidebar state、notification、docs、tagged reload を扱う workspace command reference です。
cmux Settings `cmux-settings`	cmux.json の読み書き、key lookup、JSONC parsing、安全な atomic update、validation、editor open、shortcut binding 編集です。	生成済み settings key list、shortcut action id、schema URL、supported path 検出、同梱 cmux-settings helper です。
cmux Customization `cmux-customization`	cmux.json settings、action、command、workspace layout、プラスボタンの click と右クリック menu、surface tab bar button、Dock control、Feed と notification hook、sidebar metadata、Command Palette entry、shortcut、Ghostty config との境界をまたぐ end-user customization です。	設定面の選択、customize できる範囲、global と project-local の使い分け、action 例、プラスボタン wiring、tab bar button 例、Dock 例、Feed hook、workspace layout 例、reload 手順、validation rule、安全制約です。
cmux Diagnostics `cmux-diagnostics`	CLI 到達性、socket access、cmux environment、settings validation、hook installation marker、session store、auto-resume setting、対応 agent binary の read-only health check です。	同梱の support-safe diagnostic script、hook setup command、session restore の解釈、notification check、機密ファイルを伏せるルールです。
cmux Browser `cmux-browser`	cmux の webview サーフェス内でのブラウザ自動化です。ナビゲーション、DOM 操作、待機、状態取得、スクリーンショット、snapshot を扱います。	コマンド対応表、snapshot 参照のライフサイクル、認証、セッション永続化、動画の現状、プロキシ動作、再利用可能な自動化テンプレートです。
cmux Markdown Viewer `cmux-markdown`	ターミナルの横に置けて、ファイル変更に合わせて再読み込みされる整形済み Markdown パネルです。	コマンド構文、ルーティングオプション、ライブリロード動作、atomic なファイル置換、Markdown レンダリング範囲です。

#Customization examples library

cmux Customization を使って agent に適用を依頼できる、再利用可能な workflow pattern です。

例	カスタマイズ対象	向いている用途
Worktree agents `worktree-agents`	プラスボタン click、プラスボタン右クリック menu、Command Palette、workspace layout	専用 worktree や checkout を開き、Codex、Claude、SSH、補助 terminal を並べる用途です。
Full-stack dev `full-stack-dev`	Workspace command、browser preview、Dock control	frontend、backend、test、log、preview pane を同じ再現可能な layout で起動します。
SSH devbox `ssh-devbox`	Workspace command、remote terminal、browser surface	remote 環境へ接続しつつ、local preview、note、navigation を cmux 内に保ちます。
Review PR `review-pr`	Workspace command、browser surface、markdown または terminal notes	GitHub status、pull request、review note を 1 つの workspace で開きます。
Docs workspace `docs-workspace`	Workspace command、markdown panel、browser preview	rendered page、local dev server、source note を見ながら documentation を編集します。
CI watch `ci-watch`	Dock control、Feed TUI、notification hook	main workspace を邪魔せずに GitHub Actions、CircleCI、release monitor、agent hook event を監視します。
Quick agent buttons `quick-agent-buttons`	Surface tab bar button、action、Command Palette entry	built-in tab button を残しつつ、Codex、Claude、custom agent の one-click launcher を追加します。

詳しい snippet は skills/cmux-customization/references/examples.md にあります。agent は examples-library pattern が必要なときだけそのファイルを読み込みます。

プロンプト例

$cmux-customization を使って worktree-agents example を設定してください。
$cmux-customization を使って、Dock control 付きの project-local full-stack-dev layout を作成してください。
$cmux-customization を使って Codex と Claude の quick-agent-buttons を追加してください。

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 を含めてください。

#今後あると便利なスキル

現在インストールされるスキルより先に広げるなら、次の候補が有用です。

スキル案	用途	有用な理由
cmux SSH `cmux-ssh`	リモートワークスペース、SSH URL 起動、リモートネットワーク経由のブラウザルーティング、再接続動作を扱います。	リモートセッションは cmux の主要な surface で、ローカル terminal workflow と異なる挙動があります。
cmux Cloud VM `cmux-cloud-vm`	Cloud VM の create、attach、exec、SSH endpoint、billing、provider トラブルシュートを扱います。	Cloud VM 作業は web app、database、provider API、smoke test をまたぎます。
cmux Vault `cmux-vault`	secret を prompt に漏らさず、vault-backed agent configuration、credential、restore behavior を管理します。	Vault workflow は secret と agent startup に関わるため、通常の settings より厳密な扱いが必要です。

今後のスキルは、実際のコマンド列を持つ反復可能なワークフローに絞ってください。製品ドキュメントを言い換えるだけなら、スキルではなくドキュメントに追加します。