CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

onlyswitch-deeplink

Invoke OnlySwitch built-in switches or buttons via deeplink. Use when the user asks to toggle or trigger an OnlySwitch action (e.g. empty trash, keep awake, dark mode, mute, hide desktop, clear clipboard, eject discs, Xcode derived data, and any other built-in switch or button). Resolve the request to the correct switch id and open the onlyswitch deeplink.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

87%Weight 40%Scale 1-5

Reviews 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).

DimensionReasoningScore

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

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it answers both what (resolve intent to a switch id and open the onlyswitch:// deeplink) and when (explicit 'Use when' with concrete trigger phrases), in third person, with natural keywords and comprehensive domain coverage. The only weakness is minor overlap risk from generic action phrases that could fire when the user means plain system actions rather than OnlySwitch.

DimensionReasoningScore

Specificity

"Resolve the request to the correct switch id and open the onlyswitch deeplink" plus "Invoke OnlySwitch built-in switches or buttons via deeplink" list multiple concrete actions, and the enumeration ("empty trash, keep awake, dark mode, mute, hide desktop, clear clipboard, eject discs, Xcode derived data, and any other built-in switch or button") gives comprehensive coverage of the domain. This matches the anchor-5 example's comprehensiveness; anchor 4 would require a coverage gap, and none exists given the explicit catch-all.

5 / 5

Completeness

The 'what' is explicit ("Invoke OnlySwitch built-in switches or buttons via deeplink... open the onlyswitch deeplink") and the 'when' is an explicit "Use when the user asks to toggle or trigger an OnlySwitch action (e.g. empty trash, keep awake, ...)" with concrete trigger phrases. This mirrors the anchor-5 exemplar structure; anchor 4's weaker/implicit 'when' does not apply.

5 / 5

Trigger Term Quality

Natural user phrases like "empty trash", "keep awake", "dark mode", "mute", "hide desktop", "clear clipboard", "eject discs" are exactly what a user would say, and synonym pairs ("toggle or trigger", "switches or buttons") add variation. Anchor 4 would require missing natural terms; the "e.g." framing plus "any other built-in switch or button" makes the coverage comprehensive for this domain (no file extensions exist here to include).

5 / 5

Distinctiveness Conflict Risk

The niche is clear (OnlySwitch, a specific macOS app, with the trigger scoped to "an OnlySwitch action"), but the example phrases "mute", "empty trash", "dark mode", "hide desktop" are generic system actions that could also match other macOS-automation or system-control skills if the user has no OnlySwitch intent. This fits anchor 4 ("minor overlap risk with closely related skills") better than anchor 5, since anchor 5 demands minimal conflict risk from distinct triggers.

4 / 5

Total

19

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

jacklandrin/OnlySwitch

Path

OpenClaw/skills/onlyswitch-deeplink/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.