Competenze

cmux include competenze che insegnano agli agenti di codice a usare il controllo cmux CLI, le superfici del browser, i pannelli Markdown, le finestre di debug e il workflow di release.

Installa

Esegui skills.sh per installare le competenze versionate nella directory delle competenze Codex.

Installa da GitHub

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

Per impostazione predefinita, lo script installa in ~/.codex/skills, oppure in $CODEX_HOME/skills quando CODEX_HOME è impostato. Passa --dest quando il tuo agente legge le competenze da un’altra directory.

Installa da un checkout

Da un checkout cmux clonato, lo script usa la directory locale delle competenze.

Comandi locali

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

Usa --ref per installare da un branch, tag o commit specifico quando lo script scarica da GitHub.

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

Competenze incluse

Ogni competenza ha un file SKILL.md, riferimenti facoltativi e un file di metadati OpenAI in agents/openai.yaml.

Competenza	Uso	Comando tipico
cmux Core `skills/cmux/SKILL.md`	Controlla finestre, workspace, riquadri, superfici, focus, spostamenti, riordino e routing con la cmux CLI. Usala quando un agente ha bisogno di posizionamento o navigazione deterministica in un layout cmux con più riquadri.	`cmux identify --json`
cmux Browser `skills/cmux-browser/SKILL.md`	Automatizza le superfici webview di cmux con riferimenti snapshot, azioni DOM, attese, screenshot e stato della sessione. Usala per attività del browser che devono essere eseguite dentro cmux invece che in uno strumento separato di automazione del browser.	`cmux browser surface:2 snapshot --interactive`
cmux Markdown Viewer `skills/cmux-markdown/SKILL.md`	Apre file Markdown in un pannello cmux formattato con ricaricamento live. Usala per mostrare piani, documentazione, note ed elenchi di attività accanto al terminale durante il lavoro.	`cmux markdown open plan.md`
cmux Debug Windows `skills/cmux-debug-windows/SKILL.md`	Gestisce Sidebar Debug, Background Debug, Menu Bar Extra Debug e snapshot di debug copiabili. Usala quando iteri sull’interfaccia delle finestre di debug o raccogli configurazione di debug da una build taggata.	`skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh`
cmux Release `skills/release/SKILL.md`	Esegue il workflow di release cmux dalla selezione della versione a changelog, release PR, tag e controlli sugli artefatti. Usala per maintainer che preparano o pubblicano una release cmux.	`./scripts/bump-version.sh`

Menu Aiuto

Il menu macOS Help rispecchia questa barra laterale della documentazione e include Skills. Usa la voce Skills in Help per aprire questa pagina dall’app.

Struttura delle competenze

Mantieni conciso il file SKILL.md principale. Metti tabelle di comandi più dettagliate, script e modelli riutilizzabili accanto alla competenza.

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

Quando aggiungi una nuova competenza, includi agents/openai.yaml così l’installer espone un nome chiaro, una descrizione breve e un prompt predefinito.