Content
87%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A lean, highly actionable skill: a clear three-step workflow, copy-paste-ready deeplink command with a worked example, and an excellent alias-mapped id table properly isolated in a single one-level-deep reference. The one real gap is safety: several switches it can trigger are irreversible (empty trash, clear pasteboard, eject discs, Xcode derived data) yet the workflow fires immediately with no pre-execution validation or confirmation step, capping workflow clarity.
Suggestions
Add a validation checkpoint before triggering irreversible switches (empty trash, empty pasteboard, eject discs, Xcode derived data): e.g., briefly confirm with the user or state the irreversible effect before opening the deeplink for those ids.
Add error-handling guidance for a failed or silent `open` (OnlySwitch not installed or the onlyswitch:// scheme not registered), so Claude knows how to detect and report it instead of assuming success.
Clarify what to do when a single user message maps to multiple switch ids (the 'one deeplink per request' note forbids batch firing but doesn't say whether to ask the user which one, or run them sequentially across turns).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~36-line body explains only what Claude doesn't already know (the deeplink scheme, the prerequisite "OnlySwitch must be installed and allowed to handle the onlyswitch:// URL scheme", the one-deeplink-per-request rule) and moves the 40-row id table out of the body. No filler or concept explanations; matches anchor 5 ("every token earns its place"). | 5 / 5 |
Actionability | The command `open "onlyswitch://run?type=builtIn&id=<id>"` is fully executable, reinforced with a copy-paste-ready concrete example (`id=16384` for empty trash) and a real reference table (references/switch-ids.md) mapping user phrases to ids with alias columns. Matches anchor 5 (copy-paste ready, specific examples cover the common cases). | 5 / 5 |
Workflow Clarity | The sequence (resolve intent to id -> open the deeplink -> confirm to the user) is clear and the no-match fallback is stated, but there is no validation checkpoint before firing destructive switches — the skill's flagship examples include "empty trash", "clear clipboard", "eject discs", and Xcode derived data cleanup, which are irreversible. The rubric's judging guideline caps destructive/batch workflows without validation at 3, taking precedence over the simple-skill exception; the "Confirm" step only reports after the fact rather than validating before execution, so this is anchor 3 (steps present but checkpoints missing), not 4. | 3 / 5 |
Progressive Disclosure | The body is a clear overview with a well-signaled, verified, one-level-deep reference ([references/switch-ids.md](references/switch-ids.md)), and the bulky id table is appropriately split into that file rather than inlined; switch-ids.md itself references no further files. Matches anchor 5 (clear overview, well-signaled one-level-deep references, easy navigation). | 5 / 5 |
Total | 18 / 20 Passed |