Навыки

cmux поставляется с навыками, которые учат кодовых агентов использовать управление cmux CLI, браузерные поверхности, панели Markdown, окна отладки и релизный workflow.

Установка

Запустите skills.sh, чтобы установить навыки из репозитория в каталог навыков Codex.

Установка из GitHub

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

По умолчанию скрипт устанавливает в ~/.codex/skills или в $CODEX_HOME/skills, если задан CODEX_HOME. Передайте --dest, если ваш агент читает навыки из другого каталога.

Установка из checkout

В клонированном checkout cmux скрипт использует локальный каталог skills.

Локальные команды

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

Используйте --ref, чтобы установить из конкретной ветки, тега или commit, когда скрипт скачивает с GitHub.

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

Включенные навыки

У каждого навыка есть файл SKILL.md, необязательные справочные материалы и файл метаданных OpenAI в agents/openai.yaml.

Навык	Назначение	Типичная команда
cmux Core `skills/cmux/SKILL.md`	Управляет окнами, workspace, панелями, поверхностями, фокусом, перемещением, переупорядочиванием и маршрутизацией через cmux CLI. Используйте, когда агенту нужны детерминированное размещение или навигация в многопанельном макете cmux.	`cmux identify --json`
cmux Browser `skills/cmux-browser/SKILL.md`	Автоматизирует webview-поверхности cmux с помощью snapshot-ссылок, DOM-действий, ожиданий, скриншотов и состояния сессии. Используйте для браузерных задач, которые должны выполняться внутри cmux, а не в отдельном инструменте автоматизации браузера.	`cmux browser surface:2 snapshot --interactive`
cmux Markdown Viewer `skills/cmux-markdown/SKILL.md`	Открывает Markdown-файлы в отформатированной панели cmux с live reload. Используйте, чтобы показывать планы, документацию, заметки и списки задач рядом с терминалом во время работы.	`cmux markdown open plan.md`
cmux Debug Windows `skills/cmux-debug-windows/SKILL.md`	Управляет Sidebar Debug, Background Debug, Menu Bar Extra Debug и копируемыми отладочными snapshot. Используйте при итерациях над UI отладочных окон или сборе отладочной конфигурации из тегированного билда.	`skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh`
cmux Release `skills/release/SKILL.md`	Запускает релизный workflow cmux от выбора версии через changelog, release PR, tag и проверки артефактов. Используйте для maintainers, которые готовят или выпускают релиз cmux.	`./scripts/bump-version.sh`

Меню справки

Меню macOS Help повторяет эту боковую панель документации и включает Skills. Используйте пункт Skills в Help, чтобы открыть эту страницу из приложения.

Структура навыка

Держите основной SKILL.md кратким. Более подробные таблицы команд, скрипты и переиспользуемые шаблоны размещайте рядом с навыком.

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

Добавляя новый навык, включайте agents/openai.yaml, чтобы установщик показывал понятное имя, короткое описание и prompt по умолчанию.