# スキル

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 より厳密な扱いが必要です。 |

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

## 関連ドキュメント

-   [ブラウザ自動化](https://cmux.com/ja/docs/browser-automation)
-   [CLI リファレンス](https://cmux.com/ja/docs/api)
-   [カスタムコマンド](https://cmux.com/ja/docs/custom-commands)

Canonical: https://cmux.com/ja/docs/skills

Documentation index: https://cmux.com/llms.txt