Onlyswitch Deeplink

When to use this skill

Use Onlyswitch Deeplink when an AI agent needs a reusable SKILL.md workflow for this job: 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.

When not to use it

Skip Onlyswitch Deeplink when the task is outside the productivity category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.

How to install

1. Personal install: create ~/.claude/skills/onlyswitch-deeplink/SKILL.md (and any bundled scripts) so Claude Code, Claude Desktop, and compatible agents can load it in every project.
2. Project install: commit the same folder at .claude/skills/onlyswitch-deeplink/ so teammates get the skill with the repo.
3. Restart the agent session after copying files so it re-scans the skills directory, then ask for the task in words that match the skill description.

Full install guide for Claude, Cursor, and Codex

What this skill does

# OnlySwitch Deeplink

Invoke OnlySwitch built-in switches or one-shot buttons by opening its deeplink. OnlySwitch must be installed and allowed to handle the `onlyswitch://` URL scheme.

## Workflow

1. **Resolve intent to switch id** Map the user's request to a single built-in switch/button using [references/switch-ids.md](references/switch-ids.md). Match phrases like "empty trash", "toggle keep awake", "mute mic", "clear xcode cache" to the correct **id** (e.g. empty trash → 16384, keep awake → 16).

2. **Open the deeplink** Run on the user's machine (macOS):

```bash open "onlyswitch://run?type=builtIn&id=<id>" ```

Replace `<id>` with the numeric id from the reference table. Example for "empty trash":

```bash open "onlyswitch://run?type=builtIn&id=16384" ```

3. **Confirm** Tell the user which action was triggered (e.g. "Emptied trash via OnlySwitch" or "Toggled Keep Awake via OnlySwitch").

## Notes

- One deeplink per request: resolve to exactly one switch id per user message. - If the request doesn't match any built-in (e.g. custom switch or unknown action), say that OnlySwitch deeplinks only support the built-in list and suggest checking the app or docs. - IDs are raw enum values from `SwitchType` in the OnlySwitch app (see project's `SwitchType.swift` for the source of truth; this skill's reference table is derived from it).

Intended uses

• Resolve intent to switch id
• Open the deeplink
• Confirm