技能

cmux 隨附的技能會教 coding agents 使用 cmux CLI 控制、瀏覽器介面、Markdown 面板、偵錯視窗和發行流程。

安裝

執行 skills.sh，將 repo 中的技能安裝到你的 Codex 技能目錄。

從 GitHub 安裝

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

預設情況下，script 會安裝到 ~/.codex/skills，當設定 CODEX_HOME 時則安裝到 $CODEX_HOME/skills。如果你的 agent 從其他目錄讀取技能，請傳入 --dest。

在 clone 的 cmux checkout 中，script 會使用本機 skills 目錄。

本機指令

./skills.sh
./skills.sh --list
./skills.sh --skill cmux --skill cmux-browser
./skills.sh --dest ~/.codex/skills
./skills.sh --dry-run

當 script 從 GitHub 下載時，使用 --ref 可從指定 branch、tag 或 commit 安裝。

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

每個技能都有 SKILL.md 檔案、選用參考資料，以及 agents/openai.yaml 下的 OpenAI metadata 檔案。

技能	用途	常用指令
cmux Core `skills/cmux/SKILL.md`	透過 cmux CLI 控制視窗、workspace、pane、surface、focus、移動、重新排序和 routing。當 agent 需要在多 pane 的 cmux layout 中進行確定性的放置或導覽時使用。	`cmux identify --json`
cmux Browser `skills/cmux-browser/SKILL.md`	使用 snapshot 參照、DOM 動作、等待、螢幕截圖和 session state 來自動化 cmux webview 介面。用於應在 cmux 內執行的瀏覽器任務，而不是使用獨立的瀏覽器自動化工具。	`cmux browser surface:2 snapshot --interactive`
cmux Markdown Viewer `skills/cmux-markdown/SKILL.md`	在帶 live reload 的格式化 cmux panel 中開啟 Markdown 檔案。用於在工作時把計畫、文件、筆記和任務清單顯示在終端機旁邊。	`cmux markdown open plan.md`
cmux Debug Windows `skills/cmux-debug-windows/SKILL.md`	管理 Sidebar Debug、Background Debug、Menu Bar Extra Debug 和可複製的 debug snapshot。在迭代 debug 視窗 UI 或從帶 tag 的 build 收集 debug 設定時使用。	`skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh`
cmux Release `skills/release/SKILL.md`	執行 cmux release workflow，從選擇版本到 changelog、release PR、tag 和 artifact 檢查。供準備或發布 cmux release 的 maintainers 使用。	`./scripts/bump-version.sh`

macOS Help 選單會鏡像這個文件側邊欄，並包含 Skills。在 Help 中使用 Skills 項目即可從 app 開啟此頁面。

保持主要 SKILL.md 簡潔。更深入的指令表、scripts 和可重用 templates 應放在技能旁邊。

skills/<name>/SKILL.md
skills/<name>/agents/openai.yaml
skills/<name>/references/*.md
skills/<name>/scripts/*
skills/<name>/templates/*

新增技能時，請包含 agents/openai.yaml，讓 installer 顯示清楚名稱、短描述和預設 prompt。