Compétences

cmux fournit des compétences qui apprennent aux agents de code à utiliser le contrôle cmux CLI, les surfaces de navigateur, les panneaux Markdown, les fenêtres de débogage et le workflow de release.

Installer

Exécutez skills.sh pour installer les compétences versionnées dans votre répertoire de compétences Codex.

Installer depuis GitHub

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

Par défaut, le script installe dans ~/.codex/skills, ou dans $CODEX_HOME/skills lorsque CODEX_HOME est défini. Passez --dest si votre agent lit les compétences depuis un autre répertoire.

Installer depuis un checkout

Depuis un checkout cmux cloné, le script utilise le répertoire local des compétences.

Commandes locales

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

Utilisez --ref pour installer depuis une branche, une balise ou un commit précis lorsque le script télécharge depuis GitHub.

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

Compétences incluses

Chaque compétence possède un fichier SKILL.md, des références facultatives et un fichier de métadonnées OpenAI sous agents/openai.yaml.

Compétence	Usage	Commande typique
cmux Core `skills/cmux/SKILL.md`	Contrôle les fenêtres, espaces de travail, panneaux, surfaces, focus, déplacements, réordonnancement et routage avec la cmux CLI. Utilisez-la quand un agent a besoin d’un placement ou d’une navigation déterministe dans une disposition cmux à plusieurs panneaux.	`cmux identify --json`
cmux Browser `skills/cmux-browser/SKILL.md`	Automatise les surfaces webview de cmux avec des références de snapshot, des actions DOM, des attentes, des captures d’écran et l’état de session. Utilisez-la pour les tâches de navigateur qui doivent s’exécuter dans cmux plutôt que dans un outil d’automatisation de navigateur séparé.	`cmux browser surface:2 snapshot --interactive`
cmux Markdown Viewer `skills/cmux-markdown/SKILL.md`	Ouvre les fichiers Markdown dans un panneau cmux formaté avec rechargement en direct. Utilisez-la pour afficher plans, docs, notes et listes de tâches à côté du terminal pendant le travail.	`cmux markdown open plan.md`
cmux Debug Windows `skills/cmux-debug-windows/SKILL.md`	Gère Sidebar Debug, Background Debug, Menu Bar Extra Debug et les snapshots de débogage copiables. Utilisez-la lors des itérations sur l’interface des fenêtres de débogage ou pour collecter la configuration de débogage depuis un build tagué.	`skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh`
cmux Release `skills/release/SKILL.md`	Exécute le workflow de release cmux, du choix de version au changelog, à la PR de release, au tag et aux vérifications d’artefacts. Utilisez-la pour les maintainers qui préparent ou publient une release cmux.	`./scripts/bump-version.sh`

Menu Aide

Le menu macOS Help reflète cette barre latérale de documentation et inclut Skills. Utilisez l’élément Skills dans Help pour ouvrir cette page depuis l’app.

Structure d’une compétence

Gardez le fichier SKILL.md principal concis. Placez les tables de commandes plus détaillées, scripts et modèles réutilisables à côté de la compétence.

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

Quand vous ajoutez une nouvelle compétence, incluez agents/openai.yaml afin que l’installateur expose un nom clair, une courte description et un prompt par défaut.