스킬

cmux에는 코딩 에이전트가 cmux CLI 제어, 브라우저 표면, Markdown 패널, 디버그 창, 릴리스 워크플로를 사용하는 방법을 익히도록 돕는 스킬이 포함되어 있습니다.

설치

skills.sh를 실행하여 저장소에 포함된 스킬을 Codex 스킬 디렉터리에 설치합니다.

GitHub에서 설치
curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux/main/skills.sh | bash
기본적으로 스크립트는 ~/.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에서 다운로드할 때 특정 브랜치, 태그 또는 commit에서 설치하려면 --ref를 사용하세요.

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 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
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

버전 선택부터 changelog, 릴리스 PR, 태그, 아티팩트 확인까지 cmux 릴리스 워크플로를 실행합니다.

cmux 릴리스를 준비하거나 자르는 maintainers가 사용합니다.

./scripts/bump-version.sh

Help 메뉴

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을 포함하면 설치 프로그램이 명확한 이름, 짧은 설명, 기본 프롬프트를 표시할 수 있습니다.

관련 문서