catalan-adobe/cmux-setup
BEFORE manually calling cmux set-status or writing chpwd hooks for workspace coloring, use this skill. Manages workspace color rules that auto-apply based on directory patterns. Handles config creation, zsh hook installation, rule management, and on-demand workspace coloring via cmux set-status. Triggers on "cmux setup", "workspace colors", "color this workspace", "add color rule", "project colors", or any request to visually differentiate cmux workspaces.
97
97%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a well-crafted skill description that excels across all dimensions. It provides specific capabilities, includes natural trigger terms users would say, explicitly states both what the skill does and when to use it, and occupies a clear niche that won't conflict with other skills. The 'BEFORE manually calling...' prefix adds helpful context for skill selection priority.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Manages workspace color rules', 'Handles config creation, zsh hook installation, rule management, and on-demand workspace coloring via cmux set-status'. These are clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what (manages workspace color rules, handles config creation, zsh hook installation, rule management) AND when (explicit 'Triggers on...' clause with multiple trigger phrases, plus 'BEFORE manually calling cmux set-status' guidance). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: 'cmux setup', 'workspace colors', 'color this workspace', 'add color rule', 'project colors', 'visually differentiate cmux workspaces'. These match what users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific niche: cmux workspace coloring. The combination of 'cmux', 'workspace colors', 'zsh hook', and 'directory patterns' creates a clear, unique domain unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent actionability and workflow clarity. The two-mode approach (persistent vs on-demand) is clearly distinguished, and the command reference is comprehensive. Minor improvement could come from moving installation/script-location boilerplate to a separate file to keep the main skill focused on usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is lean and efficient, assuming Claude's competence with Node.js, bash, and JSON. No unnecessary explanations of basic concepts; every section serves a clear purpose. | 3 / 3 |
Actionability | Provides fully executable bash commands, complete JSON config examples, and copy-paste ready code blocks. The command reference table and mode-specific workflows give concrete, actionable guidance. | 3 / 3 |
Workflow Clarity | Mode 1 (Persistent Setup) has clear numbered steps with explicit sequence. Mode 2 distinguishes between config-based and ad-hoc approaches. The conversational request table maps user intents to specific actions clearly. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but the script location logic and installation instructions add bulk that could be in a separate INSTALL.md. The skill references external scripts but doesn't link to detailed documentation for advanced usage. | 2 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
Reviewed
Table of Contents