# ทักษะ

cmux มาพร้อมทักษะที่สอน coding agents ให้ใช้การควบคุม cmux CLI, พื้นผิวเบราว์เซอร์, พาเนล Markdown, หน้าต่าง debug และ workflow สำหรับ release

## ติดตั้ง

รัน `skills.sh` เพื่อติดตั้งทักษะที่อยู่ใน repo ลงในไดเรกทอรีทักษะของ Codex

Install with 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
```

Install with skills.sh

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

โดยค่าเริ่มต้น สคริปต์จะติดตั้งที่ `~/.codex/skills` หรือ `$CODEX_HOME/skills` เมื่อกำหนด CODEX\_HOME ไว้ ส่ง `--dest` เมื่อ agent ของคุณอ่านทักษะจากไดเรกทอรีอื่น

### ติดตั้งจาก checkout

จาก cmux checkout ที่ clone ไว้ สคริปต์จะใช้ไดเรกทอรี skills ในเครื่อง

คำสั่งในเครื่อง

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

ใช้ --ref เพื่อติดตั้งจาก branch, tag หรือ commit ที่เจาะจง เมื่อสคริปต์ดาวน์โหลดจาก GitHub

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

## ทักษะที่รวมไว้

แต่ละทักษะมีไฟล์ SKILL.md, เอกสารอ้างอิงเสริม และไฟล์ metadata ของ OpenAI ใต้ agents/openai.yaml

| ทักษะ | การใช้งาน | คำสั่งทั่วไป |
| --- | --- | --- |
| **cmux Core**
`skills/cmux/SKILL.md` |
ควบคุมหน้าต่าง workspace, pane, surface, focus, การย้าย, การจัดลำดับใหม่ และ routing ด้วย cmux CLI

ใช้เมื่อ agent ต้องการการจัดวางหรือการนำทางแบบกำหนดแน่นอนใน layout cmux แบบหลาย pane

 | `cmux identify --json` |
| **cmux Workspace**
`skills/cmux-workspace/SKILL.md` |

Keeps automation scoped to the current caller workspace, caller surface, panes, sidebar metadata, and socket context.

Use it when an agent should add panes, send input, inspect state, or open helper surfaces without disrupting another workspace.

 | `cmux current-workspace --json` |
| **cmux Settings**
`skills/cmux-settings/SKILL.md` |

Inspects, edits, validates, and opens ~/.config/cmux/cmux.json with a bundled helper script.

Use it when changing appearance, sidebar, notification, browser, automation, or shortcut settings by JSON path.

 | `skills/cmux-settings/scripts/cmux-settings list-supported` |
| **cmux Customization**
`skills/cmux-customization/SKILL.md` |

Customizes cmux.json actions, plus-button behavior, tab bar buttons, workspace layouts, Dock controls, Feed hooks, sidebar settings, Command Palette entries, shortcuts, and Ghostty-owned terminal preferences.

Use it to make cmux open a user's worktrees, multiple checkouts, SSH sessions, dev tools, or project layout from the exact UI entrypoints they want.

 | `cmux reload-config` |
| **cmux Diagnostics**
`skills/cmux-diagnostics/SKILL.md` |

Runs support-safe checks for cmux CLI health, socket access, hooks, session restore, settings, and agent binaries.

Use it when notifications, hooks, restore, or automation are not behaving as expected.

 | `skills/cmux-diagnostics/scripts/cmux-diagnostics` |
| **cmux Browser**
`skills/cmux-browser/SKILL.md` |

ทำงานอัตโนมัติกับพื้นผิว webview ของ cmux ด้วย snapshot refs, DOM actions, waits, screenshots และ session state

ใช้สำหรับงานเบราว์เซอร์ที่ควรรันภายใน cmux แทนเครื่องมือ browser automation แยกต่างหาก

 | `cmux browser surface:2 snapshot --interactive` |
| **cmux Markdown Viewer**
`skills/cmux-markdown/SKILL.md` |

เปิดไฟล์ Markdown ในพาเนล cmux ที่จัดรูปแบบแล้วพร้อม live reload

ใช้เพื่อแสดงแผน เอกสาร โน้ต และรายการงานข้าง terminal ระหว่างทำงาน

 | `cmux markdown open plan.md` |

## What the skills cover

The top-level SKILL.md files stay short. Deeper command details live in references, scripts, and templates next to each skill.

| ทักษะ | Scope | Reference coverage |
| --- | --- | --- |
| **cmux Core**
`cmux` | Topology control for windows, workspaces, panes, surfaces, focus, moves, reorders, split-off flows, and attention flashes. | Handle syntax, caller targeting, window and workspace lifecycle, pane and surface routing, trigger flash, and health checks. |
| **cmux Workspace**
`cmux-workspace` | Current-workspace automation rules for caller context, additive panes, helper surfaces, sidebar metadata, input, and socket selection. | Workspace command reference covering context, windows, workspaces, panes, surfaces, input, sidebar state, notifications, docs, and tagged reloads. |
| **cmux Settings**
`cmux-settings` | cmux.json settings reads and writes, key lookup, JSONC parsing, safe atomic updates, validation, editor opening, and shortcut binding edits. | Generated settings key list, shortcut action ids, schema URL, supported path detection, and the bundled cmux-settings helper. |
| **cmux Customization**
`cmux-customization` | End-user customization across cmux.json settings, actions, commands, workspace layouts, plus-button click and right-click menus, surface tab bar buttons, Dock controls, Feed and notification hooks, sidebar metadata, Command Palette entries, shortcuts, and Ghostty config boundaries. | Config-surface selection, what can be customized, global versus project-local scope, action examples, plus-button wiring, tab bar button examples, Dock examples, Feed hooks, workspace layout examples, reload steps, validation rules, and safety constraints. |
| **cmux Diagnostics**
`cmux-diagnostics` | Read-only health checks for CLI reachability, socket access, cmux environment, settings validation, hook installation markers, session stores, auto-resume settings, and supported agent binaries. | Bundled support-safe diagnostic script, hook setup commands, session restore interpretation, notification checks, and rules for redacting sensitive files. |
| **cmux Browser**
`cmux-browser` | Browser automation inside cmux webview surfaces, including navigation, DOM actions, waits, state capture, screenshots, and snapshots. | Command mapping, snapshot ref lifecycle, authentication, session persistence, video status, proxy behavior, and reusable automation templates. |
| **cmux Markdown Viewer**
`cmux-markdown` | Formatted markdown panels that live beside terminals and reload as files change. | Command syntax, routing options, live reload behavior, atomic file replacement, and markdown rendering coverage. |

## Customization examples library

These are reusable workflow patterns that a user can ask an agent to apply with cmux Customization.

| Example | Customizes | Good for |
| --- | --- | --- |
| **Worktree agents**
`worktree-agents` | Plus-button click, plus-button right-click menu, Command Palette, workspace layout | Opening a dedicated worktree or checkout with paired Codex, Claude, SSH, or helper terminals. |
| **Full-stack dev**
`full-stack-dev` | Workspace command, browser preview, Dock controls | Starting frontend, backend, tests, logs, and preview panes in the same repeatable layout. |
| **SSH devbox**
`ssh-devbox` | Workspace command, remote terminal, browser surface | Connecting to a remote environment while keeping local previews, notes, and navigation in cmux. |
| **Review PR**
`review-pr` | Workspace command, browser surface, markdown or terminal notes | Opening GitHub status, the pull request, and review notes in a single workspace. |
| **Docs workspace**
`docs-workspace` | Workspace command, markdown panel, browser preview | Editing documentation with the rendered page, local dev server, and source notes visible. |
| **CI watch**
`ci-watch` | Dock controls, Feed TUI, notification hooks | Watching GitHub Actions, CircleCI, release monitors, and agent hook events without losing the main workspace. |
| **Quick agent buttons**
`quick-agent-buttons` | Surface tab bar buttons, actions, Command Palette entries | Adding one-click Codex, Claude, or custom-agent launchers while keeping built-in tab buttons visible. |

Detailed snippets live in `skills/cmux-customization/references/examples.md`. Agents load that file only when an examples-library pattern is needed.

Example prompts

```
Use $cmux-customization to set up the worktree-agents example.
Use $cmux-customization to create a project-local full-stack-dev layout with Dock controls.
Use $cmux-customization to add quick-agent-buttons for Codex and Claude.
```

## เมนู Help

เมนู macOS **Help** สะท้อน sidebar เอกสารนี้และมี **Skills** ใช้รายการ Skills ใน Help เพื่อเปิดหน้านี้จากแอป

## โครงสร้างทักษะ

ให้ SKILL.md หลักกระชับ วางตารางคำสั่งเชิงลึก สคริปต์ และ template ที่ใช้ซ้ำได้ไว้ข้างทักษะ

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

เมื่อเพิ่มทักษะใหม่ ให้ใส่ `agents/openai.yaml` เพื่อให้ installer แสดงชื่อที่ชัดเจน คำอธิบายสั้น และ prompt เริ่มต้น

## Suggested future skills

These are good candidates if the skill set grows beyond the current installed list.

| Skill idea | Use case | Why it helps |
| --- | --- | --- |
| **cmux SSH**
`cmux-ssh` | Drive remote workspaces, SSH URL launches, browser routing through remote networks, and reconnect behavior. | Remote sessions are a major cmux surface with behavior that differs from local terminal workflows. |
| **cmux Cloud VM**
`cmux-cloud-vm` | Operate Cloud VM create, attach, exec, SSH endpoint, billing, and provider troubleshooting flows. | Cloud VM work crosses the web app, database, provider APIs, and smoke tests. |
| **cmux Vault**
`cmux-vault` | Manage vault-backed agent configuration, credentials, and restore behavior without leaking secrets into prompts. | Vault workflows need stricter handling than normal settings because they affect secrets and agent startup. |

Keep future skills focused on repeatable workflows with real command sequences. If a skill would only restate product docs, add it to docs instead.

## เอกสารที่เกี่ยวข้อง

-   [การทำงานอัตโนมัติของเบราว์เซอร์](https://cmux.com/th/docs/browser-automation)
-   [เอกสารอ้างอิง CLI](https://cmux.com/th/docs/api)
-   [คำสั่งกำหนดเอง](https://cmux.com/th/docs/custom-commands)

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

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