Menú
cmuxターミナル内での操作スキル。CMUX_*環境変数が存在する場合、cmuxのCLIコマンドを使う前に必ずこのスキルを読む。ペイン分割、コマンド送信、ブラウザ自動化、通知、Markdown/diffのプレビュー、cmux設定の変更など、cmux操作全般で使用する。「別ペインで開いて」「横に表示して」「ブラウザで確認して」「プレビューして」「diffを見せて」などのときにも使用する。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
Preview generated Markdown (plans, design notes, reviews, research reports) in the user's browser. Use when sharing long, structured output — documents with headings, tables, code blocks, or Mermaid diagrams — that is hard to read in the terminal.
バグを場当たり修正せず、根本原因を特定してから直すためのデバッグ手順。再現→切り分け→根本原因→検証の順で進める。バグ・デバッグ・原因不明・落ちる・再現しない・CIが赤・flakyなテスト・想定外の挙動に遭遇したときに使用する。「デバッグして」「なぜ落ちる」「原因を調べて」などのときにも使用する。
「完了」「直した」と報告する前に、実際に実行・テスト・観察して根拠を確かめるための検証ルール。修正・実装・リファクタが終わって成功を報告しようとするとき、変更が意図どおり動くと主張する前に使用する。「できた」「直した」「実装した」「修正完了」と言おうとしているときに使用する。
日本語の技術文書を書いた後・公開前にレビューし、重要度つきの指摘レポートを出すスキル（ファイルは変更しない）。日本語の文章品質・AI Slop・表記の慣習・整合性・独自性・語り口を点検する。媒体非依存の汎用版で、ブログMDXなどプロジェクト固有のレビュースキルがあればそちらを優先・併用する。
新しい k8o プロジェクト/リポジトリを立ち上げる一連の手順。@k8o/create で雛形生成 → GitHub リポジトリ作成 → ブランチ保護 ruleset とマージ設定 → リリース用 secret(fnox経由) → npm 初回 publish と Renovate 有効化まで。「新しい repo を作る」「プロジェクトを立ち上げる」「リポジトリの初期設定をする」ときに使用する。
Conventional Commitsに従ったアトミックなgitコミットを作成する。変更を論理単位に分割し、独立してrevert可能なコミットを生成する。コードの変更をコミットしたいとき、コミットメッセージを作りたいときに使用する。
| name | cmux |
| description | cmuxターミナル内での操作スキル。CMUX_*環境変数が存在する場合、cmuxのCLIコマンドを使う前に必ずこのスキルを読む。ペイン分割、コマンド送信、ブラウザ自動化、通知、Markdown/diffのプレビュー、cmux設定の変更など、cmux操作全般で使用する。「別ペインで開いて」「横に表示して」「ブラウザで確認して」「プレビューして」「diffを見せて」などのときにも使用する。 |
cmuxはAIコーディングエージェント向けのmacOSネイティブターミナル。CMUX_SOCKET_PATHかCMUX_WORKSPACE_IDが設定されていればcmux内で実行中。CLIはcmuxが自セッションのPATHに自動で通している。
cmux identify --json # 現在の位置（window, workspace, pane, surface）
cmux tree # トポロジー全体
cmux capabilities # このバージョンで使える機能
階層: Window → Workspace（サイドバータブ） → Pane（分割） → Surface（ペイン内のタブ。ターミナル/ブラウザ）
Ref形式: workspace:2, pane:1, surface:7（UUIDより優先して使う）。フラグ省略時はCMUX_WORKSPACE_ID / CMUX_SURFACE_ID（＝呼び出し元）がデフォルトになる。
ユーザーは別のworkspaceや別アプリを見ていることがある。フォーカスを奪う操作はクリックと同等のユーザー操作なので、明示的に頼まれない限り呼ばない: select-workspace / focus-pane / focus-panel。
レイアウトは1コマンドで完結させ、--focus falseが使えるコマンドでは必ず付ける:
# ペイン作成と中身の指定を1回で行う（作ってから移動・フォーカスの連鎖をしない）
cmux new-pane --type terminal --direction down --focus false
cmux new-pane --type browser --direction right --url http://localhost:3000 --focus false
# 既に補助ペインがあるなら、ペインを増やさずそこにsurfaceを足す
cmux list-panes --json
cmux new-surface --pane pane:2 --type terminal --focus false
補助的な出力（プレビュー、ログ、一時シェル）は呼び出し元の右隣の補助ペイン1つに集約し、繰り返しの「開いて」はそのペインのタブとして追加する。
長時間タスクやサブエージェントの隔離実行に使う。数秒で終わるコマンドには不要。
cmux send --surface surface:5 "command\n" # \nで実行される
cmux send-key --surface surface:5 <key>
cmux read-screen --surface surface:5 --lines 50 # --scrollbackで履歴も読む
基本フロー: open → get urlで確認 → wait → snapshot（ref取得） → refで操作 → 再snapshot
cmux --json browser open https://example.com # 返ってきたsurface refを以後使う
cmux browser surface:7 get url # 空/about:blankならwaitせず先にnavigate
cmux browser surface:7 wait --load-state complete --timeout-ms 15000
cmux browser surface:7 snapshot --interactive # 常に--interactiveでelement refを取得
cmux browser surface:7 click e2 --snapshot-after
cmux browser surface:7 fill e3 "text" # 空文字でクリア
cmux browser surface:7 select e7 "value"
cmux browser surface:7 press Enter
cmux browser surface:7 wait --selector "#loaded" --timeout-ms 10000
cmux browser surface:7 wait --text "Success"
cmux browser surface:7 wait --url-contains "/dashboard"
cmux browser surface:7 get text e3
cmux browser surface:7 eval 'document.title'
cmux browser surface:7 screenshot --out shot.png
snapshot --interactiveやevalがjs_errorを返すページではget text body / get html bodyにフォールバックする。not_supported。高レベルコマンド（click/fill/wait/snapshot）で代替する。計画やレポートをターミナル横に整形表示する。ファイル変更で自動再描画されるため、進捗を追記していく使い方ができる。
cmux markdown open plan.md
git diffやパッチを専用ビューアのペインで開く。ユーザーは変更行にレビューコメントを付けてTextBox経由でエージェントに渡せるので、変更を見せてフィードバックをもらう場面で使う。
cmux diff # リポジトリのdiffを開く（ベースはスマート推定）
git diff main... | cmux diff # 任意のパッチをstdinから渡す
cmux diff --layout split # unified | split
| 用途 | コマンド |
|---|---|
| cmux内の通知（ペインリング） | cmux notify --title "T" --body "B" |
| システム通知（他アプリにいるとき） | osascript -e 'display notification "B" with title "T"' |
| 注意を引くフラッシュ | cmux trigger-flash --surface surface:7 |
長時間タスクではサイドバーに進捗を出せる:
cmux set-status build "compiling" --color "#5eead4"
cmux set-progress 0.4 --label "3/7 done"
cmux log --level info -- "step 3 finished"
cmux clear-status build && cmux clear-progress
~/.config/ghostty/config~/.config/cmux/cmux.json（JSONC可）dot_config/ghostty/configとdot_config/cmux/cmux.json）。~/.configを直接編集するとchezmoi applyで戻るので、dotfiles側を編集して適用する。cmux reload-configでも両方を再読込できる）。アプリの再起動は不要。cmux docs settingsが出力する。