Habilidades

cmux incluye habilidades que enseñan a los agentes de código a usar el control por cmux CLI, superficies de navegador, paneles Markdown, ventanas de depuración y el flujo de releases.

Instalar

Ejecuta skills.sh para instalar las habilidades incluidas en el repositorio en tu directorio de habilidades de Codex.

Instalar desde GitHub

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

De forma predeterminada, el script instala en ~/.codex/skills, o en $CODEX_HOME/skills cuando CODEX_HOME está definido. Pasa --dest si tu agente lee habilidades desde otro directorio.

Instalar desde un checkout

Desde un checkout clonado de cmux, el script usa el directorio local de habilidades.

Comandos locales

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

Usa --ref para instalar desde una rama, etiqueta o commit específico cuando el script descarga desde GitHub.

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

Habilidades incluidas

Cada habilidad tiene un archivo SKILL.md, referencias opcionales y un archivo de metadatos de OpenAI en agents/openai.yaml.

Habilidad	Uso	Comando típico
cmux Core `skills/cmux/SKILL.md`	Controla ventanas, workspaces, paneles, superficies, foco, movimientos, reordenamiento y enrutamiento con la cmux CLI. Úsala cuando un agente necesita ubicación o navegación determinista en un diseño de cmux con varios paneles.	`cmux identify --json`
cmux Browser `skills/cmux-browser/SKILL.md`	Automatiza superficies webview de cmux con referencias de snapshot, acciones DOM, esperas, capturas de pantalla y estado de sesión. Úsala para tareas de navegador que deben ejecutarse dentro de cmux en lugar de una herramienta separada de automatización del navegador.	`cmux browser surface:2 snapshot --interactive`
cmux Markdown Viewer `skills/cmux-markdown/SKILL.md`	Abre archivos Markdown en un panel de cmux formateado con recarga en vivo. Úsala para mostrar planes, documentación, notas y listas de tareas junto a la terminal mientras se trabaja.	`cmux markdown open plan.md`
cmux Debug Windows `skills/cmux-debug-windows/SKILL.md`	Administra Sidebar Debug, Background Debug, Menu Bar Extra Debug y snapshots de depuración copiables. Úsala al iterar en la interfaz de ventanas de depuración o al recopilar configuración de depuración desde un build etiquetado.	`skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh`
cmux Release `skills/release/SKILL.md`	Ejecuta el flujo de release de cmux desde la selección de versión hasta changelog, PR de release, etiqueta y verificaciones de artefactos. Úsala para maintainers que preparan o cortan un release de cmux.	`./scripts/bump-version.sh`

Menú Ayuda

El menú Help de macOS refleja esta barra lateral de documentación e incluye Skills. Usa el elemento Skills en Help para abrir esta página desde la app.

Estructura de habilidades

Mantén conciso el SKILL.md principal. Coloca tablas de comandos más detalladas, scripts y plantillas reutilizables junto a la habilidad.

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

Al agregar una habilidad nueva, incluye agents/openai.yaml para que el instalador exponga un nombre claro, una descripción breve y un prompt predeterminado.