Habilidades

O cmux inclui habilidades que ensinam agentes de código a usar o controle por cmux CLI, superfícies de navegador, painéis Markdown, janelas de depuração e o fluxo de release.

Instalar

Execute skills.sh para instalar as habilidades versionadas no diretório de habilidades do Codex.

Instalar do GitHub

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

Por padrão, o script instala em ~/.codex/skills, ou em $CODEX_HOME/skills quando CODEX_HOME está definido. Passe --dest quando seu agente lê habilidades de outro diretório.

Instalar a partir de um checkout

A partir de um checkout clonado do cmux, o script usa o diretório local de skills.

Comandos locais

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

Use --ref para instalar a partir de uma branch, tag ou commit específico quando o script baixa do GitHub.

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

Habilidades incluídas

Cada habilidade tem um arquivo SKILL.md, referências opcionais e um arquivo de metadados da OpenAI em agents/openai.yaml.

Habilidade	Uso	Comando típico
cmux Core `skills/cmux/SKILL.md`	Controla janelas, workspaces, painéis, superfícies, foco, movimentos, reordenação e roteamento com a cmux CLI. Use quando um agente precisa de posicionamento ou navegação determinística em um layout cmux com vários painéis.	`cmux identify --json`
cmux Browser `skills/cmux-browser/SKILL.md`	Automatiza superfícies webview do cmux com referências de snapshot, ações DOM, esperas, capturas de tela e estado de sessão. Use para tarefas de navegador que devem rodar dentro do cmux em vez de uma ferramenta separada de automação de navegador.	`cmux browser surface:2 snapshot --interactive`
cmux Markdown Viewer `skills/cmux-markdown/SKILL.md`	Abre arquivos Markdown em um painel cmux formatado com recarregamento ao vivo. Use para mostrar planos, documentação, notas e listas de tarefas ao lado do terminal enquanto o trabalho acontece.	`cmux markdown open plan.md`
cmux Debug Windows `skills/cmux-debug-windows/SKILL.md`	Gerencia Sidebar Debug, Background Debug, Menu Bar Extra Debug e snapshots de depuração copiáveis. Use ao iterar na interface de janelas de depuração ou coletar configuração de depuração de um build com tag.	`skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh`
cmux Release `skills/release/SKILL.md`	Executa o fluxo de release do cmux desde a seleção de versão até changelog, release PR, tag e verificações de artefatos. Use para maintainers preparando ou publicando um release do cmux.	`./scripts/bump-version.sh`

Menu Ajuda

O menu Help do macOS espelha esta barra lateral de documentação e inclui Skills. Use o item Skills em Help para abrir esta página pelo app.

Estrutura da habilidade

Mantenha o SKILL.md principal conciso. Coloque tabelas de comandos mais detalhadas, scripts e modelos reutilizáveis ao lado da habilidade.

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

Ao adicionar uma nova habilidade, inclua agents/openai.yaml para que o instalador exponha um nome claro, uma descrição curta e um prompt padrão.