Skills

cmux liefert Skills mit, die Coding-Agenten den Umgang mit cmux CLI-Steuerung, Browserflächen, Markdown-Panels, Debug-Fenstern und dem Release-Workflow beibringen.

Installieren

Führe skills.sh aus, um die eingecheckten Skills in dein Codex-Skills-Verzeichnis zu installieren.

Von GitHub installieren

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

Standardmäßig installiert das Skript nach ~/.codex/skills oder nach $CODEX_HOME/skills, wenn CODEX_HOME gesetzt ist. Übergib --dest, wenn dein Agent Skills aus einem anderen Verzeichnis liest.

Aus einem Checkout installieren

Aus einem geklonten cmux-Checkout nutzt das Skript das lokale Skills-Verzeichnis.

Lokale Befehle

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

Nutze --ref, um von einem bestimmten Branch, Tag oder Commit zu installieren, wenn das Skript von GitHub lädt.

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

Enthaltene Skills

Jeder Skill hat eine SKILL.md-Datei, optionale Referenzen und eine OpenAI-Metadatendatei unter agents/openai.yaml.

Skill	Einsatz	Typischer Befehl
cmux Core `skills/cmux/SKILL.md`	Steuert Fenster, Workspaces, Panes, Oberflächen, Fokus, Verschieben, Neuordnen und Routing über die cmux CLI. Nutze ihn, wenn ein Agent deterministische Platzierung oder Navigation in einem cmux-Layout mit mehreren Panes braucht.	`cmux identify --json`
cmux Browser `skills/cmux-browser/SKILL.md`	Automatisiert cmux-Webview-Flächen mit Snapshot-Referenzen, DOM-Aktionen, Wartebedingungen, Screenshots und Sitzungsstatus. Nutze ihn für Browseraufgaben, die innerhalb von cmux statt in einem separaten Browserautomatisierungstool laufen sollen.	`cmux browser surface:2 snapshot --interactive`
cmux Markdown Viewer `skills/cmux-markdown/SKILL.md`	Öffnet Markdown-Dateien in einem formatierten cmux-Panel mit Live-Reload. Nutze ihn, um Pläne, Dokumentation, Notizen und Aufgabenlisten während der Arbeit neben dem Terminal anzuzeigen.	`cmux markdown open plan.md`
cmux Debug Windows `skills/cmux-debug-windows/SKILL.md`	Verwaltet Sidebar Debug, Background Debug, Menu Bar Extra Debug und kopierbare Debug-Snapshots. Nutze ihn beim Iterieren an Debug-Fenster-UI oder beim Sammeln von Debug-Konfigurationen aus einem getaggten Build.	`skills/cmux-debug-windows/scripts/debug_windows_snapshot.sh`
cmux Release `skills/release/SKILL.md`	Führt den cmux-Release-Workflow von der Versionswahl über Changelog, Release-PR, Tag und Artefaktprüfungen aus. Nutze ihn für Maintainer, die ein cmux-Release vorbereiten oder schneiden.	`./scripts/bump-version.sh`

Hilfemenü

Das macOS-Menü Help spiegelt diese Dokumentationsseitenleiste und enthält Skills. Nutze den Skills-Eintrag in Help, um diese Seite aus der App zu öffnen.

Skill-Aufbau

Halte die Hauptdatei SKILL.md knapp. Lege ausführlichere Befehlstabellen, Skripte und wiederverwendbare Vorlagen neben den Skill.

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

Füge beim Hinzufügen eines neuen Skills agents/openai.yaml hinzu, damit der Installer einen klaren Namen, eine kurze Beschreibung und einen Standardprompt anzeigen kann.